Get-AzureRmADGroup

Riferimento

Modulo:: AzureRM.Resources

Filtra i gruppi di Active Directory.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

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>]

Descrizione

Filtra i gruppi di Active Directory.

Esempio

Esempio 1 - Elencare tutti i gruppi di Active Directory

PS C:\> Get-AzureRmADGroup

Elenca tutti i gruppi di Active Directory in un tenant.

Esempio 2- Elencare tutti i gruppi di Active Directory usando il paging

PS C:\> Get-AzureRmADGroup -First 100

Elenca i primi 100 gruppi di Active Directory in un tenant.

Esempio 3 - Ottenere un gruppo di Active Directory in base all'ID oggetto

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

Ottiene un gruppo di Active Directory con ID oggetto '85F89C90-780E-4AA6-9F4F-6F268D322 edizione Enterprise E'.

Esempio 4 - Elencare i gruppi in base alla stringa di ricerca

PS C:\> Get-AzureRmADGroup -SearchString Joe

Elenca tutti i gruppi di Active Directory il cui nome visualizzato inizia con 'Joe'.

Parametri

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

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

-DisplayName

Il nome visualizzato del gruppo.

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

-DisplayNameStartsWith

Usato per trovare i gruppi che iniziano con la stringa specificata.

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

-First

Numero massimo di oggetti da restituire.

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

-IncludeTotalCount

Segnala il numero di oggetti nel set di dati. Attualmente, questo parametro non esegue alcuna operazione.

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

-ObjectId

ID oggetto del gruppo.

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

-Skip

Ignora i primi N oggetti e quindi ottiene gli oggetti rimanenti.

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

Input

String

Guid

Output

PSADGroup