PowerShell-Schnittstelle für die Profilmigration

In diesem Abschnitt werden folgende Themen behandelt:

Wissenswertes über die PowerShell-Schnittstelle für die Profilmigration

Für die Profilmigration können Skripte geschrieben werden, um Anwendungs- oder Anwendungsgruppendaten zwischen der Datenbank und dem Windows-Profil auf dem Client zu importieren und zu exportieren.

Wir empfehlen, die Profilmigration über die Environment Manager-Personalisierungskonsole zu konfigurieren. Das Cmdlet sollte nur verwendet werden, wenn eine Feinsteuerung erforderlich ist, um einzelne Anwendungen oder Anwendungsgruppen zu migrieren, etwa wenn Daten von nicht gruppierten Anwendungen in Anwendungsgruppen verschoben werden sollen. Das Cmdlet kann bei der sorgfältigen Migration von Profildaten helfen, etwa wenn mehrere Versionen von Microsoft Office gleichzeitig in der Umgebung eingesetzt werden.

Um Daten von nicht gruppierten Anwendungen in Anwendungsgruppen zu migrieren, exportieren Sie die Anwendung in das lokale Profil und importieren Sie es dann in eine Anwendungsgruppe.

Das PowerShell-Cmdlet verhält sich folgendermaßen:

  • Es wird nur unterstützt, wenn auf dem Personalisierungsserver die Profilmigration nicht aktiviert ist.
  • Die Migration findet so oft statt, wie das Cmdlet ausgeführt wird. Der Status wird nicht aufgezeichnet und es liegt in der Zuständigkeit des Administrators, dass es nur nach Bedarf verwendet wird.
  • Um die Datenintegrität sicherzustellen, findet die Migration nur statt, wenn keine Instanz der Anwendung für die angegebene Anwendung oder Anwendungsgruppe ausgeführt wird.
  • Fehler werden dadurch dargestellt, dass nach der Ausführung eine Ausnahme erhoben wird.

Hilfe

Weitergehende Hilfe können Sie mit dem folgenden Befehl aufrufen:

get-help <Cmdlet-Name>

Laden des PowerShell-Moduls für die Profilmigration

Das Modul wird im Verzeichnis des Environment Manager Agents installiert. Laden Sie das PowerShell-Modul mit folgendem Befehl:

Import-Module "C:\Programme\AppSense\Environment Manager\Agent\EmCmdlet.dll"

Wenn Sie das Standardinstallationsverzeichnis geändert haben, passen Sie den Dateipfad entsprechend an.

Verwenden Sie alternativ den folgenden Befehl, um das PowerShell-Modul aus dem aktuellen Installationsverzeichnis zu laden:

Import-Module ((Get-ItemProperty 'HKLM:\SOFTWARE\AppSense\Environment Manager').ClientPath + 'EmCmdlet.dll'

Importieren von Profilen mithilfe der PowerShell-Schnittstelle für die Profilmigration

Das Cmdlet Import-EMPManagedAppData führt eine Migration der Profildaten aus dem Windows-Profil in das Profil einer verwalteten Anwendung durch.

Die konfigurierten Registrierungs-, Ordner- und Dateiein- und -ausschlüsse der verwalteten Anwendung werden als die Speicherorte verwendet, aus denen Daten importiert werden.

Das Windows-Profil kann entweder ein lokales Profil oder ein Roamingprofil sein, das an einem Netzwerkort gespeichert ist.

Es stehen folgende Parameter zur Verfügung:

Parameter Beschreibung
-App (Pflicht) Der Name der verwalteten Anwendung oder Anwendungsgruppe, für die der Import erfolgt. Das ist der Anzeigename wie in der Personalisierungskonsole angegeben.
-ProfilePath (optional) Der Pfad zum Windows-Profil, das als Datenquelle und Alternative zum Import vom lokalen Profil verwendet werden soll. Dieser Pfad darf sich nicht auf eine bestimmte Windows-Profilversion beziehen und darf daher kein Versionssuffix enthalten. Ein Profilpfad wie \\server\share\user1.V2 muss zum Beispiel als \\server\share\user1 eingegeben werden. Es werden nur Profilversionen unterstützt, die dem aktuellen Betriebssystem oder seinen früheren Versionen entsprechen. Es kann zum Beispiel nicht aus einem Windows 10-Profil importiert werden, wenn auf dem Rechner Windows 7 läuft. Am konfigurierten Speicherort wird ein entsprechendes Profil ausgewählt, indem nach einer Version gesucht wird, die dem aktuellen Betriebssystem entspricht. Wird kein passendes Profil gefunden, wird eine frühere Profilversion verwendet. Die Nutzung von Umgebungsvariablen speziell für die aktuelle Benutzersitzung wird unterstützt.
-ProfileAppDataPath (optional, wenn ProfilePath angegeben wird) Beim Import aus einem Netzwerkprofil kann dieser Parameter verwendete werden, um den Pfad zum Verzeichnis mit den Roaming AppData anzugeben, wenn dieser nicht zum Speicherort des Benutzerprofils gehört. Die Nutzung von Umgebungsvariablen speziell für die aktuelle Benutzersitzung wird unterstützt.
-Merge (optionaler Switch) Wenn angegeben, führt die Aktion die personalisierten Daten mit dem Windows-Profil zusammen. Die personalisierten Daten haben Vorrang und werden nicht ersetzt. Wenn nicht angegeben, löscht die Aktion die vorhandenen Profildaten, bevor der Import ausgeführt wird.
-Verbose (optionaler Switch) Liefert ausführliche Ausgabedaten des PowerShell-Befehls zu Diagnosezwecken.

Wenn Anwendungsprofile mithilfe des Befehls Import-EMPManagedAppData importiert werden, werden im verwalteten Anwendungsprofil des Benutzers und im lokalen AppSensevirtual-Cache HIVE-Dateien erstellt. Dies ist das festgelegte Verhalten, unabhängig davon, ob die erweiterte Einstellung "UpgradeFBRtohive" auf "true" oder "false" gesetzt ist. Ist sie auf "false" gesetzt, verwenden verwaltete Anwendungen weiterhin die FBR-Methode zum Virtualisieren und Synchronisieren der Daten. Wenn jedoch HIVE-Dateien im verwalteten Anwendungsprofil des Benutzers vorhanden sind, werden die in der synchronisierten FBR-Datei enthaltenen Daten in der Personalisierungsanalyse von Environment Manager nicht angezeigt. Daher sieht es so aus, als wären Anwendungen nicht synchronisiert.

Um die PowerShell-Schnittstelle für die Profilmigration weiter zu verwenden, muss die erweiterte Einstellung "UpgradeFBRtohive" auf "true" gesetzt sein.

Wenn Sie die HIVE-Dateien nicht weiter verwenden möchten, sollten sie mithilfe des Skripts im Dokument DOC-62059 der Ivanti Community gelöscht werden.

Weitere Informationen zur Einstellung "UpgradeFBRtohive" finden Sie unter Erweiterte Einstellungen.

Beispiele

Im Folgenden finden Sie ein Beispiel für den Import von Daten aus dem lokalen Windows-Profil für die verwaltete Anwendung Notepad:

Import-Module ((Get-ItemProperty 'HKLM:\SOFTWARE\AppSense\Environment Manager').ClientPath + 'EmCmdlet.dll')

Import-EMPManagedAppData -App Notepad

Nachfolgend finden Sie ein Beispiel, das in einer benutzerdefinierten Bedingung der Environment Manager-Richtlinie verwendet werden könnte, bei der das Exit-Skript zum Bestimmen des Bedingungsergebnisses verwendet wird:

try

{

    Import-Module ((Get-ItemProperty 'HKLM:\SOFTWARE\AppSense\Environment Manager').ClientPath + 'EmCmdlet.dll')

    Import-EMPManagedAppData -App Notepad

}

catch

{

    # Exit with an error

    [System.Environment]::Exit(1)

}

Exportieren von Profilen mithilfe der PowerShell-Schnittstelle für die Profilmigration

Das Cmdlet Export-EMPManagedAppData führt eine Migration der Profildaten aus einer verwalteten Anwendung oder Anwendungsgruppe zurück in das Windows-Profil durch.

Es stehen folgende Parameter zur Verfügung:

Parameter Beschreibung

-App

(Pflicht)

 Der Name der verwalteten Anwendung oder Anwendungsgruppe, für die der Export erfolgt. Das ist der Anzeigename wie in der Personalisierungskonsole angegeben.

-Verbose

(optionaler Switch)

 Liefert ausführliche Ausgabedaten des PowerShell-Befehls zu Diagnosezwecken.

Verwandte Themen

Profilmigration