Get-AzADGroup

Référence

Module:: Az.Resources

Répertorie les entités à partir de groupes ou obtenir des entités à partir de groupes par clé

Syntaxe

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

Description

Répertorie les entités à partir de groupes ou obtenir des entités à partir de groupes par clé

Exemples

Exemple 1 : Obtenir un groupe par nom d’affichage

Get-AzADGroup -DisplayName $gname

Obtenir un groupe par nom d’affichage

Exemple 2 : Répertorier les groupes

Get-AzADGroup -First 10

Répertorier les 10 premiers groupes

Exemple 3 : Obtenir un groupe par ID d’objet

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

Get group by object id and append property 'groupTypes' after default properties : 'DisplayName', 'Id', 'DeletedDateTime', 'SecurityEnabled', 'MailEnabled', 'MailEnabled', 'MailNickname', 'Description'

Exemple 4 : Obtenir un groupe avec un filtre

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

Obtenir un groupe avec un filtre

Exemple 5 : Affecter OdataCount à une variable

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

Affecter OdataCount à une variable

Paramètres

-AppendSelected

Ajoutez les propriétés sélectionnées avec les propriétés par défaut lorsque ce commutateur est activé, fonctionne uniquement avec le paramètre « -Select ».

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ConsistencyLevel

Indique le niveau de cohérence demandé. URL de la documentation : https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Count

Inclure le nombre d’éléments

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-CountVariable

Spécifie le nombre total d’éléments d’une collection. Par défaut, cette variable est définie dans l’étendue globale.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:	PSObject
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DisplayName

Nom d’affichage du groupe.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DisplayNameStartsWith

Permet de rechercher des groupes commençant par la chaîne fournie.

Type:	String
Alias:	SearchString
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Expand

Développer les entités associées

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Filter

Filtrez les éléments par valeurs de propriété, pour plus d’informations sur la requête de filtre, consultez : https://learn.microsoft.com/en-us/graph/filter-query-parameter

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-First

Obtient uniquement les premiers objets 'n'.

Type:	UInt64
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ObjectId

clé : ID du groupe

Type:	Guid
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Orderby

Classer les éléments par valeurs de propriété

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Search

Rechercher des éléments par expressions de recherche

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Select

Sélectionner les propriétés à renvoyer

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Skip

Ignore les premiers objets « n », puis obtient les objets restants.

Type:	UInt64
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Sorties

IMicrosoftGraphGroup

Partager via