Windows PowerShell と WMI を使用した UE-V 2.1 SP1 エージェントとパッケージの管理
Windows Management Instrumentation (WMI) と Windows PowerShell を使用して、Microsoft User Experience Virtualization (UE-V) 2.1 SP1 エージェントの構成と同期の動作を管理できます。 UE-V PowerShell コマンドレットの完全な一覧については、「 MDOP コマンドレット リファレンス」を参照してください。
Windows PowerShell を使用して UE-V エージェントをデプロイするには
アクセス可能なネットワーク共有で UE-V インストーラー ファイルをステージングします。
注
AgentSetup.exe を使用して、UE-V エージェントの 32 ビット バージョンと 64 ビット バージョンの両方をデプロイします。 Windows インストーラー パッケージ (AgentSetupx86.msi と AgentSetupx64.msi) は、アーキテクチャごとに使用できます。 インストール ファイルを使用して後で UE-V エージェントをアンインストールするには、同じファイルの種類を使用する必要があります。
UE-V エージェントをインストールするには、次のいずれかの Windows PowerShell コマンドを使用します。
& 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%
Windows PowerShell を使用して UE-V エージェントを構成するには
Windows PowerShell ウィンドウを開きます。 Computer パラメーターを使用して、コンピューターのすべてのユーザーに影響を与えるコンピューター設定を管理するには、管理者権限を持つアカウントでウィンドウを開きます。
エージェントを構成するには、次の Windows PowerShell コマンドを使用します。
| Windows PowerShell コマンド | 説明 |
|---|---|
Get-UevConfiguration |
有効な UE-V エージェント設定を取得します。 ユーザー固有の設定は、コンピューターの設定よりも優先されます。 |
Get-UevConfiguration -CurrentComputerUser |
現在のユーザーのみの UE-V エージェント設定の値を取得します。 |
Get-UevConfiguration -Computer |
コンピューター上のすべてのユーザーの UE-V エージェント構成設定の値を取得します。 |
Get-UevConfiguration -Details |
各構成設定の詳細を取得します。 設定が構成されている場所、または既定値を使用する場合に表示されます。 現在の設定が有効な場合に表示されます。 |
Set-UevConfiguration -Computer -ContactITDescription <IT description> |
ヘルプ リンクの会社設定センターに表示されるテキストを設定します。 |
Set-UevConfiguration -Computer -ContactITUrl <string> |
ヘルプ リンクの会社設定センターのリンクの URL を設定します。 任意の URL プロトコルを使用できます。 |
Set-UevConfiguration -Computer -EnableDontSyncWindows8AppSettings |
コンピューター上のすべてのユーザーの Windows アプリを同期しないように UE-V エージェントを構成します。 |
Set-UevConfiguration -CurrentComputerUser -EnableDontSyncWindows8AppSettings |
現在のコンピューター ユーザーの Windows アプリを同期しないように UE-V エージェントを構成します。 |
Set-UevConfiguration -Computer -EnableFirstUseNotification |
コンピューター上のすべてのユーザーに対してエージェントが初めて実行された場合に通知を表示するように UE-V エージェントを構成します。 |
Set-UevConfiguration -Computer -DisableFirstUseNotification |
コンピューター上のすべてのユーザーに対してエージェントが初めて実行された場合に通知を表示しないように UE-V エージェントを構成します。 |
Set-UevConfiguration -Computer -EnableSettingsImportNotify |
設定の同期が遅れたときにコンピューター上のすべてのユーザーに通知するように UE-V エージェントを構成します。 DisableSettingsImportNotify パラメーターを使用して、通知を無効にします。 |
Set-UevConfiguration -CurrentComputerUser -EnableSettingsImportNotify |
設定の同期が遅延したときに現在のユーザーに通知するように UE-V エージェントを構成します。 DisableSettingsImportNotify パラメーターを使用して、通知を無効にします。 |
Set-UevConfiguration -Computer -EnableSyncUnlistedWindows8Apps |
コンピューターのすべてのユーザーについて、Windows アプリの一覧で明示的に無効になっていないすべての Windows アプリを同期するように UE-V エージェントを構成します。
DisableSyncUnlistedWindows8Apps パラメーターを使用して、Windows アプリ 一覧で明示的に有効になっている Windows アプリのみを同期するように UE-V エージェントを構成します。 |
Set-UevConfiguration -CurrentComputerUser -EnableSyncUnlistedWindows8Apps |
コンピューター上の現在のユーザーの Windows アプリの一覧で明示的に無効になっていないすべての Windows アプリを同期するように UE-V エージェントを構成します。
DisableSyncUnlistedWindows8Apps パラメーターを使用して、Windows アプリ 一覧で明示的に有効になっている Windows アプリのみを同期するように UE-V エージェントを構成します。 |
Set-UevConfiguration -Computer -DisableSync |
コンピューター上のすべてのユーザーに対して UE-V を無効にします。 EnableSync パラメーターを使用して、有効または再び有効にします。 |
Set-UevConfiguration -CurrentComputerUser -DisableSync |
コンピューター上の現在のユーザーの UE-V を無効にします。 EnableSync パラメーターを使用して、有効または再び有効にします。 |
Set-UevConfiguration -Computer -EnableTrayIcon |
コンピューターのすべてのユーザーの通知領域で UE-V アイコンを有効にします。 DisableTrayIcon パラメーターを使用して、アイコンを無効にします。 |
Set-UevConfiguration -Computer -MaxPackageSizeInBytes <size in bytes> |
設定パッケージ ファイルのサイズがコンピューター上のすべてのユーザーに対して定義されたしきい値に達したときに報告するように UE-V エージェントを構成します。 しきい値パッケージ サイズをバイト単位で設定します。 |
Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes <size in bytes> |
設定パッケージ ファイルのサイズが定義されたしきい値に達したときに報告するように UE-V エージェントを構成します。 現在のユーザーのパッケージ サイズの警告しきい値を設定します。 |
Set-UevConfiguration -Computer -SettingsImportNotifyDelayInSeconds |
コンピューターのすべてのユーザーに対してユーザーに通知されるまでの時間を秒単位で指定します。 |
Set-UevConfiguration -CurrentComputerUser -SettingsImportNotifyDelayInSeconds |
現在のユーザーの通知が送信されるまでの時間を秒単位で指定します。 |
Set-UevConfiguration -Computer -SettingsStoragePath <path to settings storage location> |
コンピューターのすべてのユーザーのコンピューターごとの設定の保存場所を定義します。 |
Set-UevConfiguration -CurrentComputerUser -SettingsStoragePath <path to settings storage location> |
ユーザーごとの設定の保存場所を定義します。 |
Set-UevConfiguration -Computer -SettingsTemplateCatalogPath <path to catalog> |
コンピューターのすべてのユーザーの設定テンプレート カタログ パスを設定します。 |
Set-UevConfiguration -Computer -SyncMethod <sync method> |
コンピューターのすべてのユーザーの同期方法 (SyncProvider または None) を設定します。 |
Set-UevConfiguration -CurrentComputerUser -SyncMethod <sync method> |
現在のユーザーの同期方法 (SyncProvider または None) を設定します。 |
Set-UevConfiguration -Computer -SyncTimeoutInMilliseconds <timeout in milliseconds> |
コンピューターのすべてのユーザーの同期タイムアウトをミリ秒単位で設定します。 |
Set-UevConfiguration -CurrentComputerUser -SyncTimeoutInMilliseconds <timeout in milliseconds> |
現在のユーザーの同期タイムアウトを設定します。 |
Clear-UevConfiguration -Computer -<setting name> |
コンピューター上のすべてのユーザーの指定した設定をクリアします。 |
Clear-UevConfiguration -CurrentComputerUser -<setting name> |
現在のユーザーに対してのみ指定した設定をクリアします。 |
Export-UevConfiguration <settings migration file> |
UE-V コンピューターの構成を設定移行ファイルにエクスポートします。 ファイル名拡張子は .uevする必要があります。
Export コマンドレットは、Computer パラメーターで構成可能なすべての UE-V エージェント設定をエクスポートします。 |
Import-UevConfiguration <settings migration file> |
設定の移行ファイルから UE-V コンピューターの構成をインポートします。 ファイル名拡張子は .uevする必要があります。 |
Windows PowerShell を使用して UE-V パッケージ設定をエクスポートし、UE-V テンプレートを修復するには
管理者として Windows PowerShell ウィンドウを開きます。
エージェントを構成するには、次の Windows PowerShell コマンドを使用します。
Windows PowerShell コマンド 説明 MicrosoftCalculator6.pkgx の Export-UevPackage Microsoft Calculator パッケージ ファイルから設定を抽出し、XML で人間が判読できる形式に変換します。 Repair-UevTemplateIndex UE-V 設定の場所テンプレートのインデックスを修復します。
WMI を使用して UE-V エージェントを構成するには
User Experience Virtualization には、次の WMI コマンドのセットが用意されています。 管理者はこのインターフェイスを使用して、コマンド ラインで UE-V エージェントを構成し、一般的な構成タスクを自動化できます。
管理者権限を持つアカウントを使用して、Windows PowerShell ウィンドウを開きます。
次の WMI コマンドを使用して、エージェントを構成します。
Windows PowerShell コマンド 説明 Get-WmiObject -Namespace root\Microsoft\UEV Configurationアクティブな UE-V エージェント設定を表示します。 ユーザー固有の設定は、コンピューターの設定よりも優先されます。 Get-WmiObject -Namespace root\Microsoft\UEV UserConfigurationユーザーに対して定義されている UE-V エージェント構成を表示します。 Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfigurationコンピューターに対して定義されている UE-V エージェント構成を表示します。 Get-WmiObject -Namespace root\Microsoft\Uev ConfigurationItem各構成項目の詳細を表示します。 $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration$config.SettingsStoragePath = <path_to_settings_storage_location>$config.Put()コンピューターごとの設定の保存場所を定義します。 $config = Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration$config.SettingsStoragePath = <path_to_settings_storage_location>$config.Put()ユーザーごとの設定の保存場所を定義します。 $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration$config.SyncTimeoutInMilliseconds = <timeout_in_milliseconds>$config.Put()コンピューターのすべてのユーザーの同期タイムアウトをミリ秒単位で設定します。 $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration$config.MaxPackageSizeInBytes = <size_in_bytes>$config.Put()設定パッケージ ファイルのサイズが定義されたしきい値に達したときに報告するように UE-V エージェントを構成します。 コンピューターのすべてのユーザーのしきい値パッケージ ファイル サイズをバイト単位で設定します。 $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration$config.SyncMethod = <sync_method>$config.Put()コンピューターのすべてのユーザーの同期方法 (SyncProvider または None) を設定します。 $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration$config.<setting name> = $true$config.Put()コンピューターごとの特定の設定を有効にするには、設定をクリアし、 設定値として $null を使用します。 ユーザーごとの設定には UserConfiguration を使用します。 $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration$config.<setting name> = $false$config.Put()特定のコンピューターごとの設定を無効にするには、設定をクリアし、 設定値として $null を使用します。 ユーザーごとの設定にはユーザー構成を使用します。 $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration$config.<setting name> = <setting value>$config.Put()特定のコンピューターごとの設定を更新します。 設定をクリアするには、設定値として $null を使用します。 $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration$config.<setting name> = <setting value>$config.Put()コンピューターのすべてのユーザーの特定のユーザーごとの設定を更新します。 設定をクリアするには、設定値として $null を使用します。
WMI と Windows PowerShell を使用して UE-V エージェントを構成すると、定義された構成は次の場所のレジストリに格納されます。
\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\UEV\Agent\Configuration
\HKEY_CURRENT_USER\SOFTWARE\Microsoft\UEV\Agent\Configuration
WMI を使用して UE-V パッケージ設定をエクスポートし、UE-V テンプレートを修復するには
UE-V には、次の WMI コマンドのセットが用意されています。 管理者は、このインターフェイスを使用して、パッケージをエクスポートしたり、UE-V テンプレートを修復したりできます。
次の WMI コマンドを使用します。
WMI コマンド 説明 Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserSettings -Name ExportPackage -ArgumentList <package name>パッケージ ファイルから設定を抽出し、XML で人間が判読できる形式に変換します。 Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name RebuildIndexUE-V 設定の場所テンプレートのインデックスを修復します。 管理者として実行する必要があります。