Set-Group
Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres et paramètres peuvent être exclusifs à un environnement ou à l’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 Microsoft Exchange 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.
Syntaxe
Default (Par défaut)
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 cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont 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 affiche le dernier dans sa hiérarchie, car son numéro d’index est 1.
Paramètres
-BypassSecurityGroupManagerCheck
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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é.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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-*) comportent 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Description
Applicable : Exchange Online, Exchange Online Protection
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
{{ Fill Description Description }}
Propriétés du paramètre
| Type: | MultiValuedProperty |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DisplayName
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DomainController
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriétés du paramètre
| Type: | Fqdn |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Identity
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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
Propriétés du paramètre
| Type: | GroupIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-IgnoreDefaultScope
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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é.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-IsHierarchicalGroup
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ManagedBy
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Propriétés du paramètre
| Type: | GeneralRecipientIdParameter[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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 (").
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Notes
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
Le paramètre Notes spécifie des informations supplémentaires sur l’objet. Si la valeur contient des espaces, placez-la entre guillemets (").
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PhoneticDisplayName
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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 (").
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SeniorityIndex
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
Le paramètre SeniorityIndex spécifie l’ordre dans lequel ce groupe s’affiche 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.
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SimpleDisplayName
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Universal
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WindowsEmailAddress
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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 a la valeur True pour le destinataire), le paramètre WindowsEmailAddress n’a aucun effet sur la propriété WindowsEmailAddress ou la valeur 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 le adresse e-mail principale à 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, la adresse e-mail principale du destinataire n’est pas mise à jour avec la même valeur.
Propriétés du paramètre
| Type: | SmtpAddress |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
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.