Set-Group

  • Article

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2009-05-12

La cmdlet Set-Group permet de modifier les paramètres d'un groupe Microsoft Windows existant.

Syntaxe

Set-Group -Identity <GroupIdParameter> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-Group -Identity <GroupIdParameter> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-Universal <SwitchParameter>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-Group [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <WindowsGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Description détaillée

La cmdlet Set-Group permet de modifier des paramètres d'objet groupe visibles dans Utilisateurs et ordinateurs Active Directory. Si le groupe est un groupe de distribution ou un groupe de sécurité à extension messagerie, vous pouvez utiliser la cmdlet Set-DistributionGroup pour modifier d'autres paramètres de Microsoft Exchange Server 2007 qui ne sont pas disponibles à l'aide de la cmdlet Set-Group.

La cmdlet Set-Group ne permet pas de modifier des groupes de distribution dynamique. Pour modifier des groupes de distribution dynamique, utilisez la cmdlet Set-DynamicDistributionGroup.

Pour exécuter la cmdlet Set-Group, vous devez utiliser un compte auquel ont été délégués :

  • le rôle Administrateur des destinataires Exchange ;

  • le rôle Opérateur de compte pour les conteneurs Active Directory applicables.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.GroupIdParameter

Le paramètre Identity spécifie l'objet que vous voulez modifier. Le paramètre Identity peut prendre l'une des valeurs suivantes pour le groupe :

  • Nom unique

  • Nom canonique

  • GUID

  • Name

  • Nom complet

Vous ne pouvez pas utiliser le paramètre Identity si le paramètre Instance est spécifié.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.

DisplayName

Facultatif

System.String

Le paramètre DisplayName spécifie le nom du groupe dans la console de gestion Exchange et dans la liste d'adresses globale (LAG) Exchange. Ce paramètre n'a de signification que pour les groupes à extension messagerie.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ce changement de configuration dans Active Directory, incluez le paramètre DomainController.

IgnoreDefaultScope

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre IgnoreDefaultScope donne pour instruction à la commande d'ignorer le paramétrage de la portée du destinataire par défaut pour l'environnement de ligne de commande Exchange Management Shell et d'utiliser l'ensemble de la forêt comme portée. Cela permet à la commande d'accéder à des objets Active Directory ne figurant pas actuellement dans la portée par défaut. L'utilisation du paramètre IgnoreDefaultScope introduit les restrictions suivantes :

  • Vous ne pouvez pas utiliser le paramètre DomainController. La commande utilisera automatiquement un serveur de catalogue global approprié.

  • Vous ne pouvez utiliser le nom unique que pour le paramètre Identity. D'autres formes d'identification, telles qu'un alias ou un GUID, ne sont pas acceptées.

Instance

Facultatif

Microsoft.Exchange.Data.Directory.Management.WindowsGroup

Le paramètre Instance permet de transmettre un objet entier à la commande à traiter. Il est principalement utilisé dans les scripts où un objet entier doit être transmis à la commande.

Vous ne pouvez pas utiliser le paramètre Instance si le paramètre Indentity est spécifié.

ManagedBy

Facultatif

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

Le paramètre ManagedBy spécifie le nom de l'utilisateur, du groupe ou du contact qui s'affiche sous l'onglet Géré par de l'objet Active Directory. Vous pouvez utiliser toutes les valeurs suivantes pour ce paramètre :

  • Nom unique

  • Nom canonique

  • GUID

  • Name

  • Nom complet

Name

Facultatif

System.String

Le paramètre Name spécifie le nom du groupe. Le paramètre Name spécifie le nom du groupe dans Utilisateurs et ordinateurs Active Directory ainsi que dans le champ Nom de groupe dans la console de gestion Exchange si le groupe est un groupe à extension messagerie.

Notes

Facultatif

System.String

Le paramètre Notes spécifie les notes qui décrivent le but du groupe.

PhoneticDisplayName

Facultatif

System.String

Le paramètre PhoneticDisplayName spécifie une prononciation phonétique pour le paramètre DisplayName.

La longueur maximale de cette valeur de paramètre est de 255 caractères. Pour plus d'informations sur la paramètre PhoneticDisplayName et la reconnaissance vocale, consultez la rubrique Présentation des recherches dans l'annuaire de reconnaissance vocale automatique.

SimpleDisplayName

Facultatif

System.String

Le paramètre SimpleDisplayName affiche une description alternative de l'objet quand un seul jeu de caractères limité est autorisé. Ce jeu de caractères limité comprend les caractères ASCII 26 à 126 inclus. SimpleDisplayName n'a de signification que pour les objets à extension messagerie.

Universal

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Universal modifie la portée du groupe de global ou domain local en universal.

UseRusServer

Facultatif

System.String

 > [!Note] > Ce paramètre n'est disponible que dans Exchange 2007 SP2.

Le paramètre UseRusServer indique à la commande d'utiliser le serveur de boîtes aux lettres spécifié sur lequel le service de listes d'adresses est exécuté pour obtenir puis définir les attributs des boîtes aux lettres et des utilisateurs Active Directory.

Le service de listes d'adresses est un composant du service Surveillance du système Exchange. Le service de listes d'adresses crée et gère les valeurs des attributs spécifiques d'Exchange dans Active Directory. Vous pouvez utiliser le service de listes d'adresses pour mettre à jour les objets destinataire dans un domaine à l'aide d'informations spécifiques telles que l'appartenance à une liste d'adresses et des adresses de messagerie.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf.

WindowsEmailAddress

Facultatif

Microsoft.Exchange.Data.SmtpAddress

Le paramètre WindowsEmailAddress spécifie la valeur du champ Courrier électronique de l'objet Active Directory.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

 

Exceptions

Exceptions Description

 

 

Exemple

L'exemple de code suivant montre comment utiliser la cmdlet Set-Group pour apporter les modifications suivantes à un groupe global de sécurité existant nommé « Legal Department » :

  • Modifier la portée du groupe en universel.

  • Ajouter une valeur de notes verified

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