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 |