Partager via


Set-Group

Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres peuvent être propres à un environnement ou à un autre.

Utilisez l’applet de commande Set-Group pour modifier les paramètres de l’objet de groupe. Si le groupe est un groupe de sécurité à extension messagerie ou un groupe de distribution, vous pouvez utiliser l’applet de commande Set-DistributionGroup pour modifier d’autres paramètres Exchange Microsoft qui ne sont pas disponibles à l’aide de l’applet de commande Set-Group.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntax

Set-Group
   [-Identity] <GroupIdParameter>
   [-BypassSecurityGroupManagerCheck]
   [-Confirm]
   [-Description <MultiValueProperty>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-IgnoreDefaultScope]
   [-IsHierarchicalGroup <Boolean>]
   [-ManagedBy <GeneralRecipientIdParameter[]>]
   [-Name <String>]
   [-Notes <String>]
   [-PhoneticDisplayName <String>]
   [-SeniorityIndex <Int32>]
   [-SimpleDisplayName <String>]
   [-Universal]
   [-WhatIf]
   [-WindowsEmailAddress <SmtpAddress>]
   [<CommonParameters>]

Description

Vous ne pouvez pas utiliser l’applet de commande Set-Group pour modifier des groupes de distribution dynamiques. Pour modifier des groupes de distribution dynamiques, utilisez l’applet de commande Set-DynamicDistributionGroup.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

Set-Group -Identity "Legal Department" -Universal -Notes "verified"

Cet exemple applique les modifications suivantes au service juridique du groupe de sécurité global existant :

Définissez l’étendue du groupe sur universelle.

Ajoutez une valeur de paramètre Notes vérifiée.

Exemple 2

Set-Group -Identity "Human Resources" -IsHierarchicalGroup $true -SeniorityIndex 1

Cet exemple spécifie que le groupe Ressources humaines est un groupe hiérarchique et s’affiche en dernier dans sa hiérarchie, car son numéro d’index est 1.

Paramètres

-BypassSecurityGroupManagerCheck

Le commutateur BypassSecurityGroupManagerCheck spécifie s’il faut autoriser un utilisateur qui n’est pas propriétaire du groupe à modifier ou supprimer le groupe. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Si vous n’êtes pas défini dans la propriété ManagedBy du groupe, vous devez utiliser ce commutateur dans les commandes qui modifient ou suppriment le groupe. Pour utiliser ce commutateur, votre compte nécessite des autorisations spécifiques en fonction du type de groupe :

  • Groupes de distribution ou groupes de sécurité à extension messagerie : vous devez être membre du groupe de rôles Gestion de l’organisation ou avoir le rôle Création et appartenance de groupe de sécurité attribué.
  • Groupes de distribution ou groupes de sécurité à extension messagerie : vous devez être membre du groupe de rôles Gestion de l’organisation ou le rôle Création et appartenance au groupe de sécurité doit vous avoir été affecté.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Confirm

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
  • La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Description

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

{{ Fill Description Description }}

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-DisplayName

Le paramètre DisplayName spécifie le nom complet du groupe. Le nom complet est visible dans le Centre d’administration Exchange et dans les listes d’adresses. La longueur maximale est de 256 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").

Ce paramètre est significatif uniquement si le groupe est à extension messagerie.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DomainController

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : « dc01.contoso.com ».

Les serveurs de transport Edge ne prennent pas en charge le paramètre DomainController. Un serveur de transport Edge utilise l’instance locale des services AD LDS (Active Directory Lightweight Directory Services) pour lire et écrire des données.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Le paramètre Identity spécifie le groupe que vous voulez modifier. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique le groupe. Par exemple :

  • Nom
  • Nom unique
  • Nom unique
  • GUID
Type:GroupIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-IgnoreDefaultScope

Ce paramètre est disponible uniquement dans Exchange sur site.

Le commutateur IgnoreDefaultScope indique à la commande d’ignorer le paramètre d’étendue du destinataire par défaut pour la session Exchange PowerShell et d’utiliser la forêt entière comme étendue. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Ce commutateur permet à la commande d’accéder aux objets Active Directory qui ne sont pas actuellement disponibles dans l’étendue par défaut, mais introduit également les restrictions suivantes :

  • Vous ne pouvez pas utiliser le paramètre DomainController. La commande utilise automatiquement un serveur de catalogue global approprié.
  • Vous ne pouvez pas utiliser le paramètre DomainController. La commande utilise automatiquement un serveur de catalogue global approprié.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IsHierarchicalGroup

Le paramètre IsHierarchicalGroup spécifie si le groupe fait partie d’un carnet d’adresses hiérarchique. Les valeurs valides sont $true ou $false. La valeur par défaut est $false.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ManagedBy

Le paramètre ManagedBy spécifie un propriétaire pour le groupe. Un groupe doit avoir au moins un propriétaire. Si vous n’utilisez pas ce paramètre pour spécifier le propriétaire lorsque vous créez le groupe, le compte d’utilisateur qui a créé le groupe est le propriétaire. Le propriétaire du groupe est en mesure d’effectuer les actions suivantes :

  • Le paramètre ManagedBy spécifie un propriétaire pour le groupe. Un groupe doit avoir au moins un propriétaire. Si vous n’utilisez pas ce paramètre pour spécifier le propriétaire lorsque vous créez le groupe, le compte d’utilisateur qui a créé le groupe est le propriétaire. Le propriétaire du groupe peut effectuer les actions suivantes :
  • modifier les propriétés du groupe ;
  • ajouter ou supprimer des membres du groupe ;
  • supprimer le groupe ;
  • approuver les demandes visant à quitter ou à rejoindre le groupe (le cas échéant) ;

Le propriétaire que vous spécifiez pour ce paramètre doit être une boîte aux lettres, un utilisateur de messagerie ou un groupe de sécurité à extension messagerie (un principal de sécurité à extension messagerie auquel des autorisations peuvent être attribuées). Vous pouvez utiliser n’importe quelle valeur qui identifie de façon unique le propriétaire. Par exemple :

  • Nom
  • Alias
  • Nom unique
  • Nom unique
  • Domaine\Nom d’utilisateur
  • Adresse e-mail
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Identifiant utilisateur ou nom d’utilisateur principal (UPN)

Pour entrer plusieurs propriétaires et remplacer toutes les entrées existantes, utilisez la syntaxe suivante : Owner1,Owner2,...OwnerN. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Owner1","Owner2",..."OwnerN".

Pour ajouter ou supprimer des propriétaires sans affecter d’autres entrées existantes, utilisez la syntaxe suivante : @{Add="Owner1","Owner2",...; Remove="Owner3","Owner4"...}.

Les propriétaires que vous spécifiez avec ce paramètre ne sont pas ajoutés en tant que membres du groupe. Vous devez ajouter manuellement les propriétaires en tant que membres.

Remarque : La gestion des groupes dans Outlook ne fonctionne pas lorsque le propriétaire est un groupe de sécurité à extension messagerie. Pour gérer le groupe dans Outlook, le propriétaire doit être un utilisateur de boîte aux lettres ou de messagerie.

Type:GeneralRecipientIdParameter[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Name

Le paramètre Name spécifie le nom unique du groupe. La longueur maximale est de 64 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Notes

Le paramètre Notes spécifie des informations supplémentaires sur l’objet. Si la valeur contient des espaces, placez-la entre guillemets (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PhoneticDisplayName

Le paramètre PhoneticDisplayName spécifie une autre orthographe du nom de l’utilisateur qui est utilisée pour la conversion de texte par synthèse vocale dans des environnements de messagerie unifiée (MU). En règle générale, vous utilisez ce paramètre lorsque la prononciation et l’orthographe du nom de l’utilisateur ne correspondent pas. La longueur maximale est de 256 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SeniorityIndex

Le paramètre SeniorityIndex spécifie l’ordre dans lequel ce groupe s’affichera dans un carnet d’adresses hiérarchique. Un groupe avec la valeur 2 s’affiche plus haut dans un carnet d’adresses qu’un groupe avec la valeur 1.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SimpleDisplayName

Le paramètre SimpleDisplayName permet d’afficher une autre description de l’objet lorsqu’un ensemble limité de caractères est autorisé. Les caractères valides sont les suivants :

  • Le paramètre SimpleDisplayName permet d’afficher une autre description de l’objet lorsque seul un jeu de caractères limité est autorisé. Les caractères valides sont les suivants :
  • a - z
  • A - Z
  • espace
  • " ' ( ) + , - . / : ?

Ce paramètre est significatif uniquement si le groupe est à extension messagerie.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Universal

Le commutateur Universel change l’étendue du groupe de Global ou DomainLocal à Universal. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WhatIf

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WindowsEmailAddress

Le paramètre WindowsEmailAddress spécifie l’adresse e-mail Windows de ce destinataire. Il s’agit d’un attribut Active Directory courant présent dans tous les environnements, y compris les environnements sans Exchange. L’utilisation du paramètre WindowsEmailAddress sur un destinataire a l’un des résultats suivants :

  • Dans les environnements où le destinataire est soumis à des stratégies d’adresse e-mail (la propriété EmailAddressPolicyEnabled est définie sur la valeur True pour le destinataire), le paramètre WindowsEmailAddress n’a aucun effet sur la propriété WindowsEmailAddress ou la valeur d’adresse e-mail principale.
  • Dans les environnements où le destinataire n’est pas soumis à des stratégies d’adresse e-mail (la propriété EmailAddressPolicyEnabled est définie sur la valeur False pour le destinataire), le paramètre WindowsEmailAddress met à jour la propriété WindowsEmailAddress et l’adresse e-mail principale avec la même valeur.

La propriété WindowsEmailAddress est visible pour le destinataire dans Utilisateurs et ordinateurs Active Directory dans l’attribut E-mail. Le nom commun de l’attribut est E-mail-Addresses, et ldap-Display-Name est mail. Si vous modifiez cet attribut dans Active Directory, l’adresse e-mail principale du destinataire n’est pas mise à jour avec la même valeur.

Type:SmtpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Entrées

Input types

Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.

Sorties

Output types

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.