G.2 Migrate Agent-Dienstprogramm für Windows

G.2.1 Herunterladen und Installieren von Migrate Agent auf einem Windows-Ursprungs-Workload

So laden Sie das Migrate Agent-Dienstprogramm für Windows auf den Ursprungs-Workload herunter und installieren es:

Melden Sie sich beim Windows-Ursprungscomputer als verwaltungsbefugter Benutzer an.
Starten Sie die PlateSpin Migrate-Weboberfläche in einem Webbrowser und melden Sie sich an.
Klicken Sie auf die Registerkarte Downloads.
Klicken Sie auf den Migrate Agent-Anwendungslink für die Windows-Zielplattform und speichern Sie die komprimierte Datei MigrateAgent.cli.exe.
Extrahieren Sie den Inhalt der Datei, sodass die ausführbare Datei verfügbar wird.
(Optional) Rufen Sie die Migrate Agent-Hilfe mit dem folgenden Befehl auf:
```
MigrateAgent.cli.exe -h
```

G.2.2 Migrate Agent-Befehle für Windows

Zum Ausführen des Migrate Agent-Dienstprogramms für Windows gilt die folgende Syntax:

MigrateAgent.cli.exe {command} [command_option] [/psserver=%IP%]

Tabelle G-1 zeigt die Befehle, die Befehlsoptionen und den Switch für den Befehl MigrateAgent.cli.exe unter Windows.

Tabelle G-1 Migrate Agent-Dienstprogramm für Windows – Befehle, Befehlsoptionen und Switch

Verwendung	Beschreibung
Befehle
h \| ? \| help	Zeigt die Nutzung und die Optionen für den Befehl.
logs\|view-logs	Öffnet das Anwendungsprotokollverzeichnis.
reg \| register /reg /psserver=%IP% /username=<Benutzername> [[ /password=<Passwort>] \| [/pwdfile=<Pfad-zur-Passwortdatei>]] Wenn Sie das Passwort oder einen Pfad zu einer Datei mit dem Passwort nicht angeben, werden Sie zur Eingabe des Passworts aufgefordert. Das Passwort wird beim Eingeben durch Platzhalterzeichen ersetzt und wird nicht in der Verarbeitungsliste angezeigt. Beispiel: MigrateAgent.cli.exe /register /psserver=10.10.10.101 /username=jsmith /password=jspwd	Registriert diesen Computer als Workload auf dem angegebenen Server. Außerdem werden Treiberaufrüstungen auf dem angegebenen PlateSpin-Server gesucht. Ermöglicht das Hinzufügen von Workloads, die nicht ermittelt werden können. Registrierte Workloads unterscheiden sich von ermittelten Workloads wie folgt: In registrierten Ursprungs-Workloads wird der Ursprungs-Berechtigungsnachweis nicht gespeichert. Sie müssen den Migrate Agent verwenden, um Treiber für die blockbasierte Übertragung (BBT, Block-based Transfer) in registrierten Ursprungs-Workloads zu installieren, aufzurüsten und zu entfernen. Nach dem Löschen eines Vertrags für einen registrierten Ursprungs-Workload müssen Sie den OFX-Controller manuell aus dem Workload entfernen. Informationen zum Entfernen des OFX-Controllers aus dem Workload finden Sie im KB-Artikel.
status /status [/psserver=%IP%]	Zeigt den Installationsstatus für den PlateSpin-Controller und die Treiber auf diesem Workload. Wenn Sie den PlateSpin-Server angeben, werden Treiberaufrüstungen auf dem Server gesucht.
din\|driver-install /din [/psserver=%IP%]	Installiert die PlateSpin-Treiber. HINWEIS:Bevor Sie die Treiber für die blockbasierte Übertragung auf Windows-Ursprungs-Workloads installieren, stellen Sie sicher, dass Sie die neuesten Windows-Aktualisierungen auf dem Workload installiert haben. Wenn Sie den PlateSpin-Server angeben, werden Treiberaufrüstungen auf dem Server gesucht.
dup\|driver-upgrade /dup [/psserver=%IP%]	Rüstet die PlateSpin-Treiber auf. Wenn Sie den PlateSpin-Server angeben, werden Treiberaufrüstungen auf dem Server gesucht.
dun\|driver-uninstall [/dun /psserver=%IP%]	Deinstalliert die PlateSpin-Treiber.
con \| config /con /setting=<Name_der_Einstellung>:<Wert> Beispiel: migrateagent.cli.exe /config /setting=psserver:10.10.10.202	Gibt den Namen der Einstellung mit dem zugehörigen Wert an, die in der Konfigurationsdatei auf diesem Workload geändert werden sollen. Die Option psserver hält den OFX-Controller-Dienst (ofxcontroller) an, aktualisiert die Datei OfxController.exe.config mit der neuen IP-Adresse und startet den Dienst neu. Wenn Sie die öffentliche IP-Adresse des PlateSpin-Servers ändern, müssen Sie diesen Befehl auf jedem Ursprungs-Workload ausführen, der für den Server konfiguriert ist.
Switch
/psserver=%IP%	Gibt die IPv4-Adresse des PlateSpin-Servers an. Lädt die Treiber für die blockbasierte Übertragung vom angegebenen Server herunter, sobald Sie die Option status, driver-install oder driver-upgrade aufrufen.
Befehlsoptionen
Benutzername /username=Wert	Gibt den Benutzernamen eines Administratorbenutzers für den PlateSpin-Server an, der berechtigt ist, einen Workload hinzuzufügen.
password \| pwd \| p /password= Wert	Gibt das Passwort für den angegebenen Benutzernamen für den PlateSpin-Server an. Wenn Sie das Passwort nicht in der Befehlszeile eingeben, werden Sie durch das Skript zur Eingabe aufgefordert. Das Passwort wird beim Eingeben durch Platzhalterzeichen ersetzt und wird nicht in der Verarbeitungsliste angezeigt. Diese Option darf nicht mit der Option pwdfile kombiniert werden.
pwdfile \| pf /pwdfile=Wert	Gibt den Pfad zu einer Datei an, die das Passwort für den angegebenen Benutzernamen für den PlateSpin-Server enthält. Diese Option darf nicht mit der Option password kombiniert werden.
setting /setting=<Name_der_Einstellung>:<Wert>	Gibt den Namen und den Wert der zu ändernden Konfigurationseinstellung an. Unterstützte Einstellungsnamen: psserver altAddress heartbeat

Verwendung

Beschreibung

Befehle

h | ? | help

Zeigt die Nutzung und die Optionen für den Befehl.

logs|view-logs

Öffnet das Anwendungsprotokollverzeichnis.

reg | register

/reg /psserver=%IP% /username=<Benutzername> [[ /password=<Passwort>] | [/pwdfile=<Pfad-zur-Passwortdatei>]]

Wenn Sie das Passwort oder einen Pfad zu einer Datei mit dem Passwort nicht angeben, werden Sie zur Eingabe des Passworts aufgefordert. Das Passwort wird beim Eingeben durch Platzhalterzeichen ersetzt und wird nicht in der Verarbeitungsliste angezeigt.

Beispiel:

MigrateAgent.cli.exe /register /psserver=10.10.10.101 /username=jsmith /password=jspwd

Registriert diesen Computer als Workload auf dem angegebenen Server. Außerdem werden Treiberaufrüstungen auf dem angegebenen PlateSpin-Server gesucht.

Ermöglicht das Hinzufügen von Workloads, die nicht ermittelt werden können. Registrierte Workloads unterscheiden sich von ermittelten Workloads wie folgt:

In registrierten Ursprungs-Workloads wird der Ursprungs-Berechtigungsnachweis nicht gespeichert.
Sie müssen den Migrate Agent verwenden, um Treiber für die blockbasierte Übertragung (BBT, Block-based Transfer) in registrierten Ursprungs-Workloads zu installieren, aufzurüsten und zu entfernen.
Nach dem Löschen eines Vertrags für einen registrierten Ursprungs-Workload müssen Sie den OFX-Controller manuell aus dem Workload entfernen. Informationen zum Entfernen des OFX-Controllers aus dem Workload finden Sie im KB-Artikel.

status

/status [/psserver=%IP%]

Zeigt den Installationsstatus für den PlateSpin-Controller und die Treiber auf diesem Workload.

Wenn Sie den PlateSpin-Server angeben, werden Treiberaufrüstungen auf dem Server gesucht.

din|driver-install

/din [/psserver=%IP%]

Installiert die PlateSpin-Treiber.

HINWEIS:Bevor Sie die Treiber für die blockbasierte Übertragung auf Windows-Ursprungs-Workloads installieren, stellen Sie sicher, dass Sie die neuesten Windows-Aktualisierungen auf dem Workload installiert haben.

Wenn Sie den PlateSpin-Server angeben, werden Treiberaufrüstungen auf dem Server gesucht.

dup|driver-upgrade

/dup [/psserver=%IP%]

Rüstet die PlateSpin-Treiber auf.

Wenn Sie den PlateSpin-Server angeben, werden Treiberaufrüstungen auf dem Server gesucht.

dun|driver-uninstall

[/dun /psserver=%IP%]

Deinstalliert die PlateSpin-Treiber.

con | config

/con /setting=<Name_der_Einstellung>:<Wert>

Beispiel:

migrateagent.cli.exe /config /setting=psserver:10.10.10.202

Gibt den Namen der Einstellung mit dem zugehörigen Wert an, die in der Konfigurationsdatei auf diesem Workload geändert werden sollen.

Die Option psserver hält den OFX-Controller-Dienst (ofxcontroller) an, aktualisiert die Datei OfxController.exe.config mit der neuen IP-Adresse und startet den Dienst neu. Wenn Sie die öffentliche IP-Adresse des PlateSpin-Servers ändern, müssen Sie diesen Befehl auf jedem Ursprungs-Workload ausführen, der für den Server konfiguriert ist.

Switch

/psserver=%IP%

Gibt die IPv4-Adresse des PlateSpin-Servers an.

Lädt die Treiber für die blockbasierte Übertragung vom angegebenen Server herunter, sobald Sie die Option status, driver-install oder driver-upgrade aufrufen.

Befehlsoptionen

Benutzername

/username=Wert

Gibt den Benutzernamen eines Administratorbenutzers für den PlateSpin-Server an, der berechtigt ist, einen Workload hinzuzufügen.

password | pwd | p

/password= Wert

Gibt das Passwort für den angegebenen Benutzernamen für den PlateSpin-Server an.

Wenn Sie das Passwort nicht in der Befehlszeile eingeben, werden Sie durch das Skript zur Eingabe aufgefordert. Das Passwort wird beim Eingeben durch Platzhalterzeichen ersetzt und wird nicht in der Verarbeitungsliste angezeigt.

Diese Option darf nicht mit der Option pwdfile kombiniert werden.

pwdfile | pf

/pwdfile=Wert

Gibt den Pfad zu einer Datei an, die das Passwort für den angegebenen Benutzernamen für den PlateSpin-Server enthält.

Diese Option darf nicht mit der Option password kombiniert werden.

setting

/setting=<Name_der_Einstellung>:<Wert>

Gibt den Namen und den Wert der zu ändernden Konfigurationseinstellung an.

Unterstützte Einstellungsnamen:

psserver
altAddress
heartbeat