Get-ServicePrincipal
Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.
Verwenden Sie das Cmdlet Get-ServicePrincipal, um Informationen zu Dienstprinzipalen in Ihrer cloudbasierten Organisation anzuzeigen.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Get-ServicePrincipal
[[-Identity] <ServicePrincipalIdParameter>]
[-Organization <OrganizationIdParameter>]
[<CommonParameters>]
Beschreibung
Dienstprinzipale sind in Azure Active Directory vorhanden, um zu definieren, was Apps tun können, wer auf die Apps zugreifen kann und auf welche Ressourcen die Apps zugreifen können. In Exchange Online sind Dienstprinzipale Verweise auf die Dienstprinzipale in Azure AD. Zum Zuweisen Exchange Online Rollen der rollenbasierten Zugriffssteuerung (Role-Based Access Control, RBAC) zu Dienstprinzipalen in Azure AD verwenden Sie die Dienstprinzipalverweise in Exchange Online. Mit den *-ServicePrincipal-Cmdlets in Exchange Online PowerShell können Sie diese Dienstprinzipalverweise anzeigen, erstellen und entfernen.
Weitere Informationen finden Sie unter Anwendungs- und Dienstprinzipalobjekte in Azure Active Directory.
Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.
Beispiele
Beispiel 1
Get-ServicePrincipal
In diesem Beispiel wird eine Zusammenfassungsliste aller Dienstprinzipale zurückgegeben.
Beispiel 2
Get-ServicePrincipal -Identity ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1 | Format-List
In diesem Beispiel werden ausführliche Informationen zum Dienstprinzipal mit dem ServiceId-Wert ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1 zurückgegeben.
Parameter
-Identity
Der Parameter Identity gibt den Dienstprinzipal an, den Sie anzeigen möchten. Sie können einen beliebigen Wert verwenden, der den Dienstprinzipal eindeutig identifiziert. Zum Beispiel:
- Name
- Distinguished Name (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
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
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 |