Windows PowerShell と WMI による UE-V 2.x Agent とパッケージの管理

  • [アーティクル]

適用対象: User Experience Virtualization 2.0, User Experience Virtualization 2.1

Windows Management Instrumentation (WMI) と Windows PowerShell を使用して、Microsoft User Experience Virtualization (UE-V) 2.0、2.1、および 2.1 SP1 Agent 構成および同期動作を管理できます。UE-V PowerShell コマンドレットの詳細なリストについては、UE-V 2 コマンドレット リファレンス に関するページ (https://go.microsoft.com/fwlink/?LinkId=393495) をご覧ください。

Windows PowerShell を使用して UE-V Agent を展開するには

  1. アクセスできるネットワーク共有に UE-V インストーラー ファイルを配置します。

    注意

    AgentSetup.exe を使用して、32 ビット バージョンと 64 ビット バージョン両方の UE-V Agent を展開します。各アーキテクチャに合わせて、AgentSetupx86.msi と AgentSetupx64.msi という Windows インストーラー パッケージを使用できます。インストール ファイルを使用して後で UE-V Agent をアンインストールするには、同じファイルの種類を使用する必要があります。

  2. 次のいずれかの Windows PowerShell コマンドを使用して UE-V Agent をインストールします。

    • & 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 Agent を構成するには

  1. Windows PowerShell ウィンドウを開きます。Computer パラメーターを使用してコンピューターのすべてのユーザーに影響を与えるコンピューター設定を管理するには、管理者権限を持つアカウントでウィンドウを開きます。

  2. 次の Windows PowerShell コマンドを使用してエージェントを構成します。

    Windows PowerShell コマンド 説明

    Get-UevConfiguration

    効果的な UE-V Agent 設定を取得します。ユーザー固有の設定は、コンピューター設定よりも優先されます。

    Get-UevConfiguration - CurrentComputerUser

    現在のユーザーについてのみ、UE-V Agent 設定値を取得します。

    Get-UevConfiguration -Computer

    コンピューター上のすべてのユーザーについて、UE-V Agent の構成設定値を取得します。

    Get-UevConfiguration -Details

    各構成設定の詳細を取得します。設定が構成されている場所、または既定値を使用しているかどうかが表示されます。現在の設定が有効な場合に表示されます。

    Set-UevConfiguration -Computer –ContactITDescription <IT description>

    会社設定センターのヘルプ リンクに表示されるテキストを設定します。

    Set-UevConfiguration -Computer -ContactITUrl <string>

    会社設定センターのヘルプ リンクのリンク URL を設定します。任意の URL プロトコルを使用できます。

    Set-UevConfiguration -Computer –EnableDontSyncWindows8AppSettings

    コンピューター上のすべてのユーザーの Windows アプリを同期しないように UE-V Agent を構成します。

    Set-UevConfiguration -CurrentComputerUser – EnableDontSyncWindows8AppSettings

    コンピューターの現在のユーザーの Windows アプリを同期しないように UE-V Agent を構成します。

    Set-UevConfiguration -Computer –EnableFirstUseNotification

    コンピューター上のすべてのユーザーについて、初めてエージェントを実行するときに通知を表示するように UE-V Agent を構成します。

    Set-UevConfiguration -Computer –DisableFirstUseNotification

    コンピューター上のすべてのユーザーについて、初めてエージェントを実行するときに通知を表示しないように UE-V Agent を構成します。

    Set-UevConfiguration -Computer –EnableSettingsImportNotify

    設定の同期が遅延されるときに、コンピューター上のすべてのユーザーに通知するように UE-V Agent を構成します。

    通知を無効にするには、DisableSettingsImportNotify パラメーターを使用します。

    Set-UevConfiguration - CurrentComputerUser -EnableSettingsImportNotify

    設定の同期が遅延されるときに、現在のユーザーに通知するように UE-V Agent を構成します。

    通知を無効にするには、DisableSettingsImportNotify パラメーターを使用します。

    Set-UevConfiguration -Computer –EnableSyncUnlistedWindows8Apps

    コンピューターのすべてのユーザーについて、Windows アプリ一覧で明示的に無効にされていないすべての Windows アプリを同期するように UE-V Agent を構成します。詳細については、「Windows PowerShell および WMI を使用して UE-V 2.x 設定場所テンプレートを管理する」の「Get-UevAppxPackage」をご覧ください。

    Windows アプリ一覧で明示的に有効にされている Windows アプリのみを同期するように UE-V Agent を構成するには、DisableSyncUnlistedWindows8Apps パラメーターを使用します。

    Set-UevConfiguration - CurrentComputerUser - EnableSyncUnlistedWindows8Apps

    コンピューターの現在のユーザーについて、Windows アプリ一覧で明示的に無効にされていないすべての Windows アプリを同期するように UE-V Agent を構成します。詳細については、「Windows PowerShell および WMI を使用して UE-V 2.x 設定場所テンプレートを管理する」の「Get-UevAppxPackage」をご覧ください。

    Windows アプリ一覧で明示的に有効にされている Windows アプリのみを同期するように UE-V Agent を構成するには、DisableSyncUnlistedWindows8Apps パラメーターを使用します。

    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 Agent を構成します。しきい値のパッケージ サイズ (バイト) を設定します。

    Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes <size in bytes>

    設定パッケージ ファイルのサイズが定義したしきい値に達したときに報告するように UE-V Agent を構成します。現在のユーザーについて、しきい値を警告するパッケージ サイズを設定します。

    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 Agent 設定がエクスポートされます。

    Import-UevConfiguration <settings migration file>

    UE-V コンピューター構成を設定移行ファイルからインポートします。ファイル名の拡張子は .uev にする必要があります。

Windows PowerShell を使用して UE-V パッケージ設定をエクスポートして UE-V テンプレートを修復するには

  1. 管理者として Windows PowerShell ウィンドウを開きます。

  2. 次の Windows PowerShell コマンドを使用してエージェントを構成します。

    Windows PowerShell コマンド

    説明

    Export-UevPackage MicrosoftCalculator6.pkgx

    Microsoft Calculator パッケージ ファイルの設定を抽出し、人が読める XML 形式に変換します。

    Repair-UevTemplateIndex

    UE-V 設定場所テンプレートのインデックスを修復します。

WMI を使用して UE-V Agent を構成するには

  1. User Experience Virtualization には、次の WMI コマンドがあります。管理者は、このインターフェイスを使用して、コマンド ラインで UE-V Agent を構成し、通常の構成タスクを自動化することができます。

    管理者権限があるアカウントを使用して、Windows PowerShell ウィンドウを開きます。

  2. 次の WMI コマンドを使用してエージェントを構成します。

    Windows PowerShell command 説明

    Get-WmiObject -Namespace root\Microsoft\UEV Configuration

    アクティブな UE-V Agent 設定を表示します。ユーザー固有の設定は、コンピューター設定よりも優先されます。

    Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration

    ユーザー用に定義されている UE-V Agent 構成を表示します。

    Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    コンピューター用に定義されている UE-V Agent 構成を表示します。

    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 Agent を構成します。コンピューターのすべてのユーザーについて、しきい値のパッケージ ファイル サイズ (バイト) を設定します。

    $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 を使用します。ユーザーごとの設定の場合、User Configuration を使用します。

    $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.< 設定名> = <設定値>

    $config.Put()

    コンピューターのすべてのユーザーについて、特定のユーザーごとの設定を更新します。設定をクリアするには、設定値として $null を使用します。

    WMI および Windows PowerShell による UE-V Agent の構成の場合、定義した構成は次の場所のレジストリに保存されます。

    \HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\UEV\Agent\Configuration

    \HKEY_CURRENT_USER\SOFTWARE\Microsoft\UEV\Agent\Configuration

WMI を使用して UE-V パッケージ設定をエクスポートして UE-V テンプレートを修復するには

  1. UE-V には、次の WMI コマンドがあります。管理者は、このインターフェイスを使用して、パッケージをエクスポートしたり、UE-V テンプレートを修復したりすることができます。

  2. 次の 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 RebuildIndex

    UE-V 設定場所テンプレートのインデックスを修復します。管理者として実行する必要があります。

    UE-V への提案はございますか。 こちらから提案を追加するか、提案に投票してください。
    UE-V に関する問題がありますか。「UE-V に関する TechNet フォーラム」を利用してください。

関連項目

その他の参照情報

Windows PowerShell および WMI による UE-V 2.x の管理
UE-V 2.x の管理