Get-UserPrincipalNamesSuffix
此 cmdlet 仅适用于本地 Exchange。
使用 Get-UserPrincipalNamesSuffix cmdlet 可以查看 Active Directory 林中的用户主体名称 (UPN) 后缀。 UPN 后缀在 Active Directory 域和信任中创建。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Get-UserPrincipalNamesSuffix
[-OrganizationalUnit <ExtendedOrganizationalUnitIdParameter>]
[<CommonParameters>] 说明
分配给组织单位的 UPN 后缀存储在 Organizational Unit 对象的 upnSuffixes 属性中。
默认的 UPN 包含在配置命名上下文中 Partitions container 对象的 Canonical Name 属性中。 默认 UPN 后缀可标识包含用户帐户的域。 在 Active Directory 中创建用户帐户时，默认 UPN 后缀是域树中第一个域的 DNS 名称。
如果使用 Active Directory 用户和计算机 创建用户帐户，则每个用户都必须具有 UPN。
您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Get-UserPrincipalNamesSuffix此示例返回 Active Directory 林的所有 UPN 后缀。
参数
-OrganizationalUnit
OrganizationUnit 参数根据对象在 Active Directory 中的位置筛选结果。 只返回存在于指定位置的对象。 此参数的有效输入是由 Get-OrganizationalUnit cmdlet 返回的组织单位 (OU) 或域。 可以使用任何能够唯一标识此 OU 或域的值。 例如：
- 名称
- 名称
- 可分辨名称 (DN)
- GUID
| Type: | ExtendedOrganizationalUnitIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。