Get-ServicePrincipal

此指令程式只能在雲端式服務中使用。

使用 Get-ServicePrincipal Cmdlet 來檢視雲端式組織中服務主體的相關資訊。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

Syntax

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

Description

服務主體存在於 Azure Active Directory 中,以定義應用程式可以執行的動作、誰可以存取應用程式,以及應用程式可以存取哪些資源。 在Exchange Online中,服務主體是 Azure AD 中服務主體的參考。 若要將Exchange Online角色型存取控制 (RBAC) 角色指派給 Azure AD 中的服務主體,您可以在 Exchange Online 中使用服務主體參考。 Exchange Online PowerShell 中的*-ServicePrincipal Cmdlet 可讓您檢視、建立和移除這些服務主體參考。

如需詳細資訊,請參閱 Azure Active Directory 中的應用程式和服務主體物件

您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 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