标识

适用于:Exchange Server 2013

Identity 参数是可用于大多数 cmdlet 的特殊参数。 使用 Identity 参数可以访问引用 Microsoft Exchange Server 2013 中特定对象的唯一标识符。 此功能允许您针对特定的 Exchange 2013 对象执行操作。

以下各节介绍 Identity 参数并提供如何有效使用此参数的示例:

Characteristics of the Identity parameter

Wildcard characters in Identity

Examples of the Identity parameter

Identity 参数的特征

Exchange 2013 中对象的主要唯一标识符始终是 GUID。 GUID 是 128 位标识符,例如 63d64005-42c5-4f8f-b310-14f6cb125bf3。 此 GUID 永远不会重复,因此始终是唯一的。 但是,您不希望经常键入此类 GUID。 因此, Identity 参数通常还包含其他参数的值,或单个对象上来自多个参数的值集的组合。 这些值还可以保证在对象集中的唯一性。 可以指定这些其他参数(例如 NameDistriguishedName)的值,也可以由系统生成。 使用的其他参数(如果有)以及如何设置这些参数取决于您引用的对象。

Identity 参数也被视为位置参数。 如果未指定参数标签,则假定 cmdlet 上的第一个参数是 Identity 参数。 这样可以减少键入命令时的按键次数。 有关位置参数的详细信息,请参阅 Parameters

以下示例演示如何通过使用接收连接器的唯一 Name 参数值来使用 Identity 参数。 此示例还演示了如何省略 Identity 参数名称,因为 Identity 是一个位置参数。

Get-ReceiveConnector -Identity "From the Internet"
Get-ReceiveConnector "From the Internet"

与 Exchange 2013 中的所有对象一样,也可以使用此接收连接器的唯一 GUID 来引用它。 例如,如果还为名为 "From the Internet" 的接收连接器分配了 GUID 63d64005-42c5-4f8f-b310-14f6cb125bf3,则还可以使用以下命令检索接收连接器:

Get-ReceiveConnector 63d64005-42c5-4f8f-b310-14f6cb125bf3

Identity 中的通配符

某些 Get cmdlet 可以在运行 cmdlet 时接受通配符 (*) 作为提交到 Identity 的值的一部分。 通过将通配符与 Identity 参数结合使用,可以指定部分名称并检索与该部分名称匹配的对象列表。 可以将通配符放在 Identity 值的开头或末尾,但不能将字符放在字符串的中间。 例如,命令 Get-Mailbox David*Get-Mailbox _anders* 有效,但 Get-Mailbox Reb*ca 不是有效的命令。

某些 Get cmdlet 检索 Exchange 2013 中以分层或父级和子级关系组织的对象。 也就是说,可能存在一个父对象集合,这些父对象还包含各自的子对象。 具有父级和子关系的对象可能具有语法的 <parent>\<child>Identity

Identity 参数的语法 <parent>\<child>为 时,某些 cmdlet 允许使用通配符 (*) 替换所有或部分父名称或子名称。 例如,如果要在所有父对象中查找名为“Contoso”的所有子对象,可以使用 语法 "*\Contoso"。 同样,如果要查找父对象下 "ServerA" 部分名称为“Auth”的所有子对象,则可以使用 语法 "ServerA\Auth*"

某些(但并非全部)cmdlet 允许您在运行命令时仅指定 Identity 参数的子部分。 当您这样做时,这些 cmdlet 将默认为所访问的当前父对象。 例如,MBX1 和 MBX2 上都存在名为"Contoso Receive Connector"的接收连接器。 如果在 MBX2 上运行命令 Get-ReceiveConnector "Contoso Receive Connector" ,则仅返回服务器 MBX2 上的接收连接器。

Identity 参数和通配符的特定行为取决于所运行的 cmdlet。 有关您要运行的 cmdlet 的详细信息,请参阅该 cmdlet 的特定于功能的内容。

Identity 参数示例

本主题中所述的示例演示 了 Identity 参数如何接受不同的唯一值来引用 Exchange 2013 组织中的特定对象。 这些示例还说明如何省略 Identity 参数标签,以减少键入命令时的按键次数。

DSN 邮件

本节中的示例引用可以在 Exchange 2013 组织中配置的发送状态通知 (DSN) 邮件。 第一个示例说明如何使用 Get-SystemMessage cmdlet 来检索 DSN 5.4.1。 在 Get-SystemMessage cmdlet 中, Identity 参数包含在每个 DSN 消息对象上配置的多个数据片段。 这些数据片段包括 DSN 的编写语言、DSN 在作用域的内部还是外部,以及以下示例中所示的 DSN 邮件代码:

Get-SystemMessage en\internal\5.4.1

也可以按以下示例中所示,使用 GUID 来检索此 DSN 邮件,因为 Exchange 2013 中的所有对象都具有一个 GUID:

Get-SystemMessage 82ca7bde-1c2d-4aa1-97e1-f298a6f10222

有关与 SystemMessage cmdlet 一起使用时标识参数的构成的详细信息,请参阅 DSN 消息标识

管理角色条目

本节中的示例引用了构成 Exchange 2013 中管理角色的管理角色条目。 管理角色用于控制授予给管理员和最终用户的权限。 管理角色项由以下两部分组成:相关联的管理角色和一个 cmdlet。 Identity 参数同样由管理角色名称和 cmdlet 名称组成。 例如,以下是角色上的 Set-Mailbox cmdlet 的角色 Mail Recipients 条目:

Mail Recipients\Set-Mailbox

角色 Mail Recipients\Set-Mailbox 条目是角色上的多个条目之 Mail Recipients 一。 若要查看角色上的所有角色条目 Mail Recipients ,可以使用以下命令:

Get-ManagementRoleEntry "Mail Recipients\*"

若要查看包含字符串“”Mailbox的角色上Mail Recipients的所有角色条目,请使用以下命令:

Get-ManagementRoleEntry "Mail Recipients\*Mailbox*"

若要查看其中一个角色项为 Set-Mailbox 的所有管理角色,可以使用以下命令:

Get-ManagementRoleEntry *\Set-Mailbox

借助角色项,可以按多种方式使用通配符在 Exchange 2013 查询您感兴趣的信息。

有关管理角色的详细信息,请参阅了解管理角色