Get-ServicePrincipal
此 cmdlet 仅在基于云的服务中可用。
使用 Get-ServicePrincipal cmdlet 查看有关基于云的组织中的服务主体的信息。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Default (默认值)
Get-ServicePrincipal
[[-Identity] <ServicePrincipalIdParameter>]
[-Organization <OrganizationIdParameter>]
[<CommonParameters>]
说明
服务主体存在于 Microsoft Entra ID 中，用于定义应用可以执行的操作、谁可以访问应用以及应用可以访问的资源。 在 Exchange Online 中，服务主体是对 Microsoft Entra ID 中的服务主体的引用。 若要将Exchange Online基于角色的访问控制 (RBAC) 角色分配给 Microsoft Entra ID 中的服务主体，请在 Exchange Online 中使用服务主体引用。 使用 Exchange Online PowerShell 中的 *-ServicePrincipal cmdlet，可以查看、创建和删除这些服务主体引用。
有关详细信息，请参阅 Microsoft Entra ID 中的应用程序和服务主体对象。
您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果分配给你的权限中未包含某些参数，则可能无权访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Get-ServicePrincipal
此示例返回组织内所有服务主体的摘要列表。
示例 2
Get-ServicePrincipal -Identity ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1 | Format-List
此示例返回有关 ObjectId 值为 ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1 的服务主体的详细信息。
参数
-Identity
适用：Exchange Online、安全 & 合规性、本地邮箱的内置安全加载项
标识参数指定要查看的服务主体。 可以使用唯一标识服务主体的任何值。 例如：
- 名称
- 可分辨名称 (DN)
- GUID
- AppId
- ObjectId
注意： Identity 参数的值$null或不存在值将返回 所有 对象，就像您在没有 Identity 参数的情况下运行 Get- 命令一样。 验证 Identity 参数的任何值列表是否准确，且不包含不存在的$null值。
参数属性
| 类型: | ServicePrincipalIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Organization
适用：Exchange Online、安全 & 合规性、本地邮箱的内置安全加载项
保留此参数以供 Microsoft 内部使用。
参数属性
| 类型: | OrganizationIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持以下常用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。