Update-StorageGroupCopy

 

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

Dernière rubrique modifiée : 2007-10-31

La cmdlet Update-StorageGroupCopy permet de lancer ou de resynchroniser la réplication pour une copie de groupe de stockage spécifiée dans une réplication continue en cluster (CCR) Microsoft Exchange Server 2007 ou une réplication continue locale (LCR). La cmdlet permet également de resynchroniser la réplication dans un environnement de réplication continue de secours (SCR).

Syntaxe

Update-StorageGroupCopy -Identity <StorageGroupIdParameter> [-Confirm [<SwitchParameter>]] [-DataHostNames <String[]>] [-DeleteExistingFiles <SwitchParameter>] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-ManualResume <SwitchParameter>] [-StandbyMachine <String>] [-TargetPath <LocalLongFullPath>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet Update-StorageGroupCopy permet de lancer ou de resynchroniser manuellement la réplication pour une copie passive de CCR ou de LCR, ou une cible de SCR. La cmdlet reprend automatiquement la réplication sur la copie du groupe de stockage. Si vous avez choisi de reprendre manuellement la réplication, vous pouvez exécuter la cmdlet avec le paramètre ManualResume.

Cette opération doit être effectuée dans les situations suivantes :

  • Vous avez créé une copie de groupe de stockage via la LCR ou la SCR ne disposant pas d'une base de données de base.

  • La copie passive de la base de données ou de la cible de SCR est endommagée.

  • La copie passive de la base de données ou de la cible de SCR est obsolète.

  • Vous avez un environnement de réplication continue et avez besoin d'une nouvelle base de données de base pour la copie passive. Cette situation peut être due à un endommagement, une modification de la configuration, une perte de serveur ou une base de données de base non valide sur la copie passive.

  • Vous avez exécuté une défragmentation hors connexion de la copie active ou passive de la base de données.

Tenez compte des informations suivantes lorsque vous utilisez la cmdlet Update-StorageGroupCopy :

  • Le paramètre TargetPath permet d'amorcer une base de données vers un chemin d'accès différent de l'emplacement configuré de la copie passive de la base de données. Par exemple, lorsqu'une cible de SCR est située dans un emplacement physique distant, vous pouvez utiliser le paramètre TargetPath pour exécuter la mise à jour localement sur la source de SCR, puis exécuter un utilitaire de copie qui fournit une compression de données afin de déplacer la copie du réseau vers l'ordinateur cible de SCR.

  • Si le paramètre TargetPath n'est pas spécifié, la cmdlet Update-StorageGroupCopy doit être émise sur l'ordinateur contenant la copie passive.

  • Si le paramètre StandbyMachine n'est pas spécifié, la cmdlet Update-StorageGroupCopy s'applique à la copie passive de LCR ou CCR locale.

  • Vous ne pouvez pas exécuter la commande Update-StorageGroupCopy si des sauvegardes (sauvegardes en continu héritées ou VSS (Volume Shadow Copy Service)) sont exécutées sur le même groupe de stockage.

  • Si la communication avec la copie active est perdue ou échoue, l'opération doit être complètement redémarrée.

  • Vous devez vérifier qu'il y a suffisamment d'espace avant d'initialiser la cmdlet car il n'y a aucun contrôle automatique. L’utilisation du paramètre DeleteExistingFiles requiert de disposer de l’espace nécessaire pour deux copies de la base de données sur le volume cible car la base de données existante n’est supprimée qu’à la création d’une autre base de données.

  • La cmdlet Update-StorageGroupCopy peut affecter la bande passante réseau disponible et, dans une moindre mesure, les performances du serveur de production. Vous pouvez utiliser le paramètre DataHostNames pour spécifier le réseau à utiliser pour l'amorçage ou le réamorçage.

La cmdlet Update-StorageGroupCopy requiert qu'aucun fichier Exchange n'existe dans l'emplacement cible lorsqu'elle est exécutée et que l'activité de réplication de la copie du groupe de stockage soit suspendue. La cmdlet Suspend-StorageGroupCopy permet de suspendre la copie du groupe de stockage. Une fois l’amorçage effectué, la réplication de la copie du groupe de stockage est redémarrée automatiquement sauf si le paramètre ManualResume est spécifié.

Pour utiliser la cmdlet Update-StorageGroupCopy sur un ordinateur sur lequel un serveur de boîtes aux lettres en cluster est installé, vous devez utiliser un compte auquel le rôle Administrateur de serveur Exchange et le groupe Administrateurs local ont été délégués 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.

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.StorageGroupIdParameter

Le paramètre Identity prend l'une des valeurs suivantes :

  • GUID

  • Nom du groupe de stockage

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et demande à l'administrateur de confirmer les actions que la commande va effectuer avant de continuer le traitement. La valeur par défaut est $true.

DataHostNames

Facultatif

System.String[]

Le paramètre DataHostNames spécifie les réseaux de clusters à utiliser pour l'amorçage. Vous pouvez spécifier jusqu'à deux noms d'hôte.

DeleteExistingFiles

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre DeleteExistingFiles entraîne la suppression par la commande des fichiers journaux existants à l'emplacement cible. Elle supprime uniquement les fichiers recherchés et échoue si d'autres fichiers sont présents. Aucune mesure n'est prise pour les autres fichiers se trouvant à l'emplacement cible. C'est pourquoi, si d'autres fichiers sont disponibles, vous devez les supprimer manuellement.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine utilisé pour accéder à l'objet groupe de stockage, utilisez le paramètre DomainController dans la cmdlet.

Force

Facultatif

System.Management.Automation.SwitchParameter

Vous pouvez utiliser le paramètre Force lorsque la tâche est exécutée par programme et que les invites d'intervention administrative sont inappropriées. Si le paramètre Force n'est pas intégré dans la cmdlet, une intervention administrative est demandée. Si le paramètre Force est intégré dans la cmdlet mais que la valeur est omise, sa valeur par défaut est $true.

ManualResume

Facultatif

System.Management.Automation.SwitchParameter

Utilisez le paramètre ManualResume lorsque vous ne voulez pas que la cmdlet Update-StorageGroupCopy reprenne automatiquement la réplication de la copie du groupe de stockage. Ce paramètre vous permet de reprendre manuellement la réplication de la copie du groupe de stockage.

StandbyMachine

Facultatif

System.String

Le paramètre StandbyMachine spécifie le nom d'un serveur configuré comme cible pour la SCR. Ce paramètre doit être utilisé lors de la mise à jour de la copie de groupe de stockage pour une cible de SCR. Si le paramètre StandbyMachine n'est pas spécifié, la cmdlet Update-StorageGroupCopy s'applique à la copie passive de LCR ou CCR locale.

TargetPath

Facultatif

Microsoft.Exchange.Data.LocalLongFullPath

Le paramètre TargetPath spécifie l'emplacement du fichier de base de données sur l'ordinateur local. Il s'agit du répertoire qui contiendra la base de données. La dernière partie du chemin d'accès est déterminée par le nom de base de la source. Dans un environnement de CCR, la cmdlet Update-StorageGroupCopy doit être exécutée sur le noeud passif lorsque le paramètre TargetPath est omis. Dans un environnement de SCR, la cmdlet Update-StorageGroupCopy doit être exécutée sur l'ordinateur cible de SCR lorsque le paramètre TargetPath est omis.

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, l'administrateur peut afficher les changements potentiels sans devoir les appliquer. La valeur par défaut est $true.

Erreurs

Erreur Description

Update-StorageGroupCopy: Online database seeding error: MSExchangeIS (Information Store) is not online on '< CMSNameorServerName >'.

La tâche n'a pas pu se connecter au serveur en raison d'un problème de communication.

Update-StorageGroupCopy: Online database seeding error: '< SGName >' is not suspended. The storage group must be suspended before seeding.

Le groupe de stockage doit être suspendu avant de pouvoir être amorcé.

Update-StorageGroupCopy: This task must be run on the second copy's machine if the ' TargetPath ' parameter is omitted.

Vous devez exécuter cette tâche sur la copie passive en cas d'omission du paramètre TargetPath.

Update-StorageGroupCopy is unable to update the storage group copy because this task is only supported on servers running Exchange Server 2007. < ServerName > is not running Exchange Server 2007.

La LCR et la CCR ne sont prises en charge que dans Exchange 2007. La SCR est prise en charge dans Microsoft Exchange Server 2007 Service Pack 1 (SP1) uniquement.

Access denied. The account used to run this task does not have sufficient privileges to update storage group copy from < ServerName >. Please use an account that has been assigned the Exchange Server Admin role.

L'utilisateur ne dispose pas des autorisations Administrateur de serveur Exchange sur le serveur spécifié.

< ServerName > or < StorageGroupName > does not exist.

L'identité spécifiée n'existe pas.

Update-StorageGroupCopy: Continuous replication is not configured on '< SGName >'.

CCR (when no second node):

Update-StorageGroupCopy: Continuous replication is not configured on '< SGName >'.

Le groupe de stockage spécifié n'est pas configuré pour prendre en charge la réplication.

Database:

Update-StorageGroupCopy: Online database seeding error: Target database ('< thePath >') already exists. It must be removed.

Logs:

Update-StorageGroupCopy : Online database seeding error: Log files already exist at '< thePath >'. They must be removed.

Les fichiers journaux et une base de données n'ont pas été supprimés avant l'exécution de la mise à jour sans target path. Supprimez les fichiers journaux, de base de données, de point de contrôle et .jtx à l'emplacement cible.

Update-StorageGroupCopy: Online database seeding error: The database is not mounted.

La base de données de production n'est pas montée. Montez la base de données et exécutez de nouveau la tâche.

Specified path is not available.

Le chemin d'accès spécifié n'est pas disponible ou accessible en écriture.

Update-StorageGroupCopy: Online database seeding error: The database is currently being backed up.

Storage group <StorageGroupName> failed to seed at <DatabaseLocation>. Reason: Error Code (0x50d).

Une opération de sauvegarde de la base de données source est déjà en cours.

Update-StorageGroupCopy: Online database seeding error: Communication failure; Exchange Information Store (MSExchangeIS) on '< ServerName >' is unavailable.

Communication perdue avec la source. Mise à jour terminée.

Update-StorageGroupCopy: Online database seeding error: < ErrorCode >.

Échec de l'amorçage en raison d'une des conditions suivantes :

  • Erreur non spécifiée

  • Entrée ou paramètre non valide

  • Mémoire vive insuffisante

  • Espace disque insuffisant

  • Échec de l'acquisition du droit de processus

  • Le répertoire d'amorçage n'existe pas

  • Les fichiers journaux existent déjà

  • Les fichiers *.jtx existent déjà

  • Le groupe de stockage n'existe pas

Update-StorageGroupCopy: Failed to create the directory '< DirectoryPath >'. The error code is '< code d'erreur >'.

L'opération n'est pas parvenue à créer le répertoire demandé pour héberger la base de données.

The DataHostNames switch does not accept more than two host names.

Vous ne pouvez spécifier que deux noms d'hôte de réplication continue avec le paramètre DataHostNames.

The DataHostNames parameter did not contain any local machine names.

Vous devez spécifier un nom d'hôte de réplication continue enregistré sur le noeud local.

Exemple

Le premier exemple décrit la procédure de réamorçage de la copie passive du groupe de stockage SG1 sur le serveur Server1.

Le deuxième exemple décrit la procédure de réamorçage de la copie passive du groupe de stockage SG1 sur le serveur de boîtes aux lettres en cluster Server1 en utilisant deux noms d'hôte de réplication continue, NET1 et NET2.

Le troisième exemple décrit la procédure de réamorçage d'une copie cible de SCR du groupe de stockage SG1 sur le serveur Server1, avec la copie cible de SCR hébergée sur le serveur Server2.

Update-StorageGroupCopy -Identity Server1\SG1
Update-StorageGroupCopy -Identity Server1\SG1 -DataHostNames {Net1,Net2}
Update-StorageGroupCopy -Identity Server1\SG1 -StandByMachine Server2