通过

Get-ServicePrincipal

模块:
Exchange PowerShell

此 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、安全 & 合规性、Exchange Online Protection

Identity 参数指定要查看的服务主体。 可以使用任何唯一标识服务主体的值。 例如：

  • 名称
  • 可分辨名称 (DN)
  • GUID
  • AppId
  • ObjectId

参数属性

类型:ServicePrincipalIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:0
必需:False
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-Organization

适用：Exchange Online、安全 & 合规性、Exchange Online Protection

保留此参数以供 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。