Set-StorageGroup

 

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

Dernière rubrique modifiée : 2007-06-28

La cmdlet Set-StorageGroup permet de définir les attributs d'un groupe de stockage dans le service d'annuaire Active Directory.

Syntaxe

Set-StorageGroup -Identity <StorageGroupIdParameter> [-CircularLoggingEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Name <String>] [-WhatIf [<SwitchParameter>]] [-ZeroDatabasePages <$true | $false>]

Set-StorageGroup [-CircularLoggingEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <StorageGroup>] [-Name <String>] [-WhatIf [<SwitchParameter>]] [-ZeroDatabasePages <$true | $false>]

Description détaillée

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

  • le rôle Administrateur de serveur Exchange et le groupe Administrateurs local pour le serveur cible.

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.StorageGroupIdParameter

Le paramètre Identity permet de spécifier le GUID ou le nom unique représentant un groupe de stockage spécifique. Vous pouvez également inclure le nom de serveur en utilisant le format NomServeur\GroupeStockage. L'étiquette du paramètre Identity est facultative.

CircularLoggingEnabled

Facultatif

System.Boolean

Le paramètre CircularLoggingEnabled permet d'effectuer un enregistrement circulaire avec une valeur de $true. La valeur par défaut est $false.

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.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

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

Instance

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.StorageGroup

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.

Name

Facultatif

System.String

Le paramètre Name définit le nouveau nom du groupe de stockage.

ZeroDatabasePages

Facultatif

System.Boolean

Le paramètre ZeroDatabasePages permet d'effectuer une mise à zéro des pages supprimées avec une valeur de $true. La valeur par défaut est $false.

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.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

 

Exceptions

Exceptions Description

 

 

Exemple

Le code suivant est un exemple de la commande Set-StorageGroup qui renomme Storage_Group_1 en « MyStorageGroup ».

Set-StorageGroup -Identity  "Exchange-Server-1.Contoso.com\StorageGroup-1" -Name MyStorageGroup