Rubrique précédente: Utilisation des commandes CA ARCserve RHA PowerShell

Resume-Scenario : reprise de la réplication sur un ordinateur de réplication suspendu

La commande Resume-Scenario vous permet de reprendre le processus de réplication sur un hôte de réplication suspendu. Une fois la réplication reprise, les modifications stockées sont transférées et appliquées à l'ordinateur de réplication sans nécessiter une resynchronisation complète des données.

Syntaxe
Resume-Scenario [-Name] <Chaîne> [-Host] <Chaîne>
Paramètres
Nom

Nom du scénario.

Hôte

Nom de l'hôte de réplication suspendu que vous souhaitez reprendre.

Exemple : Reprise du processus de réplication sur un ordinateur de réplication suspendu

resume-scenario "File Server 1" 192.168.1.153

Résultat :

Scenario File Server 1 resumed on 192.168.1.153

Run-Scenario : démarrage d'un scénario

La commande Run-Scenario vous permet de démarrer un ou plusieurs scénarios.

Syntaxe
Run-Scenario [-Name] <Chaîne> [-Mode] <Chaîne> [-Ignore] <Valeur_booléenne> 
Paramètres
Nom

Nom du scénario. Vous pouvez saisir plusieurs noms de scénarios en utilisant la commande Get-Scenario.

Mode

Mode de synchronisation. Choisissez l'une des valeurs suivantes :

B = binaire

F = fichier

Ignorer

Permet d'ignorer les fichiers portant le même nom et de la même taille pendant la comparaison des données. Choisissez l'une des valeurs suivantes :

1 = Oui

0 = Non

Remarques :

Exemple : Démarrage d'un scénario

run-scenario "Serveur de fichiers 1" F 1

Résultat :

Démarrage en cours du scénario Serveur de fichiers 1...

Run-Assessment : exécution d'un scénario en mode d'évaluation

La commande Run-Assessment vous permet d'évaluer l'utilisation précise de la bande passante et le taux de compression nécessaires à la réplication, sans répliquer réellement les données. Lorsque vous exécutez cette commande, aucune réplication ne se produit, mais des statistiques sont recueillies. Un rapport est fourni une fois le processus d'évaluation arrêté.

Important : Lorsque la période à évaluer est terminée, pensez à arrêter le scénario s'exécutant en mode d'évaluation à l'aide de la commande Stop-Scenario.

Remarque : Pour afficher le rapport d'évaluation après sa génération, ouvrez le centre de rapports dans la page de présentation et sélectionnez le rapport souhaité.

Syntaxe
Run-Assessment [-Name] <Chaîne>
Paramètres
Nom

Nom du scénario.

Exemple : Exécution d'un scénario en mode d'évaluation

run-assessment "Serveur de fichiers 1"

Résultat :

Scénario Serveur de fichiers 1 exécuté

Set-Bookmark : définition d'un repère de retour arrière

Un repère est un point de contrôle défini manuellement afin de marquer un état auquel vous pouvez revenir au moyen d'un retour arrière. La commande Set-Bookmark vous permet de définir un repère pour un scénario donné. Les repères sont définis en temps réel, ils ne s'appliquent pas aux événements antérieurs. Nous vous recommandons de définir un repère immédiatement avant toute activité pouvant entraîner l'instabilité des données.

Remarques :

Syntaxe
Set-Bookmark [-Name] <Chaîne> [[-Message] <Chaîne>]
Paramètres
Nom

Nom du scénario.

Message (facultatif)

Nom du repère. Le nom par défaut inclut la date et l'heure du paramétrage du repère.

Remarque : Nous vous recommandons d'attribuer un nom explicite au repère.

Exemple : Définition d'un repère de retour arrière

set-bookmark "Serveur de fichiers 1" Backup1

Résultat :

Scénario Serveur de fichiers 1 : le repère de retour arrière a été défini.

Stop-Scenario : arrêt d'un scénario

La commande Stop-Scenario vous permet d'arrêter un ou plusieurs scénarios.

Remarque : Pour vérifier si l'opération a été correctement effectuée, utilisez les commandes Get-Scenario et Get-Events.

Syntaxe
Stop-Scenario [-Name] <Chaîne>  
Paramètres
Nom

Nom du scénario que vous souhaitez arrêter. Vous pouvez saisir plusieurs noms de scénarios en utilisant la commande Get-Scenario.

Exemple : Arrêt d'un scénario

stop-scenario "Serveur de fichiers 1"

Résultat :

Scénario Serveur de fichiers 1 arrêté

Suspend-IsAliveCheck : suspend le contrôle d'activation d'un scénario en cours d'exécution

La commande Suspend-IsAliveCheck permet de suspendre manuellement le contrôle d'activation d'un scénario de haute disponibilité en cours d'exécution.

Syntaxe
Suspend-IsAliveCheck [-ScenarioName] <Chaîne>  
Paramètres
ScenarioName

Nom du scénario.

Exemple : Suspension du contrôle d'activation de SQLscenario

Suspend-IsAliveCheck SQLscenario

Résultat :

Suspend le contrôle d'activation périodique de SQLscenario.

Suspend-Scenario : suspension des mises à jour sur un ordinateur de réplication

La commande Suspend-Scenario vous permet d'interrompre temporairement l'envoi des modifications à un ordinateur de réplication suspendu. Pendant la suspension, les modifications sont stockées dans un spool jusqu'à ce que la réplication reprenne, afin d'éviter une resynchronisation.

Important : Pendant une suspension, n'effectuez aucune action sur l'ordinateur de réplication afin de ne modifier aucune données et ne démarrez par d'applications telles qu'Exchange, SQL Server ou Oracle. Si vous avez besoin de démarrer des programmes qui modifient les données de l'ordinateur de réplication, vous pouvez utiliser l'option Récupération garantie.

Remarques :

Syntaxe
Suspend-Scenario [-Name] <Chaîne> [-Host] <Chaîne> 
Paramètres
Nom

Nom du scénario.

Hôte

Hôte de réplication que vous souhaitez suspendre.

Exemple : Suspension des mises à jour sur un ordinateur de réplication

suspend-scenario "File Server 1" 192.168.1.153

Résultat :

Scenario File Server 1 suspendu sur 192.168.1.153

Switchover-Scenario : réalisation d'une permutation

La commande Switchover-Scenario vous permet de démarrer le processus de permutation pour un scénario de haute disponibilité donné. Pour inverser les rôles entre l'ordinateur maître et l'ordinateur de réplication, utilisez à nouveau la commande Switchover-Scenario.

Syntaxe
Switchover-Scenario [-Name] <Chaîne> 
Paramètres
Nom

Nom du scénario.

Exemple : Réalisation d'une permutation

Switchover-Scenario "SQL Server 1"
Résultat :
Scénario SQL Server 1 basculé vers 192.168.1.153
Terminé

Sync-Scenario : lancement d'une synchronisation

La commande Sync-Scenario vous permet de synchroniser les ordinateurs maître et de réplication d'un scénario donné. Le processus de synchronisation peut être activé manuellement à tout instant, que la réplication soit en cours d'exécution ou non.

Syntaxe
Sync-Scenario [-Name] <Chaîne> [-Mode] <Chaîne> [-Ignore] <Valeur_booléenne> 
Paramètres
Nom

Nom du scénario. Vous pouvez saisir plusieurs noms de scénarios en utilisant la commande Get-Scenario.

Mode

Mode de synchronisation. Choisissez l'une des valeurs suivantes :

B = binaire

F = fichier

Ignorer

Permet d'ignorer les fichiers portant le même nom et de la même taille pendant la comparaison des données. Choisissez l'une des valeurs suivantes :

1 = Oui

0 = Non

Exemple : Lancement d'une synchronisation

sync-scenario "Serveur de fichiers 1" F 1

Résultat :

La synchronisation est en cours d'exécution pour le scénario FS 1...
Terminé

Test-Integrity : réalisation d'un test d'intégrité pour la récupération garantie

La commande Test-Integrity vous permet d'activer un test d'intégrité automatique sur un hôte de réplication pour la récupération garantie.

Remarques :

Syntaxe
Test-Integrity [-Name] <Chaîne> [-Host] <Chaîne>
Paramètres
Nom

Nom du scénario.

Hôte

Adresse IP ou nom de l'hôte de réplication à tester.

Exemple : Réalisation d'un test d'intégrité pour la récupération garantie

Test-Integrity "Exchange Server 1" 192.168.1.153
Résultat :
Test d'intégrité pour la récupération garantie lancé sur 192.168.1.153
Terminé
Test d'intégrité pour la récupération garantie terminé sur 192.168.1.153

Unmount-Snapshot : démontage d'un cliché

La commande Unmount-Snapshot vous permet de libérer un cliché exposé sans perdre le cliché lui-même. Le cliché est toujours exposé, mais il n'utilise pas de point de montage.

Syntaxe
Unmount-Snapshot [-Name] <Chaîne> [[-Index] [<Int32>]] [[-Port] [<Chaîne>]]
Paramètres
Nom

Nom de l'hôte dont vous souhaitez exposer le cliché.

Index

Numéro d'index de cliché renvoyé par la commande Get-Snapshot.

Port (facultatif)

Port utilisé pour la connexion à l'hôte. Le port par défaut est 25000.

Exemple : Démontage d'un cliché

Unmount-Snapshot {97127d0b-f1c9-4db5-943d-96c39b712fe6} 1 
Résultat :
Snapshot {97127d0b-f1c9-4db5-943d-96c39b712fe6} unmounted










Commandes de modification

Cette section décrit les commandes CA ARCserve RHA PowerShell qui vous permettent de modifier les scénarios et groupes de scénarios.

Add-Dir : ajout de répertoires racines aux hôtes maître et de réplication

La commande Add-dir vous permet d'ajouter des répertoires racines aux hôtes maître et de réplication. Vous pouvez définir un même emplacement pour les répertoires racines des ordinateurs maître et de réplication. Vous pouvez également saisir deux chemins différents. Si vous ne saisissez pas un chemin différent pour l'ordinateur de réplication, ce sera par défaut le même que le chemin de l'ordinateur maître.

Syntaxe
Add-Dir [-Name] <Chaîne> [-MasterPath] <Chaîne> [[-ReplicaPath] [<Chaîne>]]  
Paramètres
Nom

Nom du scénario.

MasterPath

Chemin complet des répertoires racines sur l'ordinateur maître.

ReplicaPath (facultatif)

Chemin complet des répertoires racines sur le ou les ordinateurs de réplication. En l'absence de valeur saisie, le même chemin est utilisé pour les ordinateurs maître et de réplication.

Exemple : Ajout du même répertoire racine sur les ordinateurs maître et de réplication

add-dir "Serveur de fichiers 1" C:/Tools
Résultat :
Répertoire racine : C:/Tools ajouté

Add-Group : création d'un groupe de scénarios

La commande Add-Group vous permet de créer un nouveau groupe de scénarios.

Remarque : Si aucun scénario n'est attribué, les groupes de scénarios vides n'apparaissent pas sur la page de présentation.

Syntaxe
Add-Group [-Name] <Chaîne> 
Paramètres
Nom

Nom du nouveau groupe de scénarios.

Remarque : Saisissez un nom unique, car vous ne pouvez pas utiliser le même nom pour plusieurs groupes de scénarios. Si vous utilisez un nom existant pour le nouveau groupe, le système le modifie automatiquement.

Exemple : Création d'un nouveau groupe de scénarios

add-group "Scénarios de serveur de fichiers"
Résultat :
Groupe Scénarios de serveur de fichiers ajouté

Add-Master : ajout d'un hôte maître à un scénario

La commande Add-Master vous permet d'ajouter un hôte maître à un scénario donné. Lors de la définition d'un hôte maître, vous devez saisir son nom d'hôte. Vous pouvez également saisir l'adresse IP de l'ordinateur maître, mais ce paramètre n'est pas obligatoire.

Remarques :

Syntaxe
Add-Master [-Name] <Chaîne> [-Host] <Chaîne> [[-IP] [<Chaîne>]] 
Paramètres
Nom

Nom du scénario.

Hôte

Nom d'hôte du nouvel ordinateur maître.

IP (facultatif)

Adresse IP du nouvel ordinateur maître. Si aucune adresse IP n'est définie, le système la cherche par défaut en utilisant le nom d'hôte spécifié et utilise la première adresse IP qu'il trouve. C'est pourquoi, si l'hôte comporte plusieurs adresses IP, nous vous recommandons de saisir ici l'adresse IP à utiliser.

Exemple : Ajout d'un hôte maître à un scénario

add-master "Serveur de fichiers 1" 130.119.185.152
Résultat :
Maître 130.119.185.152 ajouté

Add-Replica : ajout d'un hôte de réplication à un scénario

La commande Add-Replica vous permet d'ajouter un hôte de réplication à un scénario donné. Lors de la définition d'un hôte de réplication, vous devez saisir son nom d'hôte et éventuellement son adresse IP. Ensuite, vous devez saisir son hôte parent, à savoir l'ordinateur maître ou un autre ordinateur de réplication.

Remarque : Vous pouvez saisir l'adresse IP comme nom d'hôte.

Lors de l'utilisation de délégations de sécurité des listes de contrôle d'accès, vous devez saisir les valeurs de trois paramètres supplémentaires : UserName, Password et DomainName.

Syntaxe
Add-Replica [-Name] <Chaîne> [-Host] <Chaîne> [[-IP] [<Chaîne>]] [-Parent] <Chaîne> [[-UserName] <Chaîne>] [[-Password] <Chaîne>] [[-DomainName] <Chaîne>]
Paramètres
Nom

Nom du scénario.

Hôte

Nom d'hôte du nouvel ordinateur de réplication.

IP (facultatif)

Adresse IP du nouvel ordinateur de réplication. Si aucune adresse IP n'est définie, le système la cherche par défaut en utilisant le nom d'hôte spécifié et utilise la première adresse IP qu'il trouve. C'est pourquoi, si l'hôte comporte plusieurs adresses IP, nous vous recommandons de saisir ici l'adresse IP à utiliser.

Parent

Hôte parent du nouvel hôte de réplication. Le parent peut être l'ordinateur maître ou un autre ordinateur de réplication en amont. Vous pouvez utiliser son nom d'hôte ou son adresse IP.

UserName ; Password ; DomainName (liste de contrôle d'accès uniquement)

Nom d'utilisateur, mot de passe et domaine d'un utilisateur, qui a le droit d'ajouter un nouvel hôte de réplication.

Exemple : Ajout d'un hôte de réplication à un scénario

add-replica "Serveur de fichiers 1" 130.119.185.153 -parent 130.119.185.152
Résultat :
Réplication 130.119.185.153 ajoutée

Add-Replicas : ajout de plusieurs hôtes de réplication à un scénario

La commande Add-Replicas vous permet d'ajouter plusieurs hôtes de réplication simultanément à un scénario donné. Pour ajouter plusieurs hôtes de réplication, vous devez créer un fichier texte qui contient les noms d'hôte et les adresses IP des hôtes. Lorsque vous utilisez cette commande, définissez d'abord le nom de scénario et l'hôte parent de tous les hôtes de réplication que vous souhaitez ajouter. Spécifiez ensuite le nom et le chemin du fichier qui contient les détails des nouveaux hôtes.

Syntaxe
Add-Replicas [-ScenarioName] <Chaîne> [-ParentHost] <Chaîne> [-FileName] <Chaîne>
Paramètres
ScenarioName

Nom du scénario.

ParentHost

Hôte parent du nouvel hôte de réplication. Le parent peut être l'ordinateur maître ou un autre ordinateur de réplication en amont. Vous pouvez utiliser son nom d'hôte ou son adresse IP.

Nom du fichier

Fichier texte qui contient les noms d'hôte et leurs adresses IP. Le texte doit être formaté comme suit.

N° nom d'hôte Adresse IP

QA95-W2K3-SQL1 *130.119.185.155

QA95-W2K3-EX2 *130.119.185.153

UserName ; Password ; DomainName (liste de contrôle d'accès uniquement)

Nom d'utilisateur, mot de passe et domaine d'un utilisateur qui a le droit d'ajouter de nouveaux hôtes de réplication.

Exemple : Ajout de plusieurs hôtes de réplication à un scénario

add-replicas "Exchange Server" QA95-W2K3-EX1 D:\New_Replica_Hosts.txt
Résultat :
130.119.185.151 QA95-W2K3-EX1
130.119.185.152 QA95-W2K3-EX2
2 réplications ont été ajoutées.

Add-Scenario : création d'un nouveau scénario

La commande Add-Scenario vous permet de créer un nouveau scénario. Lors de la création d'un nouveau scénario, vous devez définir les éléments ci-dessous.

Le nouveau scénario est créé sans hôtes, ni répertoires racines. Vous pouvez définir ces paramètres ultérieurement, à l'aide des commandes Add-Master, Add-Replica et Add-Dir.

Syntaxe
Add-Scenario [-Name] <Chaîne> [[-Group] [<Chaîne>]] [[-Application] [<Chaîne>]] [[-Type] [<Chaîne>]] [[-AR] [<Valeur_booléenne>] 
Paramètres
Nom

Nom du nouveau scénario.

Remarque : Saisissez un nom unique, car vous ne pouvez pas utiliser le même nom pour plusieurs scénarios. Si vous utilisez un nom existant pour le nouveau scénario, le système le modifie automatiquement.

Groupe (facultatif)

Nom du groupe de scénarios contenant le nouveau scénario.

Remarques :

  • Si vous ne saisissez pas de nom de groupe, le nouveau scénario est affecté au groupe Scénarios par défaut.
  • Vous pouvez créer ici un nouveau groupe de scénarios en saisissant un nouveau nom de groupe. Vous pouvez également créer un nouveau groupe de scénarios en utilisant la commande Add-Group.
Application

Type de serveur dont les données seront répliquées :

  • EX : Exchange
  • SQL : SQL Server
  • ORA : Oracle
  • IIS : serveur d'information Internet
  • FS : serveur de fichiers
Type

Type de solution :

  • DR : récupération après sinistre/réplication
  • HA : haute disponibilité
Récupération garantie

Réalisation ou non d'un test de récupération garantie de la possibilité de récupérer les données sur le serveur de réplication :

  • 0 : Non
  • 1 : Oui

Exemple : Création d'un nouveau scénario

add-scenario "Serveur de fichiers 1" "Scénarios de serveur de fichiers" FS DR 0
Résultat :
Scénario Serveur de fichiers 1 ajouté

Remove-Dir : suppression de répertoires racines des ordinateurs maître et de réplication

La commande Remove-Dir vous permet de supprimer des répertoires racines des hôtes maître et de réplication.

Remarque : Cette commande ne vous permet pas de supprimer un répertoire racine de l'ordinateur de réplication uniquement. Si vous supprimez les répertoires racines de l'ordinateur maître, les répertoires racines correspondants de l'ordinateur de réplication sont également supprimés.

Syntaxe
Remove-Dir [-Name] <Chaîne> [-MasterPath] <Chaîne> 
Paramètres
Nom

Nom du scénario.

MasterPath

Chemin des répertoires racines sur l'ordinateur maître.

Exemple : Suppression d'un répertoire racine des ordinateurs maître et de réplication

remove-dir "Serveur de fichiers 1" C:/Tools

Résultat :

Répertoire racine : C:/Tools supprimé

Remove-Group : suppression d'un groupe de scénarios

La commande Remove-Group vous permet de supprimer un groupe de scénarios donné.

Remarque : Vous pouvez uniquement supprimer un groupe de scénarios vide. Si vous souhaitez supprimer un groupe contenant des scénarios, vous devez au préalable supprimer les scénarios.

Syntaxe
Remove-Group [-Name] <Chaîne> 
Paramètres
Nom

Nom du groupe de scénarios que vous souhaitez supprimer.

Exemple : Suppression d'un groupe de scénarios

remove-group "nouveau groupe 1"
Résultat :
Groupe nouveau groupe 1 supprimé

Remove-Replica : suppression d'un hôte de réplication d'un scénario

La commande Remove-Replica vous permet de supprimer un hôte de réplication d'un scénario donné.

Syntaxe
Remove-Replica [-Name] <Chaîne> [-Host] <Chaîne> [-Parent] <Chaîne>
Paramètres
Nom

Nom du scénario.

Hôte

Nom de l'hôte de réplication que vous souhaitez supprimer.

Parent

Parent de l'hôte de réplication que vous souhaitez supprimer dans l'arborescence de réplication. Il peut s'agir de l'ordinateur maître ou d'un ordinateur de réplication en amont.

Exemple : Suppression d'un hôte de réplication d'un scénario

remove-replica "FS 1" 130.119.185.153 -parent 130.119.185.152
Résultat :
Réplication 130.119.185.153 supprimée   

Remove-Scenario : suppression d'un scénario

La commande Remove-Scenario vous permet de supprimer un scénario donné.

Remarque : Vous ne pouvez pas supprimer un scénario en cours d'exécution.

Syntaxe
Remove-Scenario [-Name] <Chaîne> 
Paramètres
Nom

Nom du scénario que vous souhaitez supprimer.

Exemple : Suppression d'un scénario

remove-scenario "Serveur de fichiers 2"
Résultat :
Scénario Serveur de fichiers 2 supprimé

Rename-Group : renommage d'un groupe de scénarios

La commande Rename-Group vous permet de modifier le nom d'un groupe de scénarios donné.

Syntaxe
Rename-Group [-Name] <Chaîne> [-NewName] <Chaîne> 
Paramètres
Nom

Nom actuel du groupe de scénarios.

NewName

Nouveau nom du groupe de scénarios.

Remarque : Saisissez un nom unique, car vous ne pouvez pas utiliser le même nom pour plusieurs groupes de scénarios. Si vous utilisez un nom existant pour le groupe de scénarios, le système le modifie automatiquement.

Exemple : Renommage d'un groupe de scénarios

rename-group Serveur "Scénarios Exchange Server"
Résultat :
Groupe Serveur renommé

Rename-Scenario : modification du nom d'un scénario

La commande Rename-Scenario vous permet de modifier le nom d'un scénario donné.

Remarque : Vous ne pouvez pas renommer un scénario en cours d'exécution. Pour modifier son nom, vous devez l'arrêter au préalable.

Syntaxe
Rename-Scenario [-Name] <Chaîne> [-NewName] <Chaîne> 
Paramètres
Nom

Nom actuel du scénario.

Nouveau nom :

Nouveau nom du scénario.

Exemple:

rename-scenario "Serveur de fichiers 1" "Serveur de fichiers"
Résultat :
Scénario Serveur de fichiers 1 renommé













Commandes permettant de modifier des scénarios en cours d'exécution

Vous pouvez désormais modifier certaines propriétés d'un scénario lors de son exécution. Cette section répertorie la syntaxe et les exemples de commandes qui s'appliquent pour la modification d'un scénario lors de son exécution.

Apply-AllPendingRuntmeChangeableScenarioProperties

La commande Apply-AllPendingRuntimeChangeableScenarioProperties permet d'appliquer toutes les modifications à tous les scénarios modifiés au moment de leur exécution.

Syntaxe
Apply-AllPendingRuntimeChangeableScenarioProperties
Paramètres

Aucun

Exemple

Supposons que vous avez modifié des propriétés dans plusieurs scénarios. Ces modifications sont toutes en attente. Pour les appliquer immédiatement, utilisez cette commande.

Apply-PendingRuntimeChangeableScenarioProperties

La commande PendingRuntimeChangeableScenarioProperties d'Appliquer permet d'appliquer toutes les modifications au scénario en cours d'exécution spécifié.

Syntaxe
Apply-PendingRuntimeChangeableScenarioProperties [Nom]
Paramètres

Nom : nom du scénario à modifier

Exemple

La commande suivante permet d'appliquer des modifications au scénario appelé FileServer :

Apply-PendingRuntimeChangeableScenarioProperties FileServer
Résultat :

Il en résulte une liste de propriétés et de leurs valeurs :

error_source : engine_verification_error

error_level: Error

host_index: 2

root_dir_index: 0

property_xpath: Scenario.ReplicationTree.ReplNode.ReplNode.SpecificReplicaProps. ReplicaScheduledTask.Suspend.SuspendScript.Path


Discard-AllPendingRuntimeChangeableScenarioProperties

La commande Discard-AllPendingRuntimeChangeableScenarioProperties permet d'annule toutes les modifications configurées pour tous les scénarios.

Syntaxe
Discard-AllPendingRuntimeChangeableScenarioProperties
Paramètres

Aucun

Discard-RuntimeChangeableScenarioProperties

La commande Discard-RuntimeChangeableScenarioProperties permet d'annuler toute modification apportée au scénario en cours d'exécution spécifié.

Syntaxe
Discard-RuntimeChangeableScenarioProperties [Nom]
Paramètres

Nom : il s'agit du nom du scénario en cours d'exécution pour lequel vous souhaitez annuler des modifications.

Exemple

Si vous avez apporté de nombreuses modifications à un scénario en cours d'exécution appelé FileServer et que vous détectez des problèmes, utilisez la commande suivante pour définir le scénario sur toutes les valeurs d'origine :

Discard-RuntimeChangeableScenarioProperties FileServer
Résultat :

Toutes les modifications apportées au scénario appelé FileServer sont redéfinies sur leurs valeurs d'origine.

Si vous souhaitez définir une seule propriété spécifique sur sa valeur d'origine, utilisez la commande Set-RuntimeChangeableScenarioProperties pour changer uniquement la propriété spécifiée pour le scénario en cours d'exécution. Notez que lorsque vous avez annulé des modifications, tous les enregistrements figurant dans la liste Get-AllPendingRuntimeChangeableScenarioProperties sont supprimés. L'exécution de la commande Apply-PendingRuntimeChangeableScenarioProperties entraîne un message d'avertissement indiquant que le scénario spécifié n'a pas été modifié au moment de son exécution.

Get-AllPendingRuntimeChangeableScenarioProperties

La commande Get-AllPendingRuntimeChangeableScenarioProperties permet de répertorier tous les scénarios changés lors de leur exécution.

Syntaxe
Get-AllPendingRuntimeChangeableScenarioProperties
Paramètres

Aucun

Exemple

La commande suivante permet de répertorier tous les scénarios changés lors de leur exécution.

Get-AllPendingRuntimeChangeableScenarioProperties
Résultat :

Il en résulte une liste de noms de scénarios.

Get-AllRuntimeChangeableScenarioProperties

La Get-AllRuntimeChangeableScenarioProperties permet de répertorier toutes les propriétés que vous pouvez changer lors de l'exécution d'un scénario.

Syntaxe
get-AllRuntimeChangeableScenarioProperties
Paramètres

Aucun

Exemple :

Le code suivant émet la commande permettant de répertorier toutes les propriétés modifiables et de rediriger les résultats dans un fichier texte.

Get-AllRuntimeChangeableScenarioProperties > d:\1.txt
Résultat :

Il en résulte un ensemble de propriétés modifiables au format Scénario/Maître/Réplication/Nom_propriété.

Get-RuntimeChangeableScenarioProperties

La commande Get-RuntimeChangeableScenarioProperties permet de rechercher toutes les propriétés que vous pouvez modifier lors de l'exécution d'un scénario spécifique. La commande renvoie une liste des propriétés que vous pouvez changer pour ce scénario. Associez des commandes de redirection d'E/S pour formater les résultats dans un fichier texte.

Syntaxe
Get-RuntimeChangeableScenarioProperties [Nom]
Paramètres

Nom : nom du scénario en cours d'exécution

Exemple :

La commande suivante permet de répertorier toutes les propriétés modifiables pour le scénario appelé Scénario FileServer 1 :

Get-RuntimeChangeableScenarioProperties FileServerScenario1
Résultat :

Property: False

Host: 10.0.0.0

Value: False

Index: 111

Category: Replica

Name: SpecificReplicaProps.Suspend.SuspendScript

Get-PendingRuntimeChangeableScenarioProperties

La commande Get-PendingRuntimeChangeableScenarioProperties permet de répertorier toutes les modifications apportées au scénario en cours d'exécution spécifié.

Syntaxe
Get-PendingRuntimeChangeableScenarioProperties [Nom]
Paramètres

Nom : nom du scénario en cours d'exécution

Exemple :

L'exemple suivant présente la liste de toutes les propriétés changées pour le scénario appelé FileServer :

Get-PendingRuntimeChangeableScenarioProperties FileServer
Résultat :

Il en résulte une liste de propriétés, de leurs valeurs d'origine et de leurs nouvelles valeurs.

Set-RuntimeChangeableScenarioProperty

La commande Set-RuntimeChangeableScenarioProperty permet de mettre à jour la valeur de la propriété spécifiée dans le scénario indiqué lors de son exécution.

Syntaxe
Set-RuntimeChangeableScenarioProperty [Nom] [Index] [Valeur] [Hôte]
Paramètres

Nom : nom du scénario en cours d'exécution pour lequel vous souhaitez modifier les propriétés.

Index : index ou nom de la propriété que vous voulez changer. Pour déterminer les noms appropriés, utilisez la commande Get-AllRuntimeChangeableScenarioProperties ou Get-RuntimeChangeableScenarioProperties. La valeur de l'index est générée en interne ; même pour deux scénarios de même type, une propriété identique peut avoir un index différent. Vérifiez que vous obtenez les index ou les noms appropriés.

Valeur : Nouveau paramètre pour la propriété spécifiée

Hôte : (Facultatif) Vous devez spécifier l'hôte uniquement pour les modifications de propriétés du serveur maître ou de réplication. Pour des propriétés génériques ou de haute disponibilité, cette valeur est facultative.

Exemple :

La commande suivante permet de mettre à jour l'argument de la propriété de script d'interruption en fonction de son nom :

Set-RuntimeChangeableScenarioProperty FileServer SpecificReplicaProps.Suspend.SuspendScript 456 -Host 10.0.0.1
Résultat :

Il en résulte une table contenant la propriété, sa valeur d'origine et la nouvelle valeur.

Test-RuntimeChangeableScenarioProperty

La commande Test-RuntimeChangeableScenarioProperty permet de confirmer si vous pouvez encore modifier la propriété spécifiée lors de l'exécution du scénario.

Syntaxe
Test-RuntimeChangeableScenarioProperty [Nom] [Index] [Hôte]
Paramètres

Nom : nom du scénario en cours d'exécution

Index : index ou nom de la propriété que vous voulez tester

Hôte : facultatif

Exemple

La commande suivante permet de tester la propriété dont l'index est 113 pour un scénario en cours d'exécution appelé FileServer.

Test-RuntimeChangeableScenarioProperty FileServer 113 -host 10.0.0.3
Résultat :

Il en résulte la valeur true ou false pour l'index ou le nom de propriété spécifié.

Commandes de surveillance

Cette section décrit les commandes CA ARCserve RHA PowerShell qui vous permettent de surveiller les processus de récupération après sinistre et de haute disponibilité.

Get-Dirs : liste de tous les répertoires racines d'un scénario

La commande Get-Dirs vous permet de répertorier tous les répertoires racines d'un scénario donné.

Syntaxe
Get-Dirs [-Name] <Chaîne> 
Paramètres
Nom

Nom du scénario.

Exemple : Liste des répertoires racines d'un scénario donné

get-dirs "Serveur de fichiers 1"
Résultat :
ID       : 2721474912
Scénario : Serveur de fichiers 1
Ordinateur maître   : 192.168.1.152
Chemin   : C:/Tools
BdD      : False

Get-Events : liste de tous les événements d'un scénario

La commande Get-Events affiche la liste des événements de réplication d'un scénario donné. La liste des événements peut contenir des événements d'information, d'avertissement ou d'erreur. Les informations affichées sont composées de l'ID, de la date et de l'heure de l'événement, du nom du scénario, de la sévérité de l'événement et du message de l'événement.

Syntaxe
Get-Events [-Name] <Chaîne> 
Paramètres
Nom

Nom du scénario dont vous souhaitez afficher les événements.

Exemple : Liste des événements d'un scénario donné dans un tableau au format autodimensionné

get-events "File Server 1" | FT -auto
Résultat :
ID      Heure                  Scénario      Sévérité    Message
--      ----                  --------      --------    -------
SM00165 10/28/2008 6:02:52 PM File Server 1 Significant Connected to...
SR00014 10/30/2008 7:17:31 PM File Server 1 Significant Starting...
SR00139 10/30/2008 7:17:35 PM File Server 1 Significant Starting File...
IR00119 10/30/2008 7:18:16 PM File Server 1 Info        Root directory...
SR00120 10/30/2008 7:18:16 PM File Server 1 Significant Synchronization...
IM00405 10/30/2008 7:15:06 PM File Server 1 Info        Posting... 
SR00202 10/30/2008 7:18:21 PM File Server 1 Significant All modifications...
SR00096 11/3/2008 6:47:40 PM  File Server 1 Significant Stopping scenario...

Get-Group : liste des groupes portant un nom donné

La commande Get-Group vous permet de répertorier tous les groupes de scénarios portant un nom donné. Pour afficher cette liste, vous devez saisir le nom que vous recherchez.

De plus, cette commande vous permet de répertorier tous les groupes de scénarios existants. Pour répertorier tous les groupes de scénarios, saisissez simplement la commande, sans indiquer de nom de scénario.

Syntaxe
Get-group [[-GroupName] [<Chaîne>]]
Paramètres
Nom

Nom du groupe de scénarios.

Remarque : Vous pouvez utiliser les caractères génériques "*" ou "?" dans le nom du groupe de scénarios.

Exemple : Liste de tous les groupes de scénarios portant un nom donné

get-group *Serveur*
Résultat :
Scénarios de serveur de fichiers 2
Scénarios de serveur de fichiers 1
Scénarios du serveur Exchange
Scénarios de serveur de fichiers

Get-Hosts : liste de tous les hôtes d'un scénario

La commande Get-Hosts vous permet de répertorier tous les hôtes d'un scénario donné.

Syntaxe
Get-Hosts [-Name] <Chaîne> 
Paramètres
Nom

Nom du scénario.

Exemple : Liste des hôtes d'un scénario donné dans un tableau au format autodimensionné

Get-Hosts "File Server 1" |FT -auto
Résultat :
Scénario      Nom          Rôle    Parent         Etat   IP            Port
--------      ----          ----    ------         -----   --            ----
File Server 1 192.168.1.152 Master  --             Running 192.168.1.152 25000
File Server 1 192.168.1.153 Replica 1192.168.1.152 Running 192.168.1.153 25000

Get-Scenario : liste des scénarios portant un nom donné

La commande Get-Scenario vous permet de répertorier tous les scénarios portant un nom donné. Pour afficher cette liste, vous devez saisir le nom que vous recherchez.

De plus, cette commande vous permet de répertorier tous les scénarios existants. Pour répertorier tous les scénarios, saisissez simplement la commande, sans indiquer de nom de scénario.

Syntaxe
Get-Scenario [[-Name] [<Chaîne>]] 
Paramètres
Nom

Nom du scénario.

Remarque : Vous pouvez utiliser les caractères génériques "*" ou "?" dans le nom de scénario.

Exemple: Liste de tous les scénarios portant un nom donné dans un tableau au format autodimensionné

get-scenario File* |FT -auto
Résultat :
ID         Groupe     Nom          Type       Ordinateur maître         Etat   Synchronisation Récupération assurée
--         -----     ----          ----       ------         -----   ---- --
1123633852 Scenarios FileServer    FileServer                Unknown File False
1123633468 Scenarios File Server 1 FileServer 192.168.1.153  Stopped File False

Get-Snapshot : affichage des clichés VSS d'un hôte de réplication

La commande Get-Snapshot vous permet d'afficher tous les clichés VSS d'un hôte de réplication donné.

Syntaxe
Get-Snapshot [-Name] <Chaîne> [[-Port] <Chaîne>]
Paramètres
Nom

Nom de l'hôte tel qu'il apparaît dans le scénario.

Port (facultatif)

Port de connexion à l'hôte. Le numéro du port par défaut est 25000.

Exemple : Affichage de tous les clichés VSS d'un hôte de réplication donné dans un tableau au format autodimensionné

Get-Snapshot 130.119.173.7 |FT -auto
Résultat :
Index Cliché        Création               Exposé Monté     Lecteur Scénario
----- --------        -------               ------- -------     ----- --------
0     {4f2bb053-5f2d} 11/18/2008 4:03:09 PM False   Not Mounted C:/   FileServer
1     {bcbdda2b-6165} 11/18/2008 4:06:00 PM False   Not Mounted C:/   FileServer
2     {c1f206be-2ad0} 11/18/2008 4:07:17 PM False   Not Mounted C:/   FileServer

Get-State : liste de tous les scénarios définis pour un hôte donné

La commande Get-State vous permet de répertorier tous les scénarios définis pour un hôte donné, ainsi que leurs détails et leurs états.

Syntaxe
Get-State [-Name] <Chaîne> 
Paramètres
Nom

Nom de l'hôte.

Exemple:

get-state 130.119.185.152
Résultat :
ID       : 2505374864
Groupe : Scénarios FS
Nom    : FS 1
Type   : FileServer
Maître : 130.119.185.152
Etat  : En cours d'exécution
Sync   : Fichier
Récupération garantie : False

ID       : 2721467841
Groupe : Scénarios de serveur de fichiers
Nom    : Serveur de fichiers 1
Type   : FileServer
Maître : 130.119.185.152
Etat   : Arrêté
Sync   : Fichier
Récupération garantie : False

Get-Stats : affichage des statistiques de réplication d'un scénario

La commande Get-Stats vous permet d'afficher les statistiques d'un scénario par hôte au cours d'une exécution.

Syntaxe
Get-Stats [-Name] <Chaîne> 
Paramètres
Nom

Nom du scénario.

Exemple : Affichage des statistiques de réplication d'un scénario donné au cours d'une exécution

get-stats "Serveur de fichiers 1"
Résultat :
Scénario    : Serveur de fichiers 1
Nom        : 192.168.1.152
Rôle        : Maître
Spool_Size  : 0
Sync_Files  : 345
Sync_MBytes : 86
Rep_MBytes  : 0

Scénario    : Serveur de fichiers 1
Nom        : 192.168.1.153
Rôle        : Ordinateur de réplication
Spool_Size  : 0
Sync_Files  : 345
Sync_MBytes : 86
Rep_MBytes  : 0 

Commandes de gestion des utilisateurs

Cette section décrit les commandes CA ARCserve RHA PowerShell qui vous permettent de surveiller et de gérer les groupes d'utilisateurs et les utilisateurs pour le service de contrôle utilisant les listes de contrôle d'accès.

Remarque : Une licence spéciale est requise pour l'utilisation des commandes de liste de contrôle d'accès.

Get-SuperUserGroup : affichage du nom du groupe de superutilisateurs

La commande Get-SuperUserGroup vous permet d'afficher le nom du groupe de superutilisateurs du service de contrôle connecté.

Syntaxe
Get-SuperUserGroup

Remarque : Cette commande n'a pas de paramètres.

Exemple : Affichage du nom du groupe de superutilisateurs

Get-SuperUserGroup
Résultat :
QA95-W2K3-SQL\\CA XOsoft Users

Set-SuperUserGroup : modification du groupe de superutilisateurs

La commande Set-SuperUserGroup vous permet de modifier le groupe de superutilisateurs.

Syntaxe
Set-SuperUserGroup [-GroupName] <Chaîne>
Paramètres
GroupName

Nom du nouveau groupe de superutilisateurs

Exemple : Modification du groupe de superutilisateurs.

Set-SuperUserGroup Administrators
Résultat :
Le groupe de superutilisateurs a été défini.

Get-Users : liste de tous les utilisateurs du groupe de superutilisateurs

La commande Get-Users vous permet de répertorier tous les utilisateurs qui appartiennent au groupe de superutilisateurs.

Syntaxe
get-users 

Remarque : Cette commande n'a pas de paramètres.

Exemple : Liste de tous les utilisateurs appartenant au groupe de superutilisateurs

get-users
Résultat :
QA95-W2K3\Administrator
QA95-W2K3-SQL\User2
QA95-W2K3-SQL\User1

Get-ScenarioUsers : liste de tous les utilisateurs disposant de droits sur un scénario

La commande Get-ScenarioUsers vous permet de répertorier tous les utilisateurs disposant de droits sur un scénario donné.

Syntaxe

get-ScenarioUsers [-ScenarioName] <Chaîne>

Paramètres
ScenarioName

Nom du scénario.

Exemple : Liste de tous les utilisateurs disposant de droits sur un scénario donné

Get-ScenarioUsers "File Server"
Résultat :
nom
----
QA95-W2K3-SQL\User2
QA95-W2K3-SQL\User1

Set-ScenarioUser : attribution de droits d'utilisateur sur un scénario

La commande Set-ScenarioUser vous permet d'attribuer à un utilisateur certains droits sur un scénario spécifique.

Syntaxe
Set-ScenarioUser [-Name] <Chaîne> [-User] <Chaîne> [-Right] <Chaîne> 
Paramètres
Nom

Nom du scénario.

Utilisateur

Nom complet de l'utilisateur

Droite

Type de droits que l'utilisateur aura sur le scénario. Choisissez l'une des valeurs suivantes :

A = Administration

C = Contrôle

V = Visualisation uniquement

Exemple : attribution de droits de contrôle à un utilisateur sur un scénario donné

Set-ScenarioUser "File Server" QA95-W2K3-SQL\User2 C
Résultat :
Les droits de l'utilisateur ont été définis.

Remove-ScenarioUser : annulation des droits d'utilisateur sur un scénario

La commande Remove-ScenarioUser vous permet d'annuler les droits d'un utilisateur sur un scénario donné.

Syntaxe
Remove-ScenarioUser [-Name] <Chaîne> [-User] <Chaîne>
Paramètres
ScenarioName

Nom du scénario.

Nom d'utilisateur

Nom de l'utilisateur.

Exemple : Annulation des droits d'un utilisateur sur un scénario donné

Remove-ScenarioUser "File Server" QA95-W2K3-SQL\User2
Résultat :
L'utilisateur a été supprimé.