Get-AzADGroup

Riferimento

Modulo:: Az.Resources

Elenca le entità dai gruppi o recupera le entità dai gruppi in base alla chiave

Sintassi

Get-AzADGroup
   [-Count]
   [-Expand <String[]>]
   [-Select <String[]>]
   [-Filter <String>]
   [-Orderby <String[]>]
   [-Search <String>]
   [-ConsistencyLevel <String>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [-CountVariable <String>]
   [<CommonParameters>]

Get-AzADGroup
   [-Expand <String[]>]
   [-Select <String[]>]
   [-ConsistencyLevel <String>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   -DisplayName <String>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADGroup
   [-Expand <String[]>]
   [-Select <String[]>]
   [-ConsistencyLevel <String>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   -DisplayNameStartsWith <String>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADGroup
   [-Expand <String[]>]
   [-Select <String[]>]
   [-ConsistencyLevel <String>]
   [-AppendSelected]
   -ObjectId <Guid>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Descrizione

Elenca le entità dai gruppi o recupera le entità dai gruppi in base alla chiave

Esempio

Esempio 1: Ottenere un gruppo in base al nome visualizzato

Get-AzADGroup -DisplayName $gname

Ottenere il gruppo in base al nome visualizzato

Esempio 2: Elencare i gruppi

Get-AzADGroup -First 10

Elencare i primi 10 gruppi

Esempio 3: Ottenere un gruppo in base all'ID oggetto

Get-AzADGroup -ObjectId $id -Select groupTypes -AppendSelected

Ottenere il gruppo in base all'ID oggetto e aggiungere la proprietà 'groupTypes' dopo le proprietà predefinite: 'DisplayName', 'Id', 'DeletedDateTime', 'SecurityEnabled', 'MailEnabled', 'MailNickname', 'Description'

Esempio 4: Ottenere un gruppo con filtro

Get-AzADGroup -Filter "startsWith(DisplayName,'some-name')"

Ottenere un gruppo con filtro

Esempio 5: Assegnare OdataCount a una variabile

Get-AzADGroup -First 10 -ConsistencyLevel eventual -Count -CountVariable 'result'
$result

Assegnare OdataCount a una variabile

Parametri

-AppendSelected

Le proprietà di accodamento selezionate con le proprietà predefinite quando questa opzione è attivata, funziona solo con il parametro '-Select'.

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

-ConsistencyLevel

Indica il livello di coerenza richiesto. URL della documentazione: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

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

-Count

Includi numero di elementi

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

-CountVariable

Specifica un conteggio del numero totale di elementi in una raccolta. Per impostazione predefinita, questa variabile verrà impostata nell'ambito globale.

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

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Tipo:	PSObject
Alias:	AzContext, 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:	False
Accettare caratteri jolly:	False

-Expand

Espandere le entità correlate

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

-Filter

Filtrare gli elementi in base ai valori delle proprietà. Per altri dettagli sulla query di filtro, vedere: https://learn.microsoft.com/en-us/graph/filter-query-parameter

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

-First

Ottiene solo i primi oggetti 'n'.

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

-ObjectId

key: ID del gruppo

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

-Orderby

Ordinare gli elementi in base ai valori delle proprietà

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

-Search

Ricerca di elementi in base alle frasi di ricerca

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

-Select

Selezionare le proprietà da restituire

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

-Skip

Ignora i primi oggetti 'n' 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

Output

IMicrosoftGraphGroup

Condividi tramite