Update-AzADGroup

Module:

Az.Resources

mettre à jour l’entité dans les groupes

Syntaxe

Update-AzADGroup
      -ObjectId <String>
      [-AdditionalProperties <Hashtable>]
      [-AppRoleAssignment <IMicrosoftGraphAppRoleAssignmentAutoGenerated[]>]
      [-Classification <String>]
      [-CreatedOnBehalfOf <IMicrosoftGraphDirectoryObject>]
      [-DeletedDateTime <DateTime>]
      [-Description <String>]
      [-DisplayName <String>]
      [-GroupType <String[]>]
      [-HasMembersWithLicenseError]
      [-IsArchived]
      [-IsAssignableToRole]
      [-MailEnabled]
      [-MailNickname <String>]
      [-MembershipRule <String>]
      [-MembershipRuleProcessingState <String>]
      [-PermissionGrant <IMicrosoftGraphResourceSpecificPermissionGrant[]>]
      [-PreferredDataLocation <String>]
      [-PreferredLanguage <String>]
      [-SecurityEnabled]
      [-SecurityIdentifier <String>]
      [-Theme <String>]
      [-Visibility <String>]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzADGroup
      -ObjectId <String>
      -JsonFilePath <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzADGroup
      -ObjectId <String>
      -JsonString <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

mettre à jour l’entité dans les groupes

Exemples

Exemple 1 : Description de mise à jour pour le groupe

Update-AzADGroup -ObjectId $objectid -Description $description

Mise à jour de la description du groupe.

Paramètres

-AdditionalProperties

Paramètres supplémentaires

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

-AppRoleAssignment

Représente les rôles d’application qu’un groupe a reçus pour une application. Prend en charge $expand.

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

-Classification

Décrit une classification pour le groupe (par exemple, un impact commercial faible, moyen ou élevé). Les valeurs valides pour cette propriété sont définies en créant une valeur de paramètre ClassificationList, en fonction de la définition du modèle. Retourné par défaut. Prend en charge $filter (eq, ne, NOT, ge, le, startsWith).

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

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

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

-CreatedOnBehalfOf

Représente un objet Azure Active Directory. Le type directoryObject est le type de base pour de nombreux autres types d’entités d’annuaire.

Type:	IMicrosoftGraphDirectoryObject
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

Le paramètre DefaultProfile n’est pas fonctionnel. Utilisez le paramètre SubscriptionId lorsqu’il est disponible si vous exécutez l’applet de commande sur un autre abonnement.

Type:	PSObject
Alias:	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

-DeletedDateTime

.

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

-Description

Description facultative du groupe. Retourné par défaut. Prend en charge $filter (eq, ne, NOT, ge, le, startsWith) et $search.

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

-DisplayName

Nom affiché dans le répertoire

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

-GroupType

Spécifie le type de groupe et son appartenance. Si la collection contient Unified, le groupe est un groupe Microsoft 365 ; sinon, il s’agit d’un groupe de sécurité ou d’un groupe de distribution. Pour plus d’informations, consultez la vue d’ensemble des groupes. Si la collection inclut DynamicMembership, le groupe a une appartenance dynamique ; sinon, l’appartenance est statique. Retourné par défaut. Prend en charge $filter (eq, NOT).

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

-HasMembersWithLicenseError

Indique s’il existe des membres dans ce groupe qui ont des erreurs de licence à partir de son attribution de licence basée sur le groupe. Cette propriété n’est jamais retournée sur une opération GET. Vous pouvez l’utiliser en tant qu’argument $filter pour obtenir des groupes qui ont des membres ayant des erreurs de licence (autrement dit, filtrer pour cette propriété étant true). Prend en charge $filter (eq).

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

-IsArchived

.

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

-IsAssignableToRole

Indique si ce groupe peut être affecté à un rôle Azure Active Directory. Cette propriété ne peut être définie que lors de la création du groupe et est immuable. Si la valeur est true, la propriété securityEnabled doit également être définie sur true et le groupe ne peut pas être un groupe dynamique (autrement dit, groupTypes ne peut pas contenir DynamicMembership). Seuls les appelants dans les rôles d’administrateur général et d’administrateur de rôle privilégié peuvent définir cette propriété. L’appelant doit également recevoir l’autorisation Directory.AccessAsUser.All pour définir cette propriété. Pour plus d’informations, consultez Utilisation d’un groupe pour gérer les attributions de rôles Azure ADReturned par défaut. Prend en charge $filter (eq, ne, NOT).

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

-JsonFilePath

Chemin d’accès du fichier Json fourni à l’opération de mise à jour

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

-JsonString

Chaîne Json fournie à l’opération Update

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

-MailEnabled

Spécifie si le groupe est activé pour la messagerie. Retourné par défaut. Prend en charge $filter (eq, ne, NOT).

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

-MailNickname

Alias de messagerie pour le groupe, unique dans l’organisation. Cette propriété doit être spécifiée lors de la création d’un groupe. Ces caractères ne peuvent pas être utilisés dans mailNickName : @()/[]' ;:.<>,ESPACE. Retourné par défaut. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-MembershipRule

Règle qui détermine les membres de ce groupe si le groupe est un groupe dynamique (groupTypes contient DynamicMembership). Pour plus d’informations sur la syntaxe de la règle d’appartenance, consultez la syntaxe règles d’appartenance. Retourné par défaut. Prend en charge $filter (eq, ne, NOT, ge, le, startsWith).

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

-MembershipRuleProcessingState

Indique si le traitement d’appartenance dynamique est activé ou suspendu. Les valeurs possibles sont activées ou suspendues. Retourné par défaut. Prend en charge $filter (eq, ne, NOT, in).

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

-ObjectId

clé : ID du groupe

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

-PassThru

Retourne true lorsque la commande réussit

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

-PermissionGrant

Autorisations accordées pour un groupe à une application spécifique. Prend en charge $expand.

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

-PreferredDataLocation

Emplacement de données préféré du groupe. Pour plus d’informations, consultez OneDrive Online Multi-Geo. Retourné par défaut.

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

-PreferredLanguage

Langue préférée pour un groupe Microsoft 365. Doit suivre le code ISO 639-1 ; par exemple 'en-US'. Retourné par défaut. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-SecurityEnabled

Spécifie si le groupe est un groupe de sécurité. Retourné par défaut. Prend en charge $filter (eq, ne, NOT, in).

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

-SecurityIdentifier

Identificateur de sécurité du groupe, utilisé dans les scénarios Windows. Retourné par défaut.

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

-Theme

Spécifie le thème de couleur d’un groupe Microsoft 365. Les valeurs possibles sont Teal, Violet, Vert, Bleu, Rose, Orange ou Rouge. Retourné par défaut.

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

-Visibility

Spécifie la stratégie de jointure de groupe et la visibilité du contenu de groupe pour les groupes. Les valeurs possibles sont : Private, Public ou Hiddenmembership. Hiddenmembership ne peut être défini que pour les groupes Microsoft 365, lorsque les groupes sont créés. Elle ne peut pas être mise à jour ultérieurement. D’autres valeurs de visibilité peuvent être mises à jour après la création du groupe. Si la valeur de visibilité n’est pas spécifiée lors de la création du groupe sur Microsoft Graph, un groupe de sécurité est créé en tant que privé par défaut et le groupe Microsoft 365 est public. Pour en savoir plus, consultez les options de visibilité de groupe. Retourné par défaut.

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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:	SwitchParameter
Alias:	wi
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

Boolean