Befehlszeilenhilfsprogramm "EMP Migrate"
In diesem Abschnitt werden folgende Themen behandelt:
- Wissenswertes über das Befehlszeilenhilfsprogramm "EMP Migrate"
- Ausführen des Befehlszeilenhilfsprogramms "EMP Migrate"
- Anwendungsbeispiele und Lösungen
Wissenswertes über das Befehlszeilenhilfsprogramm "EMP Migrate"
Das Environment Manager-Befehlszeilenhilfsprogramm für die Personalisierungsmigration (EMP Migrate) ist ein auf der Befehlszeile basierendes Tool, mit dem Benutzerdaten von einer Quelldatenbank in eine Zieldatenbank kopiert, Benutzernamen der Zieldomäne zugeordnet und gespeicherte Registrierungseinstellungen entsprechend angepasst werden können. Das Hilfsprogramm kontaktiert direkt die entsprechenden Datenbanken und verwendet keine vorhandenen Personalisierungsserver. Das Befehlszeilenhilfsprogramm "EMP Migrate" bietet die gleichen Funktionen wie das Hilfsprogramm "EMP Migrate".
Das Befehlszeilenhilfsprogramm "EMP Migrate" befindet sich im Tools-Installationsordner und wird über die Eingabeaufforderung ausgeführt.
Ausführen des Befehlszeilenhilfsprogramms "EMP Migrate"
- Rufen Sie das Dialogfeld zum Ausführen auf und geben Sie cmd.exe ein.
- Wechseln Sie mithilfe der Eingabeaufforderung zum Tools-Installationsordner: %Programme%\AppSense\Environment Manager\Tools\
- Führen Sie EMPMigrateCmd.exe mit den entsprechenden Parametern aus der Tabelle unten aus.
Parameter für das Befehlszeilenhilfsprogramm "EMP Migrate"
| Parameter | Eingabeargumente | Parameterdetails |
/?
/ |
nicht zutreffend | Gibt den Hilfetext auf der Konsole aus. |
/sourcedb
|
dbname | Der Name der Quelldatenbank. Dies ist ein Pflichtparameter. |
/sourceinstance
|
server[\instance] | Der Server- oder Instanzname für die Quelldatenbank. Der Instanzname ist optional. Dies ist ein Pflichtparameter. |
/targetdb
|
dbname | Der Name der Zieldatenbank. |
/targetinstance
|
server[\instance] | Der Server- oder Instanzname für die Zieldatenbank. Der Instanzname ist optional. Dies ist ein Pflichtparameter. |
/sourcewindowsauth
|
true oder false | Der Authentifizierungstyp, der für die Verbindung zur Quelldatenbank verwendet wird:
Wenn kein Argument angegeben ist, wird automatisch der Typ Windows-Authentifizierung verwendet. |
/sourcesqlusername
|
username |
Der Benutzername für die SQL-Authentifizierung auf der Quelldatenbank. Wenn SQL-Authentifizierung erforderlich ist, setzen Sie den Parameter sourcewindowsauth auf false. |
/sourcesqlpassword
|
password |
Das Kennwort für die SQL-Authentifizierung auf der Quelldatenbank. Wenn SQL-Authentifizierung erforderlich ist, setzen Sie den Parameter sourcewindowsauth auf false. |
|
|
true oder false | Der Authentifizierungstyp, der für die Verbindung zur Zieldatenbank verwendet wird:
Wenn kein Argument angegeben ist, wird automatisch der Typ Windows-Authentifizierung verwendet. |
/targetsqlusername
|
username |
Der Benutzername für die SQL-Authentifizierung auf der Zieldatenbank. Wenn SQL-Authentifizierung erforderlich ist, setzen Sie den Parameter sourcewindowsauth auf false. |
/targetsqlpassword
|
password |
Das Kennwort für die SQL-Authentifizierung auf der Zieldatenbank. Wenn SQL-Authentifizierung erforderlich ist, setzen Sie den Parameter sourcewindowsauth auf false. |
/domainmapping
|
[current]|[map]|[nomap] |
Der Zuordnungstyp, der für Benutzer in der neuen Domäne angewendet werden muss. Ohne Angabe wird dieser Parameter standardmäßig auf "aktuell" gesetzt. |
/mapto
|
domainname |
Der Name der Zieldomäne, wenn der Parameter mapto auf map gesetzt ist. |
/users
|
[all]|[group]|[list] | Gibt an, welche Benutzer migriert werden müssen.
Wenn ein Benutzer doppelt in der Quelldatenbank gefunden wird, wird nur der neuere Benutzer migriert. |
/usersgroup
|
groupname |
Der Name der Personalisierungsgruppe, die migriert werden soll. Wird verwendet, wenn "users" auf group gesetzt ist. |
/userlist
|
listfile | Vollständiger Pfad zur Datei, die eine Liste der zu migrierenden Benutzer enthält. Wird verwendet, wenn users auf list gesetzt ist. Der Dateipfad muss in Anführungszeichen eingeschlossen werden. Jeder, in der Datei aufgeführte Benutzer muss in einer eigenen Zeile stehen oder die Datei muss CSV-Format haben. Wenn ein Dateiname ohne Pfad angegeben wird, wird das Arbeitsverezeichnis von EMPMigrateCmd.exe angenommen. |
/options
|
[replace],[ignoreglobal],[copyarchives],[copydiscovered] | Es können eine oder mehrere dieser Optionen als durch Kommata getrennte Parameter angegeben werden.
|
/output
|
outputfile | Das Ausgabeverzeichnis der Berichtsdatei. Bei der Angabe des Ausgabepfads muss der Pfadname in Anführungszeichen stehen.Wenn kein Pfad angegeben ist, wird der Standardpfad %USERPROFILE%\\Documents\\EMPMigrate.log verwendet. |
/threads
|
number |
Die Anzahl der bei der Migration verwendeten Threads. Der Wert 0 erzwingt, dass die Anzahl der Threads der Anzahl der Prozessoren entspricht. Er ist der Standardwert. |
Für Benutzernamen erforderliches Format
Benutzernamen müssen mit der Angabe im Feld dbo.User.Name der Quelldatenbank übereinstimmen. Diese sind im von Microsoft definierten Format für Downlevelbenutzernamen geschrieben. Beispiel: Das Format für den Benutzer "Beispiel-User" in der lokalen Domäne Ivanti.local ist Ivanti\Beispiel-User. Wird der vollständig qualifizierte Domänenname Ivanti.local verwendet, wird der Benutzer ignoriert und nicht migriert. Auch wenn der Name technisch korrekt ist, stimmt er nicht mit dem Wert im Namensfeld der Datenbank überein.
Das Format für den Benutzerprinzipalnamen wird nicht unterstützt.
Anwendungsbeispiele und Lösungen
Die folgenden Beispiele zeigen, wie das Befehlszeilenhilfsprogramm EMPMigrate verwendet werden kann. In diesen Beispielen stellt SrcSql den Quellspeicherort und TgtSQL den Zielort dar. Jedes Beispiel besteht aus einer kurzen Darstellung der durchzuführenden Aufgabe gefolgt von der Befehlszeilenlösung.
Erstes Beispiel
Sie möchten mithilfe der Windows-Authentifizierung eine Personalisierungsgruppe namens "Prod Users" an einen neuen Zielort kopieren und die vorhandenen Benutzerdaten in der Zieldatenbank durch die Daten aus der Quelldatenbank ersetzen. Zum Migrieren der Gruppe müssen Sie prüfen, ob die Personalisierungsgruppe an Ihrem Zielort vorhanden ist und ob es bei den globalen Dateneinstellungen keine Unterschiede gibt.
Lösung
EMPMigrateCmd.exe /SourceInstance SrcSQL /SourceDB PSDB /TargetInstance TgtSQL /TargetDB PSDB /Users Group /UserGroup "Prod Users" /Options Replace
Zweites Beispiel
Sie möchten unter Verwendung expliziter SQL-Anmeldeinformationen für sowohl den Quell- als auch den Zielort alle Benutzer zu einem Zielort migrieren. Bei der Migration müssen vorhandenen Personalisierungsgruppen ersetzt und Unterschiede in den globalen Daten ignoriert werden. Es wird keine Zuordnung zu einer neuen Domäne vorgenommen.
Lösung
EMPMigrate.exe /SourceInstance SrcSQL /SourceDB PSDB /SourceSQLusername sa /SourceSQLPassword sourcePass /TargetInstance TgtSQL /TargetDB PSDB /TargetSQLUsername sa TargetSQLPassword targetPass /DomainMapping NoMap /Users All /Options Replace,IgnoreGlobal
Drittes Beispiel
Sie möchten unter Verwendung der Windows-Authentifizierung am Quellort eine Liste von Benutzern, die sich in c:\Temp\UserList.txt befindet, an einen Zielort migrieren, für den explizite SQL-Anmeldeinformationen erforderlich sind. Bei der Migration müssen vorhandene Personalisierungsgruppen ersetzt und Daten für erkannte Anwendungen berücksichtigt werden. Unterschiede bei den globalen Dateneinstellungen müssen ignoriert werden und es findet keine Zuordnung zu einer neuen Domäne statt.
Lösung
EMPMigrate.exe /SourceInstance SrcSQL /SourceDB PSDB /TargetInstance TgtSQL /TargetDB PSDB /TargetSQLUsername sa /TargetSQLPassword targetPass /Users List /UserList "c:\Temp\UserList.txt" /Options Replace,IgnoreGlobal,CopyDiscovered