Get-MsolServicePrincipal
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 von Dienstprinzipalen 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 über einen Dienstprinzipalnamen verfügen, der mit MyApp beginnt. Dies ist eine genaue Übereinstimmung mit dem appClass-Teil 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 .
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-AppPrincipalId
Gibt die eindeutige Anwendungs-ID des abzurufenden Dienstprinzipals an.
Typ: | Guid |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-MaxResults
Gibt die maximale Anzahl von Ergebnissen an, die von diesem Cmdlet zurückgegeben werden. Der Standardwert ist 500.
Typ: | Int32 |
Position: | Named |
Standardwert: | 500 |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ObjectId
Gibt die eindeutige Objekt-ID des abzurufenden Dienstprinzipals an.
Typ: | Guid |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-SearchString
Gibt eine Zeichenfolge an, die dienstprinzipalnamen entspricht.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | 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 hostname die URI-Autorität für die Anwendung dar.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | 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.
Typ: | Guid |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Ausgaben
Microsoft.Online.Administration.ServicePrincipal[]
Dieses Cmdlet gibt einen Dienstprinzipal oder eine Liste von Dienstprinzipalen 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.