Share via


Get-AzureRmADUser

Filtert Active Directory-Benutzer.

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-AzureRmADUser
   [-UserPrincipalName <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADUser
   -StartsWith <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADUser
   -DisplayName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADUser
   -ObjectId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADUser
   -UserPrincipalName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADUser
   -Mail <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]

Beschreibung

Filtert Active Directory-Benutzer.

Beispiele

Beispiel 1 : Alle Benutzer auflisten

PS C:\> Get-AzureRmADUser

Listet alle AD-Benutzer in einem Mandanten auf.

Beispiel 2: Auflisten aller Benutzer mithilfe von Paging

PS C:\> Get-AzureRmADUser -First 100

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

Beispiel 3: Abrufen eines AD-Benutzers nach Benutzerprinzipalname

PS C:\> Get-AzureRmADUser -UserPrincipalName foo@domain.com

Ruft den AD-Benutzer mit dem Benutzerprinzipalnamen "foo@domain.com" ab.

Beispiel 4 – Nach Suchzeichenfolge auflisten

PS C:\> Get-AzureRmADUser -SearchString Joe

Listet alle AD-Benutzer auf, deren Anzeigename mit "Joe" beginnt.

Parameter

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Der Anzeigename des Benutzers.

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

-First

Die maximale Anzahl der zurückzugebenden Objekte.

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

-IncludeTotalCount

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

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

-Mail

Die Benutzer-E-Mail.

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

-ObjectId

Objekt-ID des Benutzers.

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

-Skip

Ignoriert die ersten N-Objekte und ruft dann die objekte neu Standard ab.

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

-StartsWith

Wird verwendet, um Benutzer zu finden, die mit der angegebenen Zeichenfolge beginnen.

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

-UserPrincipalName

UPN des Benutzers.

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

Eingaben

String

Guid

Ausgaben

PSADUser