Vorheriges Thema: Verwenden von CA ARCserve RHA-PowerShell-Befehlen

Resume-Scenario - Wiederaufnehmen der Replikation auf einem angehaltenen Replikatserver

Mit dem Befehl Resume-Scenario können Sie den Replikationsprozess auf einem angehaltenen Replikat-Host wieder aufnehmen. Nachdem die Replikation wieder aufgenommen wurde, werden die gesammelten Änderungen übermittelt und übernommen, ohne dass eine vollständige Resynchronisation der Daten erforderlich ist.

Syntax
Resume-Scenario [-Name] <Zeichenfolge> [-Host] <Zeichenfolge>
Parameter
Name

Der Szenarioname.

Host

Der Name des angehaltenen Replikatservers, den Sie wieder aufnehmen möchten.

Beispiel: Wiederaufnehmen der Replikation auf einem angehaltenen Replikatserver

resume-scenario "Dateiserver 1" 192.168.1.153

Ergebnis:

Szenario Dateiserver 1 wieder aufgenommen auf 192.168.1.153

Run-Scenario - Starten von Szenarien

Mit Hilfe des Befehls Run-Scenario können Sie eines oder mehrere Szenarien starten.

Syntax
Run-Scenario [-Name] <Zeichenfolge> [-Modus] <Zeichenfolge> [-Ignorieren] <Boolesch> 
Parameter
Name

Der Szenarioname. Sie können mehrere Szenarionamen eingeben, indem Sie den Befehl get-scenario verwenden.

Modus

Der Synchronisationsmodus. Geben Sie eine der folgenden Angaben ein:

B=Binary (Binär)

F=File (Datei)

Ignorieren

Ignorieren von Dateien mit gleichem Namen und gleicher Größe beim Datenvergleich. Geben Sie eine der folgenden Angaben ein:

1=Ja

0= Nein

Hinweise:

Beispiele: Starten von Szenarien

run-scenario "Dateiserver 1" F 1

Ergebnis:

Szenario Dateiserver 1 wird gestartet...

Run-Assessment - Ausführen von Szenarien im Bewertungsmodus

Mit Hilfe des Befehls Run-Assessment können Sie die genaue, für die Replikation erforderliche Bandbreite und das erforderliche Komprimierungsverhältnis zu ermitteln, ohne die Daten tatsächlich zu replizieren. Wenn Sie diesen Befehl ausführen, werden statistische Daten gesammelt, ohne dass eine Replikation durchgeführt wird. Sobald die Bewertung beendet wird, wird ein Bericht erstellt.

Wichtig! Denken Sie daran, das Szenario, das im Bewertungsmodus ausgeführt wird, mit dem Befehl Stop-Scenario zu beenden, wenn der zu bewertende Abschnitt vorüber ist.

Hinweis: Um den erstellten Bewertungsbericht anzuzeigen, öffnen Sie in der Übersichtsseite das "Report-Center" und wählen den gewünschten Bericht aus.

Syntax
Run-Assessment [-Name] <Zeichenfolge>
Parameter
Name

Der Szenarioname.

Beispiel: Ausführen von Szenarien im Bewertungsmodus

run-assessment "Dateiserver 1"

Ergebnis:

Szenario Dateiserver 1 erfolgreich ausgeführt

Set-Bookmark - Setzen von Rücklaufmarkierungen

Eine Markierung ist ein manuell festgelegter Checkpoint, der einen Status markiert, zu dem Sie eventuell mit Hilfe eines Datenrücklaufs zurückkehren möchten. Mit dem Befehl Set-Bookmark können Sie für ein vorgegebenes Szenario eine Markierung setzen. Markierungen werden in Echtzeit gesetzt und nicht für vergangene Ereignisse. Markierungen sollten vor jeder Aktivität gesetzt werden, die zu instabilen Daten führen kann.

Hinweise:

Syntax
Set-Bookmark [-Name] <Zeichenfolge> [[-Meldung] <Zeichenfolge>]
Parameter
Name

Der Name des Szenarios.

Meldung (optional)

Der Name der Markierung. Der Standardname beinhaltet das Datum und die Uhrzeit, zu der die Markierung gesetzt wurde.

Hinweis: Wir empfehlen, dass Sie der Markierung einen sinnvollen Namen geben, der Ihnen später dabei helfen wird, sie wiederzuerkennen.

Beispiel: Setzen von Rücklaufmarkierungen

set-bookmark "Dateiserver 1" Backup1

Ergebnis:

Szenario Dateiserver 1: Rücklaufmarkierung erfolgreich gesetzt

Stop-Scenario: Beenden von Szenarien

Mit Hilfe des Befehls Stop-Scenario können Sie eines oder mehrere Szenarien beenden.

Hinweis: Verwenden Sie die Befehle Get-Scenario und Get-Events, um zu überprüfen, ob der Vorgang erfolgreich abgeschlossen wurde.

Syntax
Stop-Scenario [-Name] <Zeichenfolge>  
Parameter
Name

Der Name des Szenarios, das Sie beenden möchten. Sie können mehrere Szenarionamen eingeben, indem Sie den Befehl get-scenario verwenden.

Beispiel: Beenden von Szenarien

stop-scenario "Dateiserver 1"

Ergebnis:

Szenario Dateiserver 1 wurde beendet

Suspend-IsAliveCheck - "Ist aktiv"-Überprüfung (IsAlive) eines Szenarios in Ausführung unterbrechen

Der Befehl Suspend-IsAliveCheck lässt Sie die für ein bestimmtes ausgeführtes HA-Szenario durchgeführte "Ist aktiv"-Überprüfung manuell unterbrechen.

Syntax
Suspend-IsAliveCheck [-Szenarioname] <Zeichenfolge>  
Parameter
SzenarioName

Der Szenarioname.

Beispiel: IsAlive-Überprüfung von SQLscenario unterbrechen

Suspend-IsAliveCheck SQLscenario

Ergebnis:

Periodische "Ist aktiv"-Überprüfung (IsAlive) von SQLscenario wird unterbrochen.

Suspend-Scenario - Unterbrechen von Aktualisierungen auf einem Replikat

Mit Hilfe des Befehls Suspend-Scenario können Sie die Übermittlung von Daten an einen angehaltenen Replikatserver vorübergehend unterbrechen. Während der Unterbrechung werden Änderungen bis zur Wiederaufnahme der Replikation in einem Spool erfasst, so dass keine Resynchronisation erforderlich ist.

Wichtig! Während der Unterbrechung dürfen keinerlei Vorgänge auf dem Replikatserver durchgeführt werden, durch die die Daten in irgendeiner Weise geändert werden. Hierzu gehört auch das Starten von Anwendungen wie Exchange Server, SQL Server oder Oracle. Falls Sie Programme starten müssen, durch die Daten auf dem Replikat geändert werden, können Sie die Option Assured Recovery verwenden.

Hinweise:

Syntax
Suspend-Scenario [-Name] <Zeichenfolge> [-Host] <Zeichenfolge> 
Parameter
Name

Der Szenarioname.

Host

Der Replikat-Host, den Sie anhalten möchten.

Beispiel: Unterbrechen von Aktualisierungen auf einem Replikat

suspend-scenario "Dateiserver 1" 192.168.1.153

Ergebnis:

Szenario Dateiserver 1 Unterbrochen auf 192.168.1.153

Switchover-Scenario: Durchführen eines Switchovers

Mit Hilfe des Befehls Switchover-Scenario können Sie den Switchover-Vorgang für ein vorgegebenes HA-Szenario starten. Verwenden Sie den Befehl Switchover-Scenario erneut, um ein Switchback der Rollen zwischen dem Master und dem Replikat durchzuführen.

Syntax
Switchover-Scenario [-Name] <Zeichenfolge> 
Parameter
Name

Der Szenarioname.

Beispiel: Durchführen eines Switchovers

Switchover-Scenario "SQL Server 1"
Ergebnis
Szenario SQL Server 1 wechselt zu 192.168.1.153
Fertig

Sync-Scenario - Initiieren einer Synchronisation

Mit Hilfe des Befehls Sync-Scenario können Sie den Master und das Replikat eines bestimmten Szenarios synchronisieren. Sie können die Synchronisation jederzeit unabhängig vom Ausführungsstatus der Replikation manuell starten.

Syntax
Sync-Scenario [-Name] <Zeichenfolge> [-Modus] <Zeichenfolge> [-Ignorieren] <Boolesch> 
Parameter
Name

Der Szenarioname. Sie können mehrere Szenarionamen eingeben, indem Sie den Befehl get-scenario verwenden.

Modus

Der Synchronisationsmodus. Geben Sie eine der folgenden Angaben ein:

B=Binary (Binär)

F=File (Datei)

Ignorieren

Ignorieren von Dateien mit gleichem Namen und gleicher Größe beim Datenvergleich. Geben Sie eine der folgenden Angaben ein:

1=Ja

0= Nein

Beispiel: Initiieren einer Synchronisation

sync-scenario "Dateiserver 1" F 1

Ergebnis:

Synchronisation wird ausgeführt für Szenario FS 1...
Fertig

Test-Integrity: Durchführen eines Integritätstestes für Assured Recovery

Mit dem Befehl Test-Integrity können Sie einen automatischen Integritätstest für Assured Recovery auf einem Replikat-Host aktivieren.

Hinweise:

Syntax
Test-Integrity [-Name] <Zeichenfolge> [-Host] <Zeichenfolge>
Parameter
Name

Der Name des Szenarios.

Host

Die IP-Adresse oder der Hostname des Replikat-Hosts, den Sie testen möchten.

Beispiel: Durchführen des Integritätstest für Assured Recovery

Test-Integrity "Exchange Server 1" 192.168.1.153
Ergebnis
Integritätstest für Assured Recovery gestartet am 192.168.1.153
Fertig
Integritätstest für Assured Recovery abgeschlossen am 192.168.1.153

Unmount-Snapshot: Entladen von Snapshots

Mit dem Befehl Unmount-Snapshot können Sie einen angezeigten Snapshot wieder freigeben, ohne dass der Snapshot selbst gelöscht wird. Die Snapshots werden nach wie vor angezeigt, es werden jedoch keine Bereitstellungspunkte mehr verwendet.

Syntax
Unmount-Snapshot [-Name] <Zeichenfolge> [[-Index] [<Int32>]] [[-Port] [<Zeichenfolge>]]
Parameter
Name

Der Name des Hosts, dessen Snapshot Sie anzeigen möchten.

Index

Die Indexnummer des Snapshot, wie vom Befehl Get-Snapshot zurückgegeben.

Port (optional)

Der Port, der für die Verbindung mit dem vorgegebenen Host verwendet wird. Die standardmäßige Port-Nummer lautet 25000.

Beispiel: Entladen eines Snapshots

Unmount-Snapshot {97127d0b-f1c9-4db5-943d-96c39b712fe6} 1 
Ergebnis
Snapshot {97127d0b-f1c9-4db5-943d-96c39b712fe6} entladen










Bearbeiten von Befehlen

In diesem Abschnitt werden CA ARCserve RHA-PowerShell-Befehle beschrieben, mit denen Sie Szenarien und Szenariogruppen bearbeiten können.

Add-Dir: Hinzufügen von Stammverzeichnissen zum Master- und zum Replikat-Host

Mit Hilfe des Befehls Add-dir können Sie dem Master- und dem Replikat-Host Stammverzeichnisse hinzufügen. Sie können für den Master und das Replikat denselben Stammverzeichnispfad definieren oder zwei verschiedene Pfade eingeben. Wenn Sie für das Replikat keinen anderen Pfad eingeben, ist dieser standardmäßig derselbe wie der Masterpfad.

Syntax
Add-Dir [-Name] <Zeichenfolge> [-MasterPfad] <Zeichenfolge> [[-ReplikatPfad] [<Zeichenfolge>]]  
Parameter
Name

Der Szenarioname.

MasterPfad

Der vollständige Pfad der Stammverzeichnisse auf dem Master.

ReplikatPfad (Optional)

Der vollständige Pfad der Stammverzeichnisse auf dem Replikat/den Replikaten. Wird kein Wert angegeben, wird derselbe Pfad für den Master und das Replikat verwendet.

Beispiel: Hinzufügen desselben Stammverzeichnisses zum Master und zum Replikat

add-dir "Dateiserver 1" C:/Tools
Ergebnis
Stammverzeichnis: C:/Tools erfolgreich hinzugefügt

Add-Group - Erstellen von Szenariogruppen

Mit Hilfe des Befehls Add-Group können Sie neue Szenariogruppen erstellen.

Hinweis: Wenn kein Szenario zugewiesen ist, werden in der Übersicht keine leeren Szenariogruppen angezeigt.

Syntax
Add-Group [-Name] <Zeichenfolge> 
Parameter
Name

Der Name der neuen Szenariogruppe.

Hinweis: Geben Sie einen eindeutigen Namen ein, da Sie denselben Namen nicht für mehrere Szenariogruppen verwenden können. Wenn Sie für die neue Gruppe einen bestehenden Namen verwenden, wird dieser automatisch durch das System geändert.

Beispiel: Erstellen neuer Szenariogruppen

add-group "Dateiserver-Szenarien"
Ergebnis
Gruppen-Dateiserver-Szenarien erfolgreich hinzugefügt

Add-Master - Hinzufügen eines Master-Hosts zu einem Szenario

Mit Hilfe des Befehls Add-Master können Sie einen Master-Host zu einem Szenario hinzufügen. Wenn Sie einen Master-Host definieren, müssen Sie seinen Hostnamen eingeben. Sie können darüber hinaus auch die Master-IP-Adresse eingeben, dieser Parameter ist jedoch nicht unbedingt erforderlich.

Hinweise:

Syntax
Add-Master [-Name] <Zeichenfolge> [-Host] <Zeichenfolge> [[-IP-Adresse] [<Zeichenfolge>]] 
Parameter
Name

Der Name des Szenarios.

Host

Der Hostname des neuen Masters.

IP-Adresse (optional)

Die IP-Adresse des neuen Masters. Wenn keine IP-Adresse definiert ist, sucht das System diese standardmäßig, indem es den angegebenen Hostnamen verwendet. Es verwendet dann die erste IP-Adresse, die es findet. Aus diesem Grund empfiehlt es sich, die IP-Adresse, die Sie verwenden möchten, hier einzutragen, wenn der Host über mehrere IP-Adressen verfügt.

Beispiel: Hinzufügen eines Master-Hosts zu einem Szenario

add-master "Dateiserver 1" 130.119.185.152
Ergebnis
Master 130.119.185.152 erfolgreich hinzugefügt

Add-Replica - Hinzufügen eines Replikat-Hosts zu einem Szenario

Mit Hilfe des Befehls Add-Replica können Sie einen Master-Host zu einem Szenario hinzufügen. Wenn Sie einen Replikat-Host definieren, müssen Sie seinen Hostnamen und optional auch seine IP-Adresse eingeben. Dann müssen Sie seinen übergeordneten Host eingeben. Dieser kann entweder im Master oder in einem anderen Replikat bestehen.

Hinweis: Sie können als Hostname die IP-Adresse eingeben.

Wenn Sie ACL-Sicherheitsdelegationen verwenden, müssen Sie die Werte von drei zusätzlichen Parametern eingeben: Benutzername, Kennwort und Domänenname.

Syntax
Add-Replica [-Name] <Zeichenfolge> [-Host] <Zeichenfolge> [[-IP-Adresse] [<Zeichenfolge>]] [-Übergeordnet] <Zeichenfolge> [[-Benutzername] <Zeichenfolge>] [[-Kennwort] <Zeichenfolge>] [[-Domänenname] <Zeichenfolge>]
Parameter
Name

Der Name des Szenarios.

Host

Der Hostname des neuen Replikats.

IP-Adresse (optional)

Die IP-Adresse des neuen Replikats. Wenn keine IP-Adresse definiert ist, sucht das System diese standardmäßig, indem es den angegebenen Hostnamen verwendet. Es verwendet dann die erste IP-Adresse, die es findet. Aus diesem Grund empfiehlt es sich, die IP-Adresse, die Sie verwenden möchten, hier einzutragen, wenn der Host über mehrere IP-Adressen verfügt.

Überordnung

Der übergeordnete Host des neuen Replikat-Hosts. Der übergeordnete Host kann entweder der Master oder ein Upstream-Replikat sein, und Sie können entweder seinen Hostnamen oder die IP-Adresse verwenden.

Benutzername, Kennwort, Domänenname (nur ACL)

Der Benutzername, das Kennwort und die Domäne eines Benutzers, der berechtigt ist, einen neuen Replikat-Host hinzuzufügen.

Beispiel: Hinzufügen eines Replikat-Hosts zu einem Szenario

add-replica "Dateiserver 1" 130.119.185.153 -übergeordnet 130.119.185.152
Ergebnis
Replikat 130.119.185.153 erfolgreich hinzugefügt

Add-Replicas: Hinzufügen mehrerer Replikat-Hosts zu einem Szenario

Mit Hilfe des Befehls Add-Replicas können Sie einem Szenario gleichzeitig mehrere Replikat-Hosts hinzufügen. Um mehrere Replikat-Hosts hinzufügen zu können, müssen Sie eine Textdatei erstellen, die die Hostnamen und IP-Adressen der Hosts enthält. Wenn Sie den Befehl verwenden, definieren Sie zuerst den Szenarionamen und den übergeordneten Host aller Replikat-Hosts, die Sie hinzufügen möchten. Geben Sie anschließend den Namen und den Pfad der Datei an, die die Details der neuen Hosts enthält.

Syntax
Add-Replicas [-Szenarioname] <Zeichenfolge> [-ÜbergeordneterHost] <Zeichenfolge> [-Dateiname] <Zeichenfolge>
Parameter
Szenarioname

Der Name des Szenarios.

ÜbergeordneterHost

Der übergeordnete Host des neuen Replikat-Hosts. Der übergeordnete Host kann entweder der Master oder ein Upstream-Replikat sein, und Sie können entweder seinen Hostnamen oder die IP-Adresse verwenden.

Dateiname

Eine Textdatei, die die Hostnamen und deren IP-Adressen enthält. Der Text sollte folgendermaßen formatiert sein:

#Hostname IP-Adresse

QA95-W2K3-SQL1 *130,119.185,155

QA95-W2K3-EX2 *130,119.185,153

Benutzername, Kennwort, Domänenname (nur ACL)

Der Benutzername, das Kennwort und die Domäne eines Benutzers, der berechtigt ist, neue Replikat-Hosts hinzuzufügen.

Beispiel: Hinzufügen mehrerer Replikat-Hosts zu einem Szenario

add-replicas "Exchange Server" QA95-W2K3-EX1 D:\New_Replica_Hosts.txt
Ergebnis
130,119.185,151 QA95-W2K3-EX1
130,119.185,152 QA95-W2K3-EX2
2 Replikate wurden hinzugefügt.

Add-Scenario - Erstellen neuer Szenarien

Mit Hilfe des Befehls Add-Scenario können Sie neue Szenariogruppen erstellen. Bei der Erstellung eines neuen Szenarios müssen Sie Folgendes definieren:

Das neue Szenario wird ohne Hosts und Stammverzeichnisse erstellt. Diese Parameter definieren Sie zu einem späteren Zeitpunkt über die Befehle Add-Master, Add-Replica und Add-Dir.

Syntax
Add-Scenario [-Name] <Zeichenfolge> [[-Gruppe] [<Zeichenfolge>]] [[-Anwendung] [<Zeichenfolge>]] [[-Typ] [<Zeichenfolge>]] [[-AR] [<Boolesch>] 
Parameter
Name

Der Name des neuen Szenarios.

Hinweis: Geben Sie einen eindeutigen Namen ein, da Sie denselben Namen nicht für mehrere Szenarien verwenden können. Wenn Sie für ein neues Szenario einen bestehenden Namen verwenden, wird dieser automatisch durch das System geändert.

Gruppe (optional)

Der Name der Szenariogruppe, in der das neue Szenario enthalten ist.

Hinweise:

  • Wenn Sie keinen Gruppennamen eingeben, wird das neue Szenario der Standardgruppe Szenarien zugewiesen.
  • Sie können hier eine neue Szenariogruppe erstellen, indem Sie einen neuen Gruppennamen eingeben. Sie können eine neue Szenariogruppe auch erstellen, indem Sie den Befehl Add-Group verwenden.
Anwendung

Der Servertyp, dessen Daten repliziert werden:

  • EX - Exchange
  • SQL - SQL Server
  • ORA - Oracle
  • IIS - Internet Information Server
  • FS - File Server (Dateiserver)
Typ

Die Art der Lösung:

  • DR - Replikation/Disaster Recovery
  • HA - High Availability
AR

Ob ein Assured Recovery-Test der Wiederherstellbarkeit der Daten auf dem Replikatserver durchgeführt werden soll:

  • 0 - Nein
  • 1 - Ja

Beispiel: Erstellen neuer Szenarien

add-scenario "Dateiserver 1" "Dateiserver-Szenarien" FS DR 0
Ergebnis
Szenario Dateiserver 1 erfolgreich hinzugefügt

Remove-Dir - Entfernen von Stammverzeichnissen vom Master und vom Replikat

Mit Hilfe des Befehls Remove-Dir können Sie Stammverzeichnisse vom Master- und vom Replikat-Host entfernen.

Hinweis: Mit diesem Befehl ist es nicht möglich, ein Stammverzeichnis lediglich vom Replikat-Host zu entfernen. Wenn Sie Master-Stammverzeichnisse entfernen, werden die entsprechenden Replikat-Stammverzeichnisse ebenfalls entfernt.

Syntax
Remove-Dir [-Name] <Zeichenfolge> [-MasterPfad] <Zeichenfolge> 
Parameter
Name

Der Name des Szenarios.

MasterPfad

Der Stammverzeichnispfad auf dem Master.

Beispiel: Entfernen von Stammverzeichnissen vom Master und vom Replikat

remove-dir "Dateiserver 1" C:/Tools

Ergebnis:

Stammverzeichnis: C:/Tools entfernt

Remove-Group: Löschen von Szenariogruppen

Mit Hilfe des Befehls Remove-Group können Sie eine vorgegebene Szenariogruppe löschen.

Hinweis: Sie können lediglich leere Szenariogruppen entfernen. Wenn Sie eine Gruppe entfernen möchten, die Szenarien enthält, müssen Sie zunächst die Szenarien entfernen.

Syntax
Remove-Group [-Name] <Zeichenfolge> 
Parameter
Name

Der Name der Szenariogruppe, die Sie löschen möchten.

Beispiel: Löschen von Szenariogruppen

remove-group "neue Gruppe 1"
Ergebnis
Gruppe neue Gruppe 1 entfernt

Remove-Replica - Entfernen eines Replikat-Hosts von einem Szenario

Mit Hilfe des Befehls Remove-Replica können Sie einen Master-Host zu einem Szenario hinzufügen.

Syntax
Remove-Replica [-Name] <Zeichenfolge> [-Host] <Zeichenfolge> [-Übergeordneter Host] <Zeichenfolge>
Parameter
Name

Der Name des Szenarios.

Host

Der Name des Replikat-Hosts, den Sie entfernen möchten.

Überordnung

Der übergeordnete Host des Replikat-Hosts, den Sie in der Replikationsstruktur entfernen möchten. Dieser kann entweder der Master oder ein Upstream-Replikat sein.

Beispiel: Entfernen eines Replikat-Hosts von einem Szenario

remove-replica "FS 1" 130.119.185.153 -übergeordnet 130.119.185.152
Ergebnis
Replikat 130.119.185.153 entfernt   

Remove-Scenario - Löschen von Szenarien

Mit Hilfe des Befehls Remove-Scenario können Sie ein vorgegebenes Szenario löschen.

Hinweis: Ein Szenario, das gerade ausgeführt wird, kann nicht gelöscht werden.

Syntax
Remove-Scenario [-Name] <Zeichenfolge> 
Parameter
Name

Der Name des Szenarios, das Sie löschen möchten.

Beispiel: Entfernen von Szenarien

remove-scenario "Dateiserver 2"
Ergebnis
Szenario Dateiserver 2 entfernt

Rename-Group - Umbenennen von Szenariogruppen

Mit Hilfe des Befehls Rename-Group können Sie den Namen einer Szenariogruppe ändern.

Syntax
Rename-Group [-Name] <Zeichenfolge> [-NeuerName] <Zeichenfolge> 
Parameter
Name

Der aktuelle Name der Szenariogruppe.

NeuerName

Der neue Name der Szenariogruppe.

Hinweis: Geben Sie einen eindeutigen Namen ein, da Sie denselben Namen nicht für mehrere Szenariogruppen verwenden können. Wenn Sie für die Szenariogruppe einen bestehenden Namen verwenden, wird dieser automatisch durch das System geändert.

Beispiel: Umbenennen von Szenariogruppen

rename-group Server "Exchange Server-Szenarien"
Ergebnis
Group Server umbenannt!

Rename-Scenario - Ändern von Szenarionamen

Mit Hilfe des Befehls Rename-Scenario können Sie den Namen einer Szenariogruppe ändern.

Hinweis: Ein Szenario, das gerade ausgeführt wird, kann nicht umbenannt werden. Um den Namen ändern zu können, müssen Sie es zuerst beenden.

Syntax
Rename-Scenario [-Name] <Zeichenfolge> [-NeuerName] <Zeichenfolge> 
Parameter
Name

Der aktuelle Name des Szenarios.

Neuer Name

Der neue Name des Szenarios.

Beispiel:

rename-scenario "Dateiserver 1" "Dateiserver"
Ergebnis
Szenario Dateiserver 1 umbenannt!













Befehle zur Änderung von Szenarien während der Ausführung

Während ein Szenario ausgeführt wird, können Sie bestimmte Szenarioeigenschaften ändern. Dieser Abschnitt listet die Syntax und Beispiele für die Befehle auf, die angewendet werden, um ein Szenario, während es ausgeführt wird, zu bearbeiten.

Apply-AllPendingRuntmeChangeableScenarioProperties

Der Befehl "Apply-AllPendingRuntimeChangeableScenarioProperties" ermöglicht es Ihnen, alle Änderungen in allen geänderten Szenarien zur Laufzeit anzuwenden.

Syntax
Apply-AllPendingRuntimeChangeableScenarioProperties
Parameter

Keine

Beispiel

Nehmen wir an, dass Sie Eigenschaften in mehreren Szenarien geändert haben. Diese Änderungen sind alle ausstehend. Um sie sofort anzuwenden, verwenden Sie diesen Befehl.

Apply-PendingRuntimeChangeableScenarioProperties

Der Befehl Apply-PendingRuntimeChangeableScenarioProperties ermöglicht es Ihnen, alle Änderungen auf das angegebene ausgeführte Szenario anzuwenden.

Syntax
Apply-PendingRuntimeChangeableScenarioProperties [Name]
Parameter

Name: Der Name des ausgeführten Szenarios, das Sie ändern möchten.

Beispiel

Folgender Befehl wendet Änderungen auf ein Szenario mit dem Namen "FileServer" an:

Apply-PendingRuntimeChangeableScenarioProperties FileServer
Ergebnis

Das Ergebnis ist eine Liste von Eigenschaften und ihren Werten:

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

Der Befehl "AllPendingRuntimeChangeableScenarioProperties" bricht alle Änderungen ab, die Sie für alle Szenarien konfiguriert haben.

Syntax
Discard-AllPendingRuntimeChangeableScenarioProperties
Parameter

Keine

Discard-RuntimeChangeableScenarioProperties

Der Befehl "Discard-RuntimeChangeableScenarioProperties" ermöglicht es Ihnen, alle Änderungen abzubrechen, die Sie auf dem angegebenen ausgeführten Szenario vorgenommen haben.

Syntax
Discard-RuntimeChangeableScenarioProperties [Name]
Parameter

Name: Dies ist der Name des ausgeführten Szenarios, für das Sie Änderungen verwerfen möchten.

Beispiel

Wenn Sie mehrere Änderungen in einem ausgeführten Szenario mit dem Namen "FileServer" vorgenommen haben und Probleme entdecken, verwenden Sie folgenden Befehl, um das Szenario auf alle ursprünglichen Werten zurückzustellen:

Discard-RuntimeChangeableScenarioProperties FileServer
Ergebnis

Alle Änderungen, die in einem Szenario mit dem Namen "FileServer" vorgenommen wurden, werden auf ihre ursprünglichen Werten zurückgesetzt.

Wenn Sie nur bestimmte Eigenschaften auf ihren ursprünglichen Wert zurücksetzen möchten, verwenden Sie den Befehl "Set-RuntimeChangeableScenarioProperties", um nur die angegebene Eigenschaft für das ausgeführte Szenario zu ändern. Beachten Sie, dass wenn Sie Änderungen verworfen haben, alle Datensätze in der Liste "Get-AllPendingRuntimeChangeableScenarioProperties" gelöscht werden. Wenn Sie "Apply-PendingRuntimeChangeableScenarioProperties" ausführen, führt dies zu einer Warnmeldung, die darauf hinweist, dass das angegebene Szenario nicht zur Laufzeit geändert wurde.

Get-AllPendingRuntimeChangeableScenarioProperties

Der Befehl "Get-AllPendingRuntimeChangeableScenarioProperties" listet alle Szenarien auf, die während der Ausführung geändert wurden.

Syntax
Get-AllPendingRuntimeChangeableScenarioProperties
Parameter

Keine

Beispiel

Folgender Befehl listet alle Szenarien auf, die während der Ausführung geändert wurden.

Get-AllPendingRuntimeChangeableScenarioProperties
Ergebnis

Das Ergebnis ist eine Liste von Szenarionamen.

Get-AllRuntimeChangeableScenarioProperties

Der Befehl "Get-AllRuntimeChangeableScenarioProperties" ermöglicht es Ihnen, alle Eigenschaften aufzulisten, die geändert werden können, während ein Szenario ausgeführt wird.

Syntax
get-AllRuntimeChangeableScenarioProperties
Parameter

Keine

Beispiel:

Folgender Code gibt den Befehl aus, um alle bearbeitbaren Eigenschaften aufzulisten und die Ausgabe an eine Textdatei umzuleiten.

Get-AllRuntimeChangeableScenarioProperties > d:\1.txt
Ergebnis

Das Ergebnis ist eine Reihe von bearbeitbaren Eigenschaften im Format "Scenario/Master/Replica/PropertyName".

Get-RuntimeChangeableScenarioProperties

Der Befehl "Get-RuntimeChangeableScenarioProperties" ermöglicht es Ihnen, alle Eigenschaften zu finden, die Sie bearbeiten können, während das angegebene Szenario ausgeführt wird. Der Befehl gibt eine Liste von Eigenschaften zurück, die Sie für dieses Szenario ändern können. Verbinden Sie E/A-Umleitungsbefehlen, um die Ausgabe zu einer Textdatei zu formatieren.

Syntax
Get-RuntimeChangeableScenarioProperties [Name]
Parameter

Name: Name des ausgeführten Szenarios

Beispiel:

Folgender Befehl listet alle bearbeitbaren Eigenschaften für das Szenario mit dem Namen "File Server Scenario 1" auf:

Get-RuntimeChangeableScenarioProperties FileServerScenario1
Ergebnis

Property: False

Host: 10.0.0.0

Value: False

Index: 111

Category: Replica

Name: SpecificReplicaProps.Suspend.SuspendScript

Get-PendingRuntimeChangeableScenarioProperties

Der Befehl "Get-PendingRuntimeChangeableScenarioProperties" ermöglicht es Ihnen, alle Änderungen aufzulisten, die im angegebenen ausgeführten Szenario vorgenommen wurden.

Syntax
Get-PendingRuntimeChangeableScenarioProperties [Name]
Parameter

Name: Name des ausgeführten Szenarios

Beispiel:

Folgendes Beispiel zeigt die Liste aller geänderten Eigenschaften für das Szenario mit dem Namen "FileServer":

Get-PendingRuntimeChangeableScenarioProperties FileServer
Ergebnis

Das Ergebnis ist eine Liste von Eigenschaften und ihren ursprünglichen und neuen Werten.

Set-RuntimeChangeableScenarioProperty

Der Befehl "Set-RuntimeChangeableScenarioProperty" ermöglicht es Ihnen, den Wert der angegebenen Eigenschaft im genannten Szenario zu aktualisieren, während es ausgeführt wird.

Syntax
Set-RuntimeChangeableScenarioProperty [Name] [Index] [Value] [Host]
Parameter

Name: Der Name des ausgeführten Szenarios, dessen Eigenschaften Sie ändern möchten.

Index: Der Index oder Name der Eigenschaft, die Sie ändern möchten. Um korrekte Namen zu bestimmen, verwenden Sie die Befehle "Get-AllRuntimeChangeableScenarioProperties" oder "Get-RuntimeChangeableScenarioProperties". Der Indexwert wird intern generiert. Sogar bei zwei Szenarien des gleichen Typs kann die gleiche Eigenschaft einen anderen Index haben. Stellen Sie sicher, dass Sie die richtigen Indizes oder Namen erhalten.

Wert - Die neue Einstellung für die angegebene Eigenschaft.

Host - (Optional) Der Host muss nur für Änderungen der Master- oder Replikateigenschaften angegeben werden. Für generische oder HA-Eigenschaften ist dieser Wert optional.

Beispiel:

Folgender Befehl aktualisiert das Argument der angehaltenen Skripteigenschaft, die auf dem Namen basiert:

Set-RuntimeChangeableScenarioProperty FileServer SpecificReplicaProps.Suspend.SuspendScript 456 -Host 10.0.0.1
Ergebnis

Das Ergebnis ist eine Tabelle, die Eigenschaften, den ursprünglichen und den neuen Wert anzeigt.

Test-RuntimeChangeableScenarioProperty

Der Befehl "Test-RuntimeChangeableScenarioProperty" ermöglicht es Ihnen, zu bestätigen, ob die angegebene Eigenschaft noch bearbeitet werden kann, während das Szenario ausgeführt wird.

Syntax
Test-RuntimeChangeableScenarioProperty [Name] [Index] [Host]
Parameter

Name: Name des ausgeführten Szenarios

Index: Der Index oder Name der Eigenschaft, die Sie testen möchten.

Host: Optional

Beispiel

Folgender Befehl testet die Eigenschaft, dessen Index 113 ist, für ein ausgeführtes Szenario mit dem Namen "FileServer".

Test-RuntimeChangeableScenarioProperty FileServer 113 -host 10.0.0.3
Ergebnis

Das Ergebnis ist ein wahrer oder falscher Wert für den angegebenen Index oder Eigenschaftsnamen.

Überwachen von Befehlen

In diesem Abschnitt werden CA ARCserve RHA-PowerShell-Befehle beschrieben, mit denen Sie die DR- und HA-Vorgänge überwachen können.

Get-Dirs - Auflisten aller Stammverzeichnisse eines Szenarios

Mit Hilfe des Befehls Get-Dirs können Sie alle Stammverzeichnisse eines Szenarios auflisten.

Syntax
Get-Dirs [-Name] <Zeichenfolge> 
Parameter
Name

Der Szenarioname.

Beispiel: Auflisten der Stammverzeichnisse eines Szenarios

get-dirs "Dateiserver 1"
Ergebnis
ID       : 2721474912
Szenario : Dateiserver 1
Master   : 192.168.1.152
Pfad = C:/Test
DB       : False

Get-Events - Auflisten aller Ereignisse eines Szenarios

Mit Hilfe des Befehls Get-Events können Sie eine Liste der Replikationsereignisse eines Szenarios anzeigen. Die Ereignisliste kann Informations-, Warnungs- und Fehlerereignisse beinhalten. Zu den angezeigten Informationen zählen die Ereignis-ID, das Datum und die Uhrzeit des Ereignisses, der Szenarioname, der Schweregrad des Ereignisses und die Ereignismeldung.

Syntax
Get-Events [-Name] <Zeichenfolge> 
Parameter
Name

Der Name des Szenarios, dessen Ereignisse Sie anzeigen möchten.

Beispiel: Auflisten der Ereignisse eines Szenarios in einer automatisch angepassten Formattabelle

get-events "Dateiserver 1" | FT -auto
Ergebnis
ID      Uhrzeit                  Szenario      Schweregrad    Meldung
--      ----                  --------      --------    -------
SM00165 28/10/2008 18:02:52 Uhr Dateiserver 1 Erheblich Verbunden mit...
SR00014 30/10/2008 19:17:31 Uhr Dateiserver 1 Erheblich Startvorgang wird ausgeführt...
SR00139 30/10/2008 19:17:31 Uhr Dateiserver 1 Erheblich Datei wird gestartet...
IR00119 30/10/2008 19:18:16 Uhr Dateiserver 1 Info        Stammverzeichnis...
SR00120 30/10/2008 19:18:16 Uhr Dateiserver 1 Erheblich Synchronisation...
IM00405 30/10/2008 19:15:06 Uhr Dateiserver 1 Info        Bericht... 
SR00202 30/10/2008 19:18:16 Uhr Dateiserver 1 Erheblich Alle Änderungen...
SR00096 3/11/2008 18:47:40 Uhr Dateiserver 1 Erheblich Szenario wird beendet...

Get-Group - Auflisten von Gruppen mit vorgegebenem Namen

Mit Hilfe des Befehls Get-Group können Sie alle Szenariogruppen auflisten, die einen vorgegebenen Namen tragen. Um diese Liste anzuzeigen, müssen Sie den Namen eingeben, nach dem Sie suchen.

Darüber hinaus können Sie mit diesem Befehl alle bestehenden Szenariogruppen auflisten. Geben Sie den Befehl einfach ohne einen Szenarionamen ein, um alle Szenariogruppen anzuzeigen.

Syntax
Get-group [[-GruppenName] [<Zeichenfolge>]]
Parameter
Name

Der Name der Szenariogruppe.

Hinweis: Sie können die Platzhalter '*" oder "?" als Teil des Namens der Szenariogruppe verwenden.

Beispiel: Auflisten aller Szenariogruppen mit vorgegebenem Namen

get-group *Server*
Ergebnis
Dateiserver-Szenarien 2
Dateiserver-Szenarien 1
Exchange Server-Szenarien
Dateiserver-Szenarien

Get-Hosts - Auflisten aller Hosts eines Szenarios

Mit Hilfe des Befehls Get-Hosts können Sie alle Hosts eines Szenarios auflisten.

Syntax
Get-Hosts [-Name] <Zeichenfolge> 
Parameter
Name

Der Szenarioname.

Beispiel: Auflisten der Hosts eines vorgegebenen Szenarios in einer automatisch angepassten Formattabelle

Get-Hosts "Dateiserver 1" |FT -auto
Ergebnis
Szenario      Name          Rolle    Übergeordnetes Element         Status   IP            Port
--         -----     ----            ----       ------        -----   ----  --
Dateiserver 1 192.168.1.152 Master  --             Aktiv 192.168.1.152 25000
Dateiserver 1 192.168.1.153 Replikat 1192.168.1.152 Aktiv 192.168.1.153 25000

Get-Scenario: Auflisten von Szenarien mit vorgegebenem Namen

Mit Hilfe des Befehls Get-Scenario können Sie alle Szenarien auflisten, die einen vorgegebenen Namen tragen. Um diese Liste anzuzeigen, müssen Sie den Namen eingeben, nach dem Sie suchen.

Darüber hinaus können Sie mit diesem Befehl alle bestehenden Szenarien auflisten. Geben Sie den Befehl einfach ohne einen Szenarionamen ein, um alle Szenarien anzuzeigen.

Syntax
Get-Scenario [-Name] <Zeichenfolge> 
Parameter
Name

Der Szenarioname.

Hinweis: Sie können die Platzhalter '*" oder "?" als Teil des Szenarionamens verwenden.

Beispiel: Auflisten aller Szenarien mit vorgegebenem Namen in einer automatisch angepassten Formattabelle

get-scenario Datei* |FT -auto
Ergebnis
ID         Gruppe     Name            Typ       Master        Status   Sync AR
--         -----     ----            ----       ------        -----   ----  --
1123633852 Szenarien Dateiserver   FileServer               Unbekannte Datei False
1123633468 Szenarien Dateiserver 1   FileServer 192.168.1.153 Beendete Datei  False

Get-Snapshot: Anzeigen der VSS-Snapshots eines Replikat-Hosts

Mit dem Befehl Get-Snapshot können Sie alle VSS-Snapshots eines vorgegebenen Replikat-Hosts anzeigen.

Syntax
Get-Snapshot [-Name] <Zeichenfolge> [[-Port] <Zeichenfolge>]
Parameter
Name

Der Name des Hosts, wie er im Szenario vorkommt.

Port (optional)

Der Verbindungsport zu dem vorgegebenen Host. Die standardmäßige Port-Nummer lautet 25000.

Beispiel: Anzeigen aller VSS-Snapshots eines vorgegebenen Replikat-Hosts in einer automatisch angepassten Formattabelle

Get-Snapshot 130.119.173.7 |FT -auto
Ergebnis
Index Snapshot        Erstellt               Angezeigt Geladen     Laufwerk Szenario
----- --------        -------               ------- -------     ----- --------
0     {4f2bb053-5f2d} 18/11/2008 16:03:09 Uhr False   Nicht geladen C:/   FileServer
1     {bcbdda2b-6165} 18/11/2008 16:06:00 Uhr False   Nicht geladen C:/   FileServer
2     {c1f206be-2ad0} 18/11/2008 16:07:17 Uhr False   Nicht geladen C:/   FileServer

Get-State: Auflisten aller Szenarien, die für einen vorgegebenen Host definiert wurden

Mit Hilfe des Befehls Get-State können Sie alle Szenarien auflisten, die für einen vorgegebenen Host definiert wurden, sowie deren Einzelheiten und Status.

Syntax
Get-State [-Name] <Zeichenfolge> 
Parameter
Name

Der Hostname.

Beispiel:

get-state 130.119.185.152
Ergebnis
ID     : 2505374864
Gruppe  : FS-Szenarien
Name   : FS 1
Typ   : Dateiserver
Master   : 130.119.185.152
Status    : wird ausgeführt
Sync   : Datei
AR       : False

ID     : 2721467841
Gruppe  : Dateiserver-Szenarien
Name : Dateiserver 1
Typ   : Dateiserver
Master   : 130.119.185.152
Status  : beendet
Sync   : Datei
AR       : False

Get-Stats - Anzeigen der Replikationsstatistik eines Szenarios

Mit Hilfe des Befehls Get-Stats können Sie während der Ausführung die Szenariostatistik pro Host anzeigen.

Syntax
Get-Stats [-Name] <Zeichenfolge> 
Parameter
Name

Der Name des Szenarios.

Beispiel: Anzeigen der Replikationsstatistik eines Szenarios während der Ausführung

get-stats "Dateiserver 1"
Ergebnis
Szenario : Dateiserver 1
Name        : 192.168.1.152
Rolle     : Master
Spool_Größe  : 0
Sync_Dateien  : 345
Sync_MByte : 86
Rep_MByte  : 0

Szenario : Dateiserver 1
Name        : 192.168.1,153
Rolle     : Replikat
Spool_Größe  : 0
Sync_Dateien  : 345
Sync_MByte : 86
Rep_MByte  : 0 

Benutzerverwaltungsbefehle

In diesem Abschnitt werden CA ARCserve RHA-PowerShell-Befehle beschrieben, mit denen Sie Benutzergruppen und Benutzer für ACL-basierte Steuerungsdienste überwachen und verwalten können.

Hinweis: Für die Verwendung der ACL-Befehle ist eine spezielle Lizenz erforderlich.

Get-SuperUserGroup: Anzeigen des Superuser-Gruppennamens

Mit Hilfe des Befehls Get-SuperUserGroup können Sie den Namen der Superuser-Gruppe des verbundenen Steuerungsdienstes anzeigen.

Syntax
Get-SuperUserGroup

Hinweis: Dieser Befehl verfügt nicht über Parameter.

Beispiel: Anzeigen des Namens der Superuser-Gruppe

Get-SuperUserGroup
Ergebnis
QA95-W2K3-SQL\\CA XOsoft-Benutzer

Set-SuperUserGroup: Ändern der Superuser-Gruppe

Mit Hilfe des Befehls Set-SuperUserGroup können Sie die Superuser-Gruppe ändern.

Syntax
Set-SuperUserGroup [-Gruppenname] <Zeichenfolge>
Parameter
Gruppenname

Der Name der neuen Superuser-Gruppe.

Beispiel: Ändern der Superuser-Gruppe

Set-SuperUserGroup Administrators
Ergebnis
Superuser-Gruppe erfolgreich festgelegt.

Get-Users - Auflisten aller Benutzer der Superuser-Gruppe

Mit Hilfe des Befehls Get-Users können Sie alle Benutzer auflisten, die zur Superuser-Gruppe gehören.

Syntax
get-users 

Hinweis: Dieser Befehl verfügt nicht über Parameter.

Beispiel: Auflisten aller Benutzer, die zur Superuser-Gruppe gehören

get-users
Ergebnis
QA95-W2K3\Administrator
QA95-W2K3-SQL\Benutzer2
QA95-W2K3-SQL\Benutzer1

Get-ScenarioUsers: Auflisten aller Benutzer, die über Rechte für ein Szenario verfügen

Mit Hilfe des Befehls Get-ScenarioUsers können Sie alle Benutzer auflisten, die über Rechte für ein bestimmtes Szenario verfügen.

Syntax

get-ScenarioUsers [-Szenarioname] <Zeichenfolge>

Parameter
Szenarioname

Der Name des Szenarios.

Beispiel: Auflisten aller Benutzer, die über Rechte für ein bestimmtes Szenario verfügen

Get-ScenarioUsers "Dateiserver"
Ergebnis
name
----
QA95-W2K3-SQL\Benutzer2
QA95-W2K3-SQL\Benutzer1

Set-ScenarioUser: Zuweisen von Benutzerrechten für ein Szenario

Mit Hilfe des Befehls Set-ScenarioUser können Sie einem Benutzer gewisse Rechte für ein bestimmtes Szenario zuweisen.

Syntax
Set-ScenarioUser [-Name] <Zeichenfolge> [-Benutzer] <Zeichenfolge> [-Recht] <Zeichenfolge> 
Parameter
Name

Der Name des Szenarios.

Benutzer

Der vollständige Name des Benutzers.

Rechts

Die Art der Rechte, über die der Benutzer für das Szenario verfügen wird. Geben Sie eine der folgenden Angaben ein:

A = Admin

C = Control (Steuerung)

V = View Only (Nur Anzeige)

Beispiel: Einem Benutzer Steuerungsrechte für ein bestimmtes Szenario zuweisen

Set-ScenarioUser "Dateiserver" QA95-W2K3-SQL\Benutzer2 C
Ergebnis
Benutzerrecht erfolgreich festgelegt.

Remove-ScenarioUser: Aufheben von Benutzerrechten für ein Szenario

Mit Hilfe des Befehls Remove-ScenarioUser können Sie die Rechte aufheben, über die ein Benutzer für ein bestimmtes Szenario verfügt.

Syntax
Remove-ScenarioUser [-Name] <Zeichenfolge> [-Benutzer] <Zeichenfolge>
Parameter
Szenarioname

Der Name des Szenarios.

Benutzername

Der Name des Benutzers.

Beispiel: Aufheben der Rechte eines Benutzers für ein bestimmtes Szenario

Remove-ScenarioUser "Dateiserver" QA95-W2K3-SQL\Benutzer2
Ergebnis
Benutzer erfolgreich entfernt.