Freigeben über

Get-AzureRmADServicePrincipal

  • Referenz
Modul:
AzureRM.Resources

Filtert Active Directory-Dienstprinzipale.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

Get-AzureRmADServicePrincipal
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -DisplayNameBeginsWith <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -DisplayName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ObjectId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ApplicationId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ApplicationObject <PSADApplication>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADServicePrincipal
   -ServicePrincipalName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]

Beschreibung

Filtert Active Directory-Dienstprinzipale.

Beispiele

Beispiel 1 : Ad-Dienstprinzipale auflisten

PS C:\> Get-AzureRmADServicePrincipal

Listet alle AD-Dienstprinzipale in einem Mandanten auf.

Beispiel 2 : Ad-Dienstprinzipale mithilfe von Paging auflisten

PS C:\> Get-AzureRmADServicePrincipal -First 100

Listet die ersten 100 AD-Dienstprinzipale in einem Mandanten auf.

Beispiel 3 : Dienstprinzipale von SPN auflisten

PS C:\> Get-AzureRmADServicePrincipal -ServicePrincipalName 36f81fc3-b00f-48cd-8218-3879f51ff39f

Listet Dienstprinzipale mit dem SPN '36f81fc3-b00f-48cd-8218-3879f51ff39f' auf.

Beispiel 4 – Dienstprinzipale nach Suchzeichenfolge auflisten

PS C:\> Get-AzureRmADServicePrincipal -SearchString "Web"

Listet alle AD-Dienstprinzipale auf, deren Anzeigename mit "Web" beginnt.

Beispiel 5 – Dienstprinzipale durch Rohrleitung auflisten

PS C:\> Get-AzureRmADApplication -ObjectId 39e64ec6-569b-4030-8e1c-c3c519a05d69 | Get-AzureRmADServicePrincipal

Ruft die AD-Anwendung mit der Objekt-ID "39e64ec6-569b-4030-8e1c-c3c519a05d69" ab und gibt sie an das Cmdlet "Get-AzureRmADServicePrincipal" weiter, um alle Dienstprinzipale für diese Anwendung aufzulisten.

Parameter

-ApplicationId

Die Dienstprinzipalanwendungs-ID.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ApplicationObject

Das Anwendungsobjekt, dessen Dienstprinzipal abgerufen wird.

Typ:PSADApplication
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisplayName

Der Anzeigename des Dienstprinzipals.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DisplayNameBeginsWith

Die Suchzeichenfolge des Dienstprinzipals.

Typ:String
Aliase:SearchString
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-First

Die maximale Anzahl der zurückzugebenden Objekte.

Typ:UInt64
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IncludeTotalCount

Meldet die Anzahl der Objekte im Dataset. Derzeit führt dieser Parameter nichts aus.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ObjectId

Objekt-ID des Dienstprinzipals.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ServicePrincipalName

SPN des Diensts.

Typ:String
Aliase:SPN
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Skip

Ignoriert die ersten N-Objekte und ruft dann die verbleibenden Objekte ab.

Typ:UInt64
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

Guid

PSADApplication

Parameter: ApplicationObject (ByValue)

Ausgaben

PSADServicePrincipal