Get-AzureRmADServicePrincipal
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 weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. 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 |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ApplicationObject
Das Anwendungsobjekt, dessen Dienstprinzipal abgerufen wird.
Typ: | PSADApplication |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Typ: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Der Anzeigename des Dienstprinzipals.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisplayNameBeginsWith
Die Suchzeichenfolge des Dienstprinzipals.
Typ: | String |
Aliases: | SearchString |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-First
Die maximale Anzahl der zurückzugebenden Objekte.
Typ: | UInt64 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeTotalCount
Meldet die Anzahl der Objekte im Dataset. Derzeit führt dieser Parameter nichts aus.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ObjectId
Objekt-ID des Dienstprinzipals.
Typ: | Guid |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServicePrincipalName
SPN des Diensts.
Typ: | String |
Aliases: | SPN |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Skip
Ignoriert die ersten N-Objekte und ruft dann die objekte neu Standard ab.
Typ: | UInt64 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Parameter: ApplicationObject (ByValue)