Get-MsolServicePrincipal

  • Referenz
Modul:
MSOnline

Ruft Dienstprinzipale aus Azure Active Directory ab.

Syntax

Get-MsolServicePrincipal
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -AppPrincipalId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ServicePrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-MsolServicePrincipal ruft einen Dienstprinzipal oder eine Liste der Dienstprinzipale aus Azure Active Directory ab.

Beispiele

Beispiel 1: Anzeigen aller Dienstprinzipale

PS C:\> Get-MsolServicePrincipal

Dieser Befehl zeigt alle vorhandenen Dienstprinzipale im Mandanten der Organisation an.

Beispiel 2: Abrufen von Dienstprinzipalen mithilfe eines Namens

PS C:\> Get-MsolServicePrincipal -ServicePrincipalName "MyApp"

Dieser Befehl ruft alle vorhandenen Dienstprinzipale ab, die einen Dienstprinzipalnamen haben, der mit MyApp beginnt. Dies ist eine genaue Übereinstimmung des AppClass-Teils des Dienstprinzipalsnamens bis zum Schrägstrich.

Beispiel 3: Abrufen eines Dienstprinzipals

PS C:\> Get-MsolServicePrincipal -AppPrincipalId 5e964d2f-e384-4292-ae55-dd24c89cc53b

Dieser Befehl ruft einen Dienstprinzipal ab, der über eine bestimmte Anwendungsprinzipal-ID verfügt.

Parameter

-All

Gibt an, dass dieses Cmdlet alle Ergebnisse zurückgibt. Geben Sie nicht zusammen mit dem MaxResults-Parameter an.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AppPrincipalId

Gibt die eindeutige Anwendungs-ID des abzurufenden Dienstprinzipals an.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaxResults

Gibt die maximale Anzahl von Ergebnissen an, die dieses Cmdlet zurückgibt. Der Standardwert ist 500.

Type:Int32
Position:Named
Default value:500
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

Gibt die eindeutige Objekt-ID des abzurufenden Dienstprinzipals an.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SearchString

Gibt eine Zeichenfolge an, die den Dienstprinzipalnamen entspricht.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ServicePrincipalName

Gibt den Namen des abzurufenden Dienstprinzipals oder Dienstprinzipals an. Ein SPN muss eines der folgenden Formate verwenden:

  • appName
  • appName/hostname
  • eine gültige URL

AppName stellt den Namen der Anwendung und des Hostnamens dar, der die URI-Autorität für die Anwendung darstellt.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TenantId

Gibt die eindeutige ID des Mandanten an, auf dem der Vorgang ausgeführt werden soll. Der Standardwert ist der Mandant des aktuellen Benutzers. Dieser Parameter gilt nur für Partnerbenutzer.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Ausgaben

Microsoft.Online.Administration.ServicePrincipal[]

Dieses Cmdlet gibt einen Dienstprinzipal oder eine Liste der Dienstprinzipale aus Azure Active Directory zurück. Jedes Dienstprinzipal enthält die folgenden Informationen:

  • Objectid. Der eindeutige Bezeichner des Dienstprinzipals.
  • AppPrincipalId. Der Anwendungsbezeichner des Dienstprinzipals.
  • Displayname. Der Anzeigename des Dienstprinzipals.
  • Serviceprincipalname. Die Liste der Dienstprinzipalnamen (SPNs), die dem Dienstprinzipal zugeordnet sind.
  • AccountEnabled. Der Wert, der angibt, ob das Konto aktiviert ist.