New-StorageGroup

 

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

Dernière rubrique modifiée : 2007-08-24

La cmdlet New-StorageGroup permet de créer un groupe de stockage sur le serveur spécifié.

Syntaxe

New-StorageGroup -Name <String> [-CircularLoggingEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-CopyLogFolderPath <NonRootLocalLongFullPath>] [-CopySystemFolderPath <NonRootLocalLongFullPath>] [-DomainController <Fqdn>] [-HasLocalCopy <$true | $false>] [-LogFolderPath <NonRootLocalLongFullPath>] [-ReplayLagTime <Nullable>] [-Server <ServerIdParameter>] [-StandbyMachine <String>] [-SystemFolderPath <NonRootLocalLongFullPath>] [-TemplateInstance <PSObject>] [-TruncationLagTime <Nullable>] [-WhatIf [<SwitchParameter>]] [-ZeroDatabasePages <$true | $false>]

New-StorageGroup [-Name <String>] -Recovery <SwitchParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LogFolderPath <NonRootLocalLongFullPath>] [-Server <ServerIdParameter>] [-SystemFolderPath <NonRootLocalLongFullPath>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet New-StorageGroup permet de créer un groupe de stockage ou un groupe de stockage de récupération sur un serveur de boîtes aux lettres Microsoft Exchange Server 2007.

Un groupe de stockage contient des bases de données de boîtes aux lettres et de dossiers publics. Le nombre de groupes de stockage et de bases de données que vous pouvez créer sur un serveur dépend de la version d'Exchange que vous exécutez.

Un groupe de stockage de récupération permet de récupérer des données à partir d'une copie de sauvegarde de la base de données sans perturber l'accès des utilisateurs aux données actuelles. Le groupe de stockage de récupération peut également être utile pour récupérer des données en cas de perte. Un serveur ne peut contenir qu'un seul groupe de stockage de récupération. Un groupe de stockage de récupération ne peut contenir qu'une seule base de données de boîtes aux lettres de récupération. Vous ne pouvez pas monter des dossiers publics sur un groupe de stockage de récupération.

Pour exécuter la cmdlet New-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 2007, consultez la rubrique Considérations relatives aux autorisations.

Pour plus d'informations sur la réplication continue de secours, consultez la rubrique Gestion de la réplication continue de secours.

Paramètres

Paramètre Obligatoire Type Description

Name

Obligatoire

System.String

Le paramètre Name spécifie le nom du nouveau groupe de stockage.

Recovery

Obligatoire

System.Management.Automation.SwitchParameter

Le paramètre Recovery spécifie que le nouveau groupe est désigné comme groupe de stockage de récupération.

CircularLoggingEnabled

Facultatif

System.Boolean

Le paramètre CircularLoggingEnabled avec la valeur $true signifie que l'enregistrement circulaire est activé. La valeur par défaut est $false. L'enregistrement circulaire est automatiquement désactivé si HasLocalCopy, CopyLogFolderPath ou CopySystemFolderPath 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.

CopyLogFolderPath

Facultatif

Microsoft.Exchange.Data.NonRootLocalLongFullPath

Le paramètre CopyLogFolderPath spécifie l'emplacement du dossier destiné aux copies de fichiers journaux. Le chemin par défaut est <ExchangeInstallPath>\Mailbox\LocalCopies\<StorageGroupName>. L'emplacement doit être local. Des lecteurs de disque en accès distant ne sont pas autorisés.

CopySystemFolderPath

Facultatif

Microsoft.Exchange.Data.NonRootLocalLongFullPath

Le paramètre CopySystemFolderPath spécifie l'emplacement du dossier destiné aux copies de fichiers système. Le chemin par défaut est <ExchangeInstallPath>\Mailbox\LocalCopies\<StorageGroupName>.

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 le service d'annuaire Active Directory, incluez le paramètre DomainController dans la commande.

HasLocalCopy

Facultatif

System.Boolean

Le paramètre HasLocalCopy spécifie si le groupe de stockage dispose d'une copie locale. La valeur $true signifie qu'il y a une copie locale du groupe de stockage. La valeur par défaut est $false si aucun chemin d'accès n'est spécifié pour la copie. Si au moins un chemin d'accès est spécifié, la valeur par défaut est $true.

LogFolderPath

Facultatif

Microsoft.Exchange.Data.NonRootLocalLongFullPath

Le paramètre LogFolderPath spécifie l'emplacement du dossier destiné aux fichiers journaux. Le chemin par défaut est <ExchangeInstallPath>\Mailbox<StorageGroupName>.

ReplayLagTime

Facultatif

System.Nullable

Quand une SCR est configurée pour un groupe de stockage, le paramètre ReplayLagtime permet de spécifier le temps pendant lequel le service de réplication Microsoft Exchange doit attendre avant de relire les fichiers journaux copiés sur l'ordinateur cible de la SCR. Le format de ce paramètre est (jours.heures:minutes:secondes). La valeur par défaut de ce paramètre est 24 heures. Le paramètre maximal autorisé pour cette valeur est de 7 jours. Le paramètre minimal autorisé est de 0 secondes. La définition de cette valeur sur 0 secondes n'affecte pas le délai par défaut dans l’activité de relecture de journal de 50 fichiers journaux.

Vous ne pouvez spécifier ReplayLagtime que si StandbyMachine es spécifié.

Server

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Le paramètre Server spécifie le nom du serveur sur lequel le groupe de stockage sera créé. Le rôle de serveur de boîtes aux lettres doit être installé sur le serveur.

StandbyMachine

Facultatif

System.String

Le paramètre StandbyMachine spécifie le serveur sur lequel se trouve la copie de SCR. Le rôle Boîte aux lettres doit être installé sur l'ordinateur de secours et celui-ci ne peut pas faire partie d'un cluster comprenant un serveur de boîtes aux lettres en cluster.

Les valeurs valides pour StandbyMachine sont les suivantes :

  • FQDN

  • Nom de serveur

SystemFolderPath

Facultatif

Microsoft.Exchange.Data.NonRootLocalLongFullPath

Le paramètre SystemFolderPath spécifie l'emplacement du dossier destiné aux fichiers système. Le chemin par défaut est <ExchangeInstallPath>\Mailbox.

<StorageGroupName>.

TemplateInstance

Facultatif

System.Management.Automation.PSObject

Le paramètre TemplateInstance spécifie le modèle utilisé pour créer le groupe de stockage.

TruncationLagTime

Facultatif

System.Nullable

Le paramètre -TruncationLagTime permet de spécifier le temps d’attente du service de réplication Microsoft Exchange avant la troncation des fichiers journaux copiés vers l’ordinateur cible de SCR et relus dans la copie de la base de données. Le décompte commence une fois le dernier journal relu avec succès dans la copie de la base de données. Le format de ce paramètre est (jours.heures:minutes:secondes). Le paramètre maximal autorisé pour cette valeur est de 7 jours. Le paramètre minimal autorisé est de 0 secondes. La définition de cette valeur sur 0 secondes élimine efficacement tout retard dans l’activité de troncature de journal.

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.

ZeroDatabasePages

Facultatif

System.Boolean

Si la valeur du paramètre ZeroDatabasePages est $true, la mise à zéro des pages supprimées est activée. La valeur par défaut est $false.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

Exceptions

Exceptions Description

Exemple

Dans le premier exemple, la commande New-StorageGroup est utilisée pour créer un groupe de stockage.

Dans le deuxième exemple, un groupe de stockage est créé sur un serveur sur lequel une SCR est configurée.

Dans le troisième exemple, la commande Get-StorageGroup permet d'afficher les informations relatives au groupe de stockage créé dans le deuxième exemple.

Notes

Vous ne pouvez pas afficher le délai d'attente directement avec la commande Get-StorageGroup. StandbyMachines est un attribut comportant plusieurs paramètres et vous devez consulter les attributs pour voir le temps d'attente. (Pour plus d'informations, consultez les commandes et les résultats après le troisième exemple.)

New-StorageGroup -Name MyNewStorageGroup -Server ExchangeServer1 -LogFolderPath:"D:\Mailbox\First Storage Group" -SystemFolderPath:"D:\Mailbox\First Storage Group"

New-StorageGroup -Server: 'ExSrvr1' -Name: 'SG9' -LogFolderPath: 'C:\SG9' -SystemFolderPath: 'C:\SG9' -StandbyMachine ExSrvr2 -ReplayLagTime 0.06:00:00 -TruncationLagTime 1.00:00:00

Get-StorageGroup ExSrvr1\SG9 | fl Name,Standbymachines
Name: SG9 StandbyMachines: {ExSrvr2.fabrikam.com}

$sg=Get-StorageGroup ExSrvr1\SG9
$sg.StandbyMachines

NodeNameVersionReplayLagTimeTruncationLagTime
-----------------------------------------
ExSrvr2...106:00:001.00:00:00