Windows PowerShell と WMI を使用した UE-V 2.x 設定の場所テンプレートの管理
Microsoft User Experience Virtualization (UE-V) 2.0、2.1、および 2.1 SP1 では、XML 設定の場所テンプレートを使用して、User Experience Virtualization がキャプチャして適用する設定を定義します。 UE-V には、一連の標準設定の場所テンプレートが含まれています。 また、カスタム設定の場所テンプレートを作成できる UE-V ジェネレーター ツールも含まれています。 設定の場所テンプレートを作成して展開した後は、Windows PowerShell と Windows Management Instrumentation (WMI) を使用してこれらのテンプレートを管理できます。 UE-V PowerShell コマンドレットの完全な一覧については、「 UE-V 2 コマンドレット リファレンス (https://go.microsoft.com/fwlink/p/?LinkId=393495)」を参照してください。
Windows PowerShell を使用して UE-V 2 設定の場所テンプレートを管理する
UE-V の WMI および Windows PowerShell 機能には、設定の場所テンプレートを有効、無効、登録、更新、登録解除する機能が含まれます。 これらの機能を使用すると、UE-V エージェントでテンプレートを登録、更新、または登録解除するプロセスを自動化できます。 WMI コマンドと Windows PowerShell コマンドを使用して、テンプレートを手動で登録することもできます。 これらの機能を電子ソフトウェア配布ソリューション、グループ ポリシー、またはスクリプトなどの別の自動展開方法と組み合わせて使用することで、そのプロセスをさらに自動化できます。
設定の場所テンプレートを更新、登録、登録解除するには、管理者権限が必要です。 管理者のアクセス許可は、テンプレートの有効化、無効化、または一覧表示には必要ありません。
Windows PowerShell を使用して設定の場所テンプレートを管理するには
管理者権限を持つアカウントを使用して、Windows PowerShell コマンド プロンプトを開きます。
次の Windows PowerShell コマンドレットを使用して、UE-V 設定の場所テンプレートを登録および管理します。
Windows PowerShell コマンド 説明 Get-UevTemplate
コンピューターに登録されているすべての設定の場所テンプレートを一覧表示します。
Get-UevTemplate –Application <string>
アプリケーション名またはテンプレート名に <string> が含まれるコンピューターに登録されているすべての設定の場所テンプレートを一覧表示します。
Get-UevTemplate –TemplateID <string>
テンプレート ID に <string> が含まれるコンピューターに登録されているすべての設定の場所テンプレートを一覧表示します。
Get-UevTemplate [-ApplicationOrTemplateID] <string>
アプリケーションまたはテンプレート名、またはテンプレート ID に <string> が含まれるコンピューターに登録されているすべての設定の場所テンプレートを一覧表示します。
Get-UevTemplateProgram [-ID] <template ID>
テンプレート ID に依存するプログラムとバージョン情報の名前を取得します。
Get-UevAppXPackage
Windows アプリの有効な一覧を取得します。
Get-UevAppXPackage -Computer
コンピューター用に構成されている Windows アプリの一覧を取得します。
Get-UevAppXPackage -CurrentComputerUser
現在のユーザー用に構成されている Windows アプリの一覧を取得します。
Register-UevTemplate [-Path] <template file path>[,<template file path>]
ファイル パスで相対パスやワイルドカード文字を使用して、1 つ以上の設定場所テンプレートを UE-V に登録します。 テンプレートが登録されると、UE-V はテンプレートで定義されている設定を、テンプレートが登録されているコンピューター間で同期します。
Register-UevTemplate –LiteralPath <template file path>[,<template file path>]
ワイルドカード文字として解釈できないリテラル パスを使用して、1 つ以上の設定場所テンプレートを UE-V に登録します。 テンプレートが登録されると、UE-V はテンプレートで定義されている設定を、テンプレートが登録されているコンピューター間で同期します。
Unregister-UevTemplate [-ID] <template ID>
UE-V を使用して設定場所テンプレートの登録を解除します。 テンプレートの登録が解除されると、UE-V はテンプレートで定義されている設定をコンピューター間で同期しなくなります。
Unregister-UevTemplate -All
UE-V を使用して、すべての設定の場所テンプレートの登録を解除します。 テンプレートの登録が解除されると、UE-V はテンプレートで定義されている設定をコンピューター間で同期しなくなります。
Update-UevTemplate [-Path] <template file path>[,<template file path>]
1 つ以上の設定の場所テンプレートを、より新しいバージョンのテンプレートで更新します。 ファイル パスには、相対パスやワイルドカード文字を使用します。 新しいテンプレートは、既存のテンプレートよりも新しいバージョンにする必要があります。
Update-UevTemplate –LiteralPath <template file path>[,<template file path>]
1 つ以上の設定の場所テンプレートを、より新しいバージョンのテンプレートで更新します。 テンプレート ファイルへの完全なパスを使用します。ここで、ワイルドカード文字として解釈できる文字はありません。 新しいテンプレートは、既存のテンプレートよりも新しいバージョンにする必要があります。
Clear-UevAppXPackage –Computer [-PackageFamilyName] <package family name>[,<package family name>]
コンピューターの Windows アプリの一覧から 1 つ以上の Windows アプリを削除します。
Clear-UevAppXPackage -CurrentComputerUser
現在のユーザー Windows アプリの一覧から Windows アプリを削除します。
Clear-UevAppXPackage –Computer -All
コンピューターの Windows アプリの一覧からすべての Windows アプリを削除します。
Clear-UevAppXPackage [–CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>]
現在のユーザー Windows アプリの一覧から 1 つ以上の Windows アプリを削除します。
Clear-UevAppXPackage [–CurrentComputerUser] -All
現在のユーザー Windows アプリの一覧からすべての Windows アプリを削除します。
Disable-UevTemplate [-ID] <template ID>
コンピューターの現在のユーザーの設定場所テンプレートを無効にします。
Disable-UevAppXPackage –Computer [-PackageFamilyName] <package family name>[,<package family name>]
コンピューターの Windows アプリの一覧で 1 つ以上の Windows アプリを無効にします。
Disable-UevAppXPackage [–CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>]
現在のユーザー Windows アプリの一覧で 1 つ以上の Windows アプリを無効にします。
Enable-UevTemplate [-ID] <template ID>
コンピューターの現在のユーザーの設定場所テンプレートを有効にします。
Enable-UevAppXPackage –Computer [-PackageFamilyName] <package family name>[,<package family name>]
コンピューターの Windows アプリの一覧で 1 つ以上の Windows アプリを有効にします。
Enable-UevAppXPackage [–CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>]
現在のユーザー Windows アプリの一覧で 1 つ以上の Windows アプリを有効にします。
Test-UevTemplate [-Path] <template file path>[,<template file path>]
1 つ以上の設定の場所テンプレートがその XML スキーマに準拠しているかどうかを判断します。 相対パスとワイルドカード文字を使用できます。
Test-UevTemplate –LiteralPath <template file path>[,<template file path>]
1 つ以上の設定の場所テンプレートがその XML スキーマに準拠しているかどうかを判断します。 パスはテンプレート ファイルへの完全パスである必要がありますが、ワイルドカード文字は含まれません。
UE-V Windows PowerShell 機能を使用すると、エンタープライズに展開されている設定テンプレートのグループを管理できます。 Windows PowerShell を使用してテンプレートのグループを管理するには、次の手順に従います。
Windows PowerShell を使用して設定の場所テンプレートのグループを管理するには
目的の設定の場所テンプレートを変更または更新します。
設定の場所テンプレートを変更または更新する場合は、これらの設定の場所テンプレートをローカル コンピューターからアクセスできるフォルダーに展開します。
ローカル コンピューターで、管理者権限を持つ Windows PowerShell ウィンドウを開きます。
次のコマンドを入力して、以前に登録したすべてのバージョンのテンプレートの登録を解除します。
Unregister-UevTemplate -All
このコマンドは、コンピューター上のすべてのアクティブなテンプレートの登録を解除します。
次のコマンドを入力して、更新されたテンプレートを登録します。
Register-UevTemplate <path to template folder>\*.xml
このコマンドは、指定したテンプレート フォルダーにあるすべての設定場所テンプレートを登録します。
Windows アプリの一覧
Windows アプリの一覧に Windows アプリを一覧表示すると、そのアプリが設定の同期に対して有効か無効かを指定します。 アプリは、パッケージ ファミリ名と、そのアプリに対して設定の同期を有効または無効にする必要があるかどうかによって、一覧で識別されます。 これらの設定を一覧に記載されていない既定の同期動作設定と共に使用する場合は、Windows アプリを同期するかどうかを制御できます。
インストールされている Windows アプリのパッケージ ファミリ名を表示するには、Windows PowerShell コマンド プロンプトで次のように入力します。
Get-AppxPackage | Sort-Object PackageFamilyName | Format-Table PackageFamilyName
コンピューターの設定をパッケージ ファミリ名、有効な状態、有効なソースと同期できる Windows アプリの一覧を表示するには、Windows PowerShell コマンド プロンプトで次のように入力します。 Get-UevAppxPackage
Get-UevAppxPackage プロパティの定義
DisplayName 会社設定センター アプリケーションでユーザーに表示される名前。 DisplayName
プロパティは、PackageFamilyName
プロパティから派生します。
PackageFamilyName 現在のユーザーにインストールされているパッケージの名前。
有効 アプリの設定を同期するように構成するかどうかを定義します。
EnabledSource アプリを有効または無効にする構成が設定されている場所。 指定できる値は 、NotSet、 LocalMachine、 LocalUser、 PolicyMachine、 PolicyUser です。
NotSet ポリシーは、このアプリを同期するように構成されていません。
LocalMachine 有効な状態は、レジストリのローカル コンピューター セクションで設定されます。
LocalUser 有効な状態は、レジストリの現在のユーザー セクションで設定されます。
PolicyMachine 有効な状態は、レジストリのローカル コンピューター セクションのポリシー セクションで設定されます。
ユーザーが構成した Windows アプリの一覧を取得するには、Windows PowerShell コマンド プロンプトで次のように入力します。 Get-UevAppxPackage –CurrentComputerUser
コンピューターで構成された Windows アプリの一覧を取得するには、Windows PowerShell コマンド プロンプトで、次のように入力します。 Get-UevAppxPackage –Computer
パラメーター CurrentComputerUser または Computer の場合、コマンドレットは、ユーザーまたはコンピューター レベルで構成されている Windows アプリの一覧を返します。
プロパティの定義
DisplayName 会社設定センター アプリケーションでユーザーに表示される名前。 DisplayName
プロパティは、PackageFamilyName
プロパティから派生します。
PackageFamilyName 現在のユーザーにインストールされているパッケージの名前。
有効 アプリの設定を、指定したスイッチ ( つまり、ユーザー またはコンピューター) に対して同期するように構成するかどうかを定義 します。
インストール True を指定すると、現在のユーザーに対して PackageFamilyName がインストールされます。
WMI を使用して UE-V 2 設定の場所テンプレートを管理する
User Experience Virtualization には、次の WMI コマンドのセットが用意されています。 管理者は、これらのインターフェイスを使用して、Windows PowerShell から設定の場所テンプレートを管理し、テンプレート管理タスクを自動化できます。
WMI を使用して設定の場所テンプレートを管理するには
管理者権限を持つアカウントを使用して、Windows PowerShell ウィンドウを開きます。
次の WMI コマンドを使用して、UE-V 設定の場所テンプレートを登録および管理します。
Windows PowerShell command
説明 Get-WmiObject -Namespace root\Microsoft\UEV SettingsLocationTemplate | Select-Object TemplateId,TemplateName, TemplateVersion,Enabled | Format-Table -Autosize
コンピューターに登録されているすべての設定の場所テンプレートを一覧表示します。
Invoke-WmiMethod –Namespace root\Microsoft\UEV –Class SettingsLocationTemplate –Name GetProcessInfoByTemplateId <template Id>
テンプレート名に依存するプログラムとバージョン情報の名前を取得します。
Get-WmiObject -Namespace root\Microsoft\UEV EffectiveWindows8App
Windows アプリの有効な一覧を取得します。
Get-WmiObject -Namespace root\Microsoft\UEV MachineConfiguredWindows8App
コンピューター用に構成されている Windows アプリの一覧を取得します。
Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguredWindows8App
現在のユーザー用に構成されている Windows アプリの一覧を取得します。
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Register -ArgumentList <template path >
設定の場所テンプレートを UE-V に登録します。
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name UnregisterByTemplateId -ArgumentList <template ID>
UE-V を使用して設定場所テンプレートの登録を解除します。 テンプレートの登録が解除されるとすぐに、UE-V はテンプレートで定義されている設定をコンピューター間で同期しなくなります。
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Update -ArgumentList <template path>
UE-V を使用して設定の場所テンプレートを更新します。 新しいテンプレートは、既存のテンプレートよりも新しいバージョンにする必要があります。
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name RemoveApp -ArgumentList <package family name | package family name>
コンピューターの Windows アプリの一覧から 1 つ以上の Windows アプリを削除します。
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name RemoveApp -ArgumentList <package family name | package family name>
現在のユーザー Windows アプリの一覧から 1 つ以上の Windows アプリを削除します。
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name DisableByTemplateId -ArgumentList <template ID>
UE-V で 1 つ以上の設定の場所テンプレートを無効にします。
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name DisableApp -ArgumentList <package family name | package family name>
コンピューターの Windows アプリの一覧で 1 つ以上の Windows アプリを無効にします。
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name DisableApp -ArgumentList <package family name | package family name>
現在のユーザー Windows アプリの一覧で 1 つ以上の Windows アプリを無効にします。
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name EnableByTemplateId -ArgumentList <template ID>
UE-V を使用して設定場所テンプレートを有効にします。
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name EnableApp -ArgumentList <package family name | package family name>
コンピューターの Windows アプリの一覧で Windows アプリを有効にします。
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name EnableApp -ArgumentList <package family name | package family name>
現在のユーザー Windows アプリの一覧で Windows アプリを有効にします。
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Validate -ArgumentList <template path>
特定の設定の場所テンプレートがその XML スキーマに準拠しているかどうかを判断します。
手記 WMI コマンドによってパッケージ ファミリ名のリストが呼び出される場合、一覧は引用符で囲み、パイプ記号 (たとえば、 "<package family name | package family name>"
) で区切る必要があります。
Windows PowerShell を使用した UE-V エージェントのデプロイ
Windows PowerShell を使用して UE-V エージェントをデプロイする方法
アクセス可能なネットワーク共有で UE-V エージェント インストール パッケージをステージングします。
手記 AgentSetup.exe を使用して、UE-V エージェントの 32 ビット バージョンと 64 ビット バージョンの両方をデプロイします。 Windows インストーラー パッケージ (AgentSetupx86.msi と AgentSetupx64.msi) は、アーキテクチャごとに使用できます。 インストール ファイルを使用して後で UE-V エージェントをアンインストールするには、同じファイルの種類を使用する必要があります。
次のいずれかの Windows PowerShell コマンドを使用して、UE-V エージェントをインストールします。
& 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%
UE-V の問題が発生しましたか? UE-V TechNet フォーラムを使用します。