Condividi tramite

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-6F268D322EEEE'.

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

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisplayName

Il nome visualizzato del gruppo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisplayNameStartsWith

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

Tipo:String
Alias:SearchString
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-First

Numero massimo di oggetti da restituire.

Tipo:UInt64
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IncludeTotalCount

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ObjectId

ID oggetto del gruppo.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Skip

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

Tipo:UInt64
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

Guid

Output

PSADGroup