Bereitstellen des UE-V-Agenten

Letzte Aktualisierung: April 2013

Betrifft: User Experience Virtualization 1.0

Der Microsoft User Experience Virtualization (UE-V)-Agent muss auf jedem Computer ausgeführt werden, auf dem UE-V zum Roaming von Anwendungs- und Windows-Einstellungen verwendet wird. Mit einer einzelnen Installer-Datei, AgentSetup.exe, wird der UE-V-Agent sowohl auf 32-Bit- als auch auf 64-Bit-Betriebssystemen installiert. Für den UE-V-Agenten gibt es folgende Befehlszeilenparameter:

Befehlszeilenparameter für AgentSetup.exe

Befehlszeilenparameter Definition Hinweise

/help oder /h oder /?

Zeigt das Syntax-Dialogfeld für AgentSetup.exe 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 Variablen in Escapezeichen.

Standard: <none> (Active Directory-Benutzerbasisverzeichnis)

SettingsTemplateCatalogPath

Gibt den UNC-Pfad (Universal Naming Convention) zum Speicherort an, der für neue Einstellungsortvorlagen geprüft wurde.

Nur für benutzerdefinierte Einstellungsortvorlagen erforderlich

RegisterMSTemplates

Gibt an, ob die Microsoft-Standardvorlagen während der Installation registriert werden sollen.

True | False

Standard: True

SyncMethod

Gibt an, welche Synchronisierungsmethode verwendet werden soll.

OfflineFiles | None

Standard: OfflineFiles

SyncTimeoutInMilliseconds

Gibt die Zeit in Millisekunden an, bevor es beim Abrufen der Benutzereinstellungen vom Einstellungsspeicherort zu einem Timeout kommt.

Standard: 2000 Millisekunden

(warten Sie bis zu 2 Sekunden)

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, bei der der UE-V-Agent eine Warnung ausgibt, dass die Datei den Schwellenwert überschreitet.

<Größe>

Standard: none (kein Warnungsschwellenwert)

CEIPEnabled

Legt die Teilnahme am Programm zur Verbesserung der Benutzerfreundlichkeit fest. Wenn der Wert auf „true“ festgelegt ist, werden Installer-Informationen zur Website für das Microsoft-Programm zur Verbesserung der Benutzerfreundlichkeit hochgeladen. Wenn der Wert auf „false“ festgelegt ist, werden keine Informationen hochgeladen.

True | False

Standard: False

Der Befehlszeilenparameter „SettingsStoragePath“ gibt den Einstellungsspeicherort für die Einstellungswerte bei der Installation an. Ein Einstellungsspeicherort kann vor der Bereitstellung des UE-V-Agenten definiert werden. Wenn kein Einstellungsspeicherort definiert wird, wird von UE-V das Active Directory-Basisverzeichnis des Benutzers als Einstellungsspeicherort verwendet. Wenn Sie die SettingsStoragePath-Konfiguration während des Setups festlegen und %username% als Teil des Werts verwenden, werden dieselben Benutzereinstellungen per Roaming an alle Computer oder Sitzungen übertragen, bei denen sich der Computer anmeldet. Wenn Sie die Variablen %username%\%computername% als Teil des SettingsStoragePath-Werts angeben, werden die Einstellungen auf jedem Computer beibehalten.

Für die Installation des UE-V-Agenten stehen neben dem kombinierten 32-Bit- und 64-Bit-Installer auf architekturspezifische Windows Installer-Dateien (MSI-Dateien) zur Verfügung. Die Installationsdateien AgentSetupx86.msi und AgentSetupx64.msi sind kleiner als die Datei AgentSetup.exe und können zu einer Optimierung der Agentenbereitstellung beitragen. Die Befehlszeilenparameter für den AgentSetup.exe-Installer werden bei der Windows Installer (.msi)-Installation unterstützt.

Hinweis

Für die Installation oder Deinstallation des UE-V-Agenten können Sie entweder die Datei AgentSetup.exe oder die Datei AgentSetup<Architektur>.msi verwenden, nicht jedoch beide. Für die Deinstallation des UE-V-Agenten muss dieselbe Datei wie für die Installation des UE-V-Agenten verwendet werden.

Achten Sie darauf, dass Sie bei der Installation des UE-V-Agenten das richtige Variablenformat verwenden. Die folgende Tabelle enthält Beispiele für Bereitstellungsoptionen für die Datei AgentSetup.exe bzw. die Windows Installer (.msi)-Installationsdateien.

Bereitstellungstyp Beschreibung der Bereitstellung Beispiel

Eingabeaufforderung

Verwenden Sie das Variablenformat %^username%, wenn Sie den UE-V-Agenten über die Eingabeaufforderung installieren. Verwenden Sie eine Batchskriptdatei für die Bereitstellung, wenn aufgrund von Leerzeichen im Einstellungsspeicherpfad Anführungszeichen erforderlich sind.

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

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

Batchskript

Verwenden Sie das Variablenformat %%username%%, wenn Sie den UE-V-Agenten über eine Batchskriptdatei installieren. Wenn Sie diese Installationsmethode verwenden, müssen Sie die Variable mit den %%-Zeichen als Escapesequenz einschließen. Ohne dieses Zeichen wird die Benutzernamenvariable zur Installationszeit und nicht zur Laufzeit erweitert erweitert, was dazu führt, dass UE-V einen einzelnen Einstellungsspeicherort für alle Benutzer verwendet.

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

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

PowerShell

Verwenden Sie das Variablenformat %username%, wenn Sie den UE-V-Agenten über eine PowerShell-Eingabeaufforderung oder ein PowerShell-Skript installieren.

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

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

Elektronische Softwareverteilung, z. B. Bereitstellung über Configuration Manager Software Deployment

Verwenden Sie das Variablenformat ^%username^%, wenn Sie den UE-V-Agenten mit Configuration Manager installieren.

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

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

Hinweis

Für die Installation des U-EV-Agenten sind Administratorrechte erforderlich. Außerdem ist ein Neustart des Computers erforderlich, bevor der UE-V-Agent ausgeführt werden kann.

Bereitstellungsmethoden für den UE-V-Agenten von einer Netzwerkfreigabe

Sie können die folgenden Verfahren verwenden, um den UE-V-Agenten bereitzustellen:

  • Eine elektronische Softwareverteilung (Electronic Software Distribution, ESD), mit der eine Windows Installer (.msi)-Datei installiert werden kann.

  • Ein Installationsskript, das auf eine zentral auf einer Freigabe gespeicherte Windows Installer (.msi)-Datei verweist.

  • Manuelles Ausführen des Installationsprogramms auf dem Computer.

Führen Sie die folgenden Schritte aus, um den UE-V-Agenten von einer Netzwerkfreigabe zu bereitzustellen:

So installieren und konfigurieren Sie den UE-V-Agenten von einer Netzwerkfreigabe

  1. Stellen Sie die Installationsdatei für den UE-V-Agenten (AgentSetup.exe) auf einer Netzwerkfreigabe bereit, für die die Benutzer Leseberechtigungen haben.

  2. Stellen Sie auf den Benutzercomputern ein Skript bereit, mit dem der UE-V-Agent installiert wird. Über das Skript sollte der Einstellungsspeicherort festgelegt werden.

Aktualisieren des UE-V-Agenten

Updates für die UE-V-Agentensoftware werden über Microsoft Update zur Verfügung gestellt. Während eines UE-V-Agentenupgrades wird möglicherweise die Standardgruppe der Einstellungsortvorlagen für gebräuchliche Microsoft-Anwendungen und Windows-Einstellungen aktualisiert. UE-V-Agentenupdates können mithilfe der ESD-Infrastruktur bereitgestellt werden.

Siehe auch

Tasks

Bereitstellen von Einstellungsspeicherorten für UE-V 1.0
Installieren von UE-V Generator
Bereitstellen des UE-V-Agenten

Konzepte

Unterstützte Konfigurationen für UE-V 1.0

Andere Ressourcen

Bereitstellen von UE-V 1.0

-----
Weitere Informationen zu MDOP finden Sie in der TechNet-Bibliothek. Sie können auch im TechNet Wiki nach Problembehandlungen suchen und uns auf Facebook oder Twitter folgen.
-----