Get-ServicePrincipal

  • 参考
模块:
ExchangePowerShell
适用于:
Exchange Online, Security & Compliance, Exchange Online Protection

此 cmdlet 仅在基于云的服务中可用。

使用 Get-ServicePrincipal cmdlet 查看有关基于云的组织中的服务主体的信息。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

Get-ServicePrincipal
   [[-Identity] <ServicePrincipalIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [<CommonParameters>]

说明

Azure Active Directory 中存在服务主体，用于定义应用可以执行哪些操作、谁可以访问应用以及应用可以访问哪些资源。 在Exchange Online中，服务主体是对 Azure AD 中服务主体的引用。 若要将Exchange Online基于角色的访问控制 (RBAC) 角色分配给 Azure AD 中的服务主体，请使用 Exchange Online 中的服务主体引用。 Exchange Online PowerShell 中的 *-ServicePrincipal cmdlet 允许查看、创建和删除这些服务主体引用。

有关详细信息，请参阅 Azure Active Directory 中的应用程序和服务主体对象。

您必须先获得权限，然后才能运行此 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

此示例返回有关 ServiceId 值为 ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1 的服务主体的详细信息。

参数

-Identity

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

  • 名称
  • 可分辨名称 (DN)
  • GUID
  • AppId
  • ServiceId
Type:ServicePrincipalIdParameter
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protectionn

-Organization

保留此参数以供 Microsoft 内部使用。

Type:OrganizationIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection