Freigeben über


Get-AzureRmADGroup

Filtert Active Directory-Gruppen.

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-AzureRmADGroup
   [-ObjectId <Guid>]
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADGroup
   -DisplayNameStartsWith <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADGroup
   -DisplayName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADGroup
   -ObjectId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]

Beschreibung

Filtert Active Directory-Gruppen.

Beispiele

Beispiel 1 : Alle AD-Gruppen auflisten

PS C:\> Get-AzureRmADGroup

Listet alle AD-Gruppen in einem Mandanten auf.

Beispiel 2: Auflisten aller AD-Gruppen mithilfe von Paging

PS C:\> Get-AzureRmADGroup -First 100

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

Beispiel 3 : Abrufen einer AD-Gruppe nach Objekt-ID

PS C:\> Get-AzureRmADGroup -ObjectId 85F89C90-780E-4AA6-9F4F-6F268D322EEE

Ruft eine AD-Gruppe mit objekt-ID '85F89C90-780E-4AA6-9F4F-6F268D322EEEEE' ab.

Beispiel 4 : Auflisten von Gruppen nach Suchzeichenfolge

PS C:\> Get-AzureRmADGroup -SearchString Joe

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

Parameter

-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 der Gruppe.

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

-DisplayNameStartsWith

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

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 der Gruppe.

Typ:Guid
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

Ausgaben

PSADGroup