Freigeben über


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