标识
适用于: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 参数通常还包含其他参数的值,或单个对象上来自多个参数的值集的组合。 这些值还可以保证在对象集中的唯一性。 可以指定这些其他参数(例如 Name 和 DistriguishedName)的值,也可以由系统生成。 使用的其他参数(如果有)以及如何设置这些参数取决于您引用的对象。
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 查询您感兴趣的信息。
有关管理角色的详细信息,请参阅了解管理角色。