次の方法で共有

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

  • [アーティクル]

Microsoft User Experience Virtualization (UE-V) 2.1 SP1 では、XML 設定の場所テンプレートを使用して、UE-V がキャプチャして適用する設定を定義します。 UE-V には、一連の標準設定の場所テンプレートが含まれています。 また、カスタム設定の場所テンプレートを作成できる UE-V ジェネレーター ツールも含まれています。 設定の場所テンプレートを作成して展開した後は、Windows PowerShell と Windows Management Instrumentation (WMI) を使用してこれらのテンプレートを管理できます。 UE-V PowerShell コマンドレットの完全な一覧については、「 MDOP コマンドレット リファレンス」を参照してください。

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

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

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

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

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

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

    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 を使用して設定の場所テンプレートのグループを管理するには

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

  • 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: 現在のユーザーにインストールされているパッケージの名前。

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

  • インストール済み: 現在のユーザーの PackageFamilyName がインストールされている場合は True。

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

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

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

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

    Windows PowerShell コマンド 説明
    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 エージェントのデプロイ

  1. アクセス可能なネットワーク共有で UE-V エージェント インストール パッケージをステージングします。

    注

    AgentSetup.exe を使用して、UE-V エージェントの 32 ビット バージョンと 64 ビット バージョンの両方をデプロイします。 Windows インストーラー パッケージ (AgentSetupx86.msi と AgentSetupx64.msi) は、アーキテクチャごとに使用できます。 インストール ファイルを使用して後で UE-V エージェントをアンインストールするには、同じファイルの種類を使用する必要があります。

  2. 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 と WMI を使用した UE-V 2.1 SP1 の管理

UE-V 2.1 SP1 の管理