Freigeben über


Bereitstellen von UE-V-Agent

Der Microsoft User Experience Virtualization-Agent (UE-V) muss auf jedem Computer ausgeführt werden, der UE-V zum Roaming von Anwendungs- und Windows-Einstellungen verwendet. Eine einzelne Installationsdatei, AgentSetup.exe, installiert den UE-V-Agent auf 32-Bit- und 64-Bit-Betriebssystemen. Die Befehlszeilenparameter des UE-V-Agents lauten wie folgt:

AgentSetup.exe Befehlszeilenparameter

Befehlszeilenparameter Definition Anmerkungen

/help oder /h oder /?

Zeigt das Dialogfeld AgentSetup.exe Verwendung an.

SettingsStoragePath

Gibt den UNC-Pfad (Universal Naming Convention) an, der definiert, wo Einstellungen gespeichert werden.

Die Umgebungsvariablen %username% oder %computername% werden akzeptiert. Skripts erfordern möglicherweise Escapevariablen.

Standard: <keine> (Active Directory-Benutzerstart)

SettingsTemplateCatalogPath

Gibt den UNC-Pfad (Universal Naming Convention) an, der den Speicherort definiert, der auf neue Einstellungsspeicherortvorlagen überprüft wurde.

Nur für benutzerdefinierte Einstellungsspeicherortvorlagen erforderlich

RegisterMSTemplates

Gibt an, ob die standardmäßigen Microsoft-Vorlagen während der Installation registriert werden sollen.

True | FALSE

Standard: True

SyncMethod

Gibt an, welche Synchronisierungsmethode verwendet werden soll.

OfflineFiles-| Nichts

Standard: OfflineFiles

SyncTimeoutInMilliseconds

Gibt die Anzahl von Millisekunden an, die der Computer vor dem Timeout wartet, wenn benutzereinstellungen vom Speicherort der Einstellungen abgerufen werden.

Standard: 2000 Millisekunden

(Bis zu 2 Sekunden warten)

SyncEnabled

Gibt an, ob die UE-V-Synchronisierung aktiviert oder deaktiviert ist.

True | FALSE

Standard: True

MaxPackageSizeInBytes

Gibt die Größe einer Einstellungspaketdatei in Byte an, wenn der UE-V-Agent meldet, dass Dateien den Schwellenwert überschreiten.

<Größe>

Standard: keine (kein Warnschwellenwert)

CEIPEnabled

Gibt die Einstellung für die Teilnahme am Programm zur Verbesserung der Benutzerfreundlichkeit an. Wenn dieser Wert auf "true" festgelegt ist, werden die Installationsinformationen auf die Website des Microsoft-Programms zur Verbesserung der Benutzerfreundlichkeit hochgeladen. Wenn dieser Wert auf "false" festgelegt ist, werden keine Informationen hochgeladen.

True | FALSE

Standard: False

Unter Windows 7: True

Während der Installation gibt der SettingsStoragePath-Befehlszeilenparameter den Speicherort der Einstellungen für die Einstellungswerte an. Vor der Bereitstellung des UE-V-Agents kann ein Einstellungsspeicherort definiert werden. Wenn kein Einstellungsspeicherort definiert ist, verwendet UE-V das Active Directory-Benutzer-Startverzeichnis als Einstellungsspeicherort. Wenn Sie die SettingsStoragePath-Konfiguration während des Setups angeben und den %username% als Teil des Werts verwenden, wird auf allen Computern oder Sitzungen, bei denen sich ein Benutzer anmeldet, dieselbe Benutzereinstellungserfahrung verwendet. Wenn Sie die Variablen %username%\%computername% als Teil des SettingsStoragePath-Werts angeben, bleibt die Einstellungsoberfläche für jeden Computer erhalten.

Zusätzlich zum kombinierten 32-Bit- und 64-Bit-Installationsprogramm werden architekturspezifische Windows Installer-Dateien (.msi) für die UE-V-Agent-Installation bereitgestellt. Die AgentSetupx86.msi- oder AgentSetupx64.msi-Installationsdateien sind kleiner als die AgentSetup.exe-Datei und können die Agentbereitstellungen optimieren. Die Befehlszeilenparameter für das AgentSetup.exe-Installationsprogramm werden für die Installation von Windows Installer (.msi) unterstützt.

Hinweis Während der Installation oder Deinstallation des UE-V-Agents können Sie entweder die AgentSetup.exe-Datei oder den AgentSetup-Bogen<>.msi Datei verwenden, aber nicht beides. Dieselbe Datei muss zum Deinstallieren des UE-V-Agents verwendet werden, wie sie zum Installieren des UE-V-Agents verwendet wurde.

Achten Sie beim Installieren des UE-V-Agents darauf, das richtige Variablenformat zu verwenden. Die folgende Tabelle enthält Beispiele für Bereitstellungsoptionen für die Verwendung der AgentSetup.exe- oder Windows Installer-Installationsdateien (.msi).

Bereitstellungstyp Bereitstellungsbeschreibung Beispiel

Eingabeaufforderung

Wenn Sie den UE-V-Agent über eine Eingabeaufforderung installieren, verwenden Sie das Variablenformat %^username%. Wenn Aufgrund von Leerzeichen im Einstellungsspeicherpfad Anführungszeichen erforderlich sind, verwenden Sie eine Batchskriptdatei für die Bereitstellung.

AgentSetup.exe /quiet /norestart /log "%temp%\UE-VAgentInstaller.log" SettingsStoragePath=\server\settingsshare%^username%

msiexec.exe /i "<path to msi file>" /quiet /norestart /lv "%temp%\UE-VAgentInstaller.log" SettingsStoragePath=\server\settingsshare%^username%

Batchskript

Wenn Sie den UE-V-Agent aus einer Batchskriptdatei installieren, verwenden Sie das Variablenformat %%username%%%. Wenn Sie diese Installationsmethode verwenden, müssen Sie die Variable mit den Zeichen %% escapen. Ohne dieses Zeichen erweitert das Skript die Benutzernamenvariable zur Installationszeit und nicht zur Laufzeit, wodurch UE-V einen einzigen Einstellungsspeicherort für alle Benutzer verwendet.

AgentSetup.exe /quiet /norestart /log "%temp%\UE-VAgentInstaller.log" SettingsStoragePath="\server\settingsshare%%username%%"

msiexec.exe /i "<Pfad zur MSI-Datei>" /quiet /norestart /lv "%temp%\UE-VAgentInstaller.log" SettingsStoragePath="\server\settingsshare%%username%%"

PowerShell

Wenn Sie den UE-V-Agent über eine PowerShell-Eingabeaufforderung oder ein PowerShell-Skript installieren, verwenden Sie das Variablenformat %username%.

& AgentSetup.exe /quiet /norestart /log "%temp%\UE-VAgentInstaller.log" SettingsStoragePath=\server\settingsshare%username%

& msiexec.exe /i "<path to msi file>" /quiet /norestart /lv "%temp%\UE-VAgentInstaller.log" SettingsStoragePath=\server\settingsshare%username%

Elektronische Softwareverteilung, z. B. Bereitstellung von Configuration Manager Softwarebereitstellung)

Wenn Sie den UE-V-Agent mit Configuration Manager installieren, verwenden Sie das Variablenformat ^%username^%.

AgentSetup.exe /quiet /norestart /log "%temp%\UE-VAgentInstaller.log" SettingsStoragePath=\server\settingsshare^%username^%

msiexec.exe /i "<Pfad zur MSI-Datei>" /quiet /norestart /lv "%temp%\UE-VAgentInstaller.log" SettingsStoragePath=\server\settingsshare^%username^%

Hinweis Die Installation des U-EV-Agents erfordert Administratorrechte, und der Computer erfordert einen Neustart, bevor der UE-V-Agent ausgeführt werden kann.

UE-V-Agent-Bereitstellungsmethoden aus einer Netzwerkfreigabe

Sie können die folgenden Methoden verwenden, um den UE-V-Agent bereitzustellen:

  • Eine ESD-Lösung (Electronic Software Distribution), die eine Windows Installer-Datei (.msi) installieren kann.

  • Ein Installationsskript, das auf die Windows Installer-Datei (.msi) verweist, die zentral auf einer Freigabe gespeichert ist.

  • Manuelles Ausführen des Installationsprogramms auf dem Computer.

Führen Sie die folgenden Schritte aus, um den UE-V-Agent über eine Netzwerkfreigabe bereitzustellen:

So installieren und konfigurieren Sie den UE-V-Agent über eine Netzwerkfreigabe

  1. Bereitstellen der UE-V-Agent-Installationsdatei (AgentSetup.exe) auf einer Netzwerkfreigabe, für die Benutzer über die Berechtigung "Lesen" verfügen.

  2. Stellen Sie ein Skript auf Benutzercomputern bereit, auf denen der UE-V-Agent installiert wird. Das Skript sollte den Speicherort der Einstellungen angeben.

Aktualisieren des UE-V-Agents

Aktualisierungen für die UE-V-Agent-Software wird über Microsoft Update bereitgestellt. Während eines UE-V-Agent-Upgrades kann die Standardgruppe von Einstellungsspeicherortvorlagen für allgemeine Microsoft-Anwendungen und Windows-Einstellungen aktualisiert werden. UE-V-Agent-Updates können mithilfe der ESD-Infrastruktur (Enterprise Software Distribution) bereitgestellt werden.

Bereitstellen von UE-V 1.0

Unterstützte Konfigurationen für UE-V 1.0

Bereitstellen des Speicherorts für die Einstellungen für UE-V 1.0

Installieren von UE-V-Generator

Bereitstellen des User Experience Virtualization Agent