Windows PowerShell と WMI を使用した UE-V 設定場所テンプレートの管理

  • [アーティクル]
  • 適用対象:
    ✅ Windows 10

User Experience Virtualization (UE-V) では、XML 設定の場所テンプレートを使用して、User Experience Virtualization がキャプチャして適用する設定を定義します。 UE-V には、一連の標準設定の場所テンプレートが含まれています。 また、カスタム設定の場所テンプレートを作成できる UE-V テンプレート ジェネレーター ツールも含まれています。 設定の場所テンプレートを作成して展開した後は、Windows PowerShellと Windows Management Instrumentation (WMI) を使用してこれらのテンプレートを管理できます。

注

UE-V コマンドレットの完全な一覧については、「Windows PowerShellでのユーザー エクスペリエンス仮想化」を参照してください。

Windows PowerShellを使用して UE-V 設定の場所テンプレートを管理する

UE-V の WMI およびWindows PowerShell機能には、設定の場所テンプレートを有効、無効、登録、更新、登録解除する機能が含まれます。 これらの機能を使用すると、UE-V サービスでテンプレートを登録、更新、または登録解除するプロセスを自動化できます。 WMI コマンドと Windows PowerShell コマンドを使用して、テンプレートを手動で登録することもできます。 これらの機能を電子ソフトウェア配布ソリューション、グループ ポリシー、またはスクリプトなどの別の自動展開方法と組み合わせて使用することで、そのプロセスをさらに自動化できます。

設定の場所テンプレートを更新、登録、登録解除するには、管理者権限が必要です。 管理者のアクセス許可は、テンプレートの有効化、無効化、または一覧表示には必要ありません。

Windows PowerShellを使用して設定の場所テンプレートを管理するには

  1. 管理者権限を持つアカウントを使用して、Windows PowerShellコマンド プロンプトを開きます。

  2. UE-V 設定の場所テンプレートを登録および管理するには、次のWindows PowerShellコマンドレットを使用します。

    Windows PowerShell コマンド 説明
    Get-UevTemplate コンピューターに登録されているすべての設定の場所テンプレートをListsします。
    Get-UevTemplate -Application <string> アプリケーション名またはテンプレート名が含まれるコンピューターに登録されているすべての設定場所テンプレートをListsします。
    Get-UevTemplate -TemplateID <string> テンプレート ID が含まれるコンピューターに登録されているすべての設定場所テンプレートをListsします。
    Get-UevTemplate [-ApplicationOrTemplateID] <string> アプリケーションまたはテンプレート名、またはテンプレート ID が含まれるコンピューターに登録されているすべての設定場所テンプレートをListsします。
    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を使用して設定の場所テンプレートのグループを管理するには

  1. 目的の設定の場所テンプレートを変更または更新します。

  2. 設定の場所テンプレートを変更または更新する場合は、これらの設定の場所テンプレートをローカル コンピューターからアクセスできるフォルダーに展開します。

  3. ローカル コンピューターで、管理者権限を持つWindows PowerShell ウィンドウを開きます。

  4. 次のコマンドを入力して、以前に登録したすべてのバージョンのテンプレートの登録を解除します。

    Unregister-UevTemplate -All

    このコマンドは、コンピューター上のすべてのアクティブなテンプレートの登録を解除します。

  5. 次のコマンドを入力して、更新されたテンプレートを登録します。

    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 プロパティの定義

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 アプリの一覧を返します。

プロパティの定義

PackageFamilyName

現在のユーザーにインストールされているパッケージの名前。

有効

アプリの設定を、指定したスイッチ ( つまり、ユーザー またはコンピューター) に対して同期するように構成するかどうかを定義 します。

インストール

True を指定すると、現在のユーザーに対して PackageFamilyName がインストールされます。

WMI を使用して UE-V 設定の場所テンプレートを管理する

User Experience Virtualization には、次の WMI コマンドのセットが用意されています。 管理者は、これらのインターフェイスを使用して、Windows PowerShellから設定の場所テンプレートを管理し、テンプレートの管理タスクを自動化できます。

WMI を使用して設定の場所テンプレートを管理するには

  1. 管理者権限を持つアカウントを使用して、Windows PowerShell ウィンドウを開きます。

  2. 次の WMI コマンドを使用して、UE-V 設定の場所テンプレートを登録および管理します。

    Windows PowerShell command 説明
    Get-WmiObject -Namespace root\Microsoft\UEV SettingsLocationTemplate Select-Object TemplateId,TemplateName, TemplateVersion,Enabled Format-Table -Autosize コンピューターに登録されているすべての設定の場所テンプレートをListsします。
    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> コンピューターの Windows アプリの一覧から 1 つ以上の Windows アプリを削除します。
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name RemoveApp -ArgumentList <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> コンピューターの Windows アプリの一覧で 1 つ以上の Windows アプリを無効にします。
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name DisableApp -ArgumentList <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> コンピューターの Windows アプリの一覧で Windows アプリを有効にします。
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name EnableApp -ArgumentList <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と WMI を使用した UE-Vの管理 Windows PowerShellでの UE-Vユーザー エクスペリエンス仮想化の管理