MSIX アプリのアタッチからアプリのアタッチへの MSIX パッケージの移行

アプリ アタッチにより、MSIX アプリのアタッチに対する管理およびユーザー エクスペリエンスが向上します。 MSIX アプリのアタッチを使用する場合は、PowerShell スクリプトを使用して MSIX パッケージをアプリのアタッチに移行できます。

移行スクリプトでは、次のアクションを実行できます。

• 新しいアプリのアタッチ パッケージ オブジェクトを作成し、必要に応じて元の MSIX パッケージ オブジェクトを削除できます。

• ホスト プールと MSIX パッケージに関連付けられているアプリケーション グループからアクセス許可をコピーします。

• ホスト プールと MSIX パッケージの場所とリソース グループをコピーします。

• 移行アクティビティをログに記録します。

前提条件

移行スクリプトを使用するには、次のものが必要です。

• MSIX アプリのアタッチで少なくとも 1 つの MSIX パッケージが追加された、検証環境として構成されたホスト プール。

• デスクトップ仮想化共同作成者の Azure ロールベースのアクセス制御 (RBAC) ロールがホスト プールに割り当てられた Azure アカウント。

• PowerShell を使用するローカル デバイス。 Az PowerShell と Microsoft Graph PowerShell SDK の最新バージョンがインストールされていることを確認します。 具体的には、次のモジュールが必要です。

  • Az.DesktopVirtualization
  • Az.Accounts
  • Az.Resources
  • Microsoft.Graph.Authentication

パラメーター

移行スクリプトで使用できるパラメーターを次に示します。

移行スクリプトのダウンロードと実行

MSIX アプリのアタッチからアプリのアタッチに MSIX パッケージを移行する方法は次のとおりです。

1. ローカル デバイスで PowerShell プロンプトを開きます。

2. PowerShell スクリプト Migrate-MsixPackagesToAppAttach.ps1 をダウンロードし、次のコマンドを実行してブロックを解除します。

   $url = "https://raw.githubusercontent.com/Azure/RDS-Templates/master/msix-app-attach/MigrationScript/Migrate-MsixPackagesToAppAttach.ps1"
   $filename = $url.Split('/')[-1]
   
   Invoke-WebRequest -Uri $url -OutFile $filename | Unblock-File
   

3. 次のコマンドを実行して、必要なモジュールをインポートします。

   Import-Module Az.DesktopVirtualization
   Import-Module Az.Accounts
   Import-Module Az.Resources
   Import-Module Microsoft.Graph.Authentication
   

4. 次のコマンドを実行し、プロンプトに従って Azure アカウントにサインインすることで、Azure に接続します。

   Connect-AzAccount
   

5. 次のコマンドを実行して Microsoft Graph に接続します。

   Connect-MgGraph -Scopes "Group.Read.All"
   

次のサブセクションには、移行スクリプトの使用方法の例がいくつか含まれています。 使用可能なすべてのパラメーターと各パラメーターの説明については、「パラメーター」セクションを参照してください。

ホスト プールとアプリケーション グループに追加された特定の MSIX パッケージの移行

MSIX アプリのアタッチからアプリのアタッチにホスト プールに追加された特定の MSIX パッケージを移行する例を次に示します。 この例では:

• MSIX パッケージをホスト プールと同じリソース グループと場所に移行します。
• アプリのアタッチの MSIX パッケージを、RemoteApp アプリケーション グループ ソースと同じホスト プールと同じユーザーに割り当てます。
• MSIX アプリのアタッチ内の既存の MSIX パッケージ構成は、ホスト プールでアクティブのままにします。 MSIX パッケージをすぐに無効にする場合は、-DeactivateOrigin パラメーターを使用します。
• アプリのアタッチの新しい MSIX パッケージ構成を非アクティブに設定します。 MSIX パッケージをすぐに有効にする場合は、-IsActive パラメーターを使用します。
• ログ情報を既定のファイル パスと形式で書き込みます。

1. 同じ PowerShell プロンプトから、次のコマンドを実行して、ホスト プールに追加された MSIX パッケージの一覧を取得します。

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdMsixPackage @parameters | Select-Object DisplayName, Name
   

   出力は次の出力のようになります。

   DisplayName Name
   ----------- ----
   MyApp       hp01/MyApp_1.0.0.0_neutral__abcdef123ghij
   

2. 移行する MSIX パッケージを見つけて、前の出力の Name パラメーターの値を使用します。

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   $msixPackage = Get-AzWvdMsixPackage @parameters | ? Name -Match '<MSIXPackageName>'
   $hostPoolId = (Get-AzWvdHostPool @parameters).Id
   

3. 次のコマンドを実行して MSIX パッケージを移行します。

   $parameters = @{
       PermissionSource = 'RAG'
       HostPoolsForNewPackage = $hostPoolId
       PassThru = $true
   }
   
   $msixPackage | .\Migrate-MsixPackagesToAppAttach.ps1 @parameters
   

ホスト プールに追加されたすべての MSIX パッケージの移行

MSIX アプリのアタッチからアプリのアタッチにホスト プールに追加されたすべての MSIX パッケージを移行する例を次に示します。 この例では:

• MSIX パッケージを同じリソース グループと場所に移行します。
• 新しいアプリのアタッチ パッケージを同じホスト プールに追加します。
• すべてのアプリのアタッチ パッケージをアクティブに設定します。
• すべての MSIX パッケージを非アクティブに設定します。
• 関連付けられているデスクトップ アプリケーション グループからアクセス許可をコピーします。
• JSON 形式で C:\MsixToAppAttach.log カスタム ファイル パスにログ情報を書き込みます。

1. 同じ PowerShell プロンプトから、ホスト プールに追加されたすべての MSIX パッケージを取得し、次のコマンドを実行して変数に格納します。

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   $msixPackages = Get-AzWvdMsixPackage @parameters
   $hostPoolId = (Get-AzWvdHostPool @parameters).Id   
   

2. 次のコマンドを実行して MSIX パッケージを移行します。

   $logFilePath = "C:\Temp\MsixToAppAttach.log"
   
   $parameters = @{
       IsActive = $true
       DeactivateOrigin = $true
       PermissionSource = 'DAG'
       HostPoolsForNewPackage = $hostPoolId
       PassThru = $true
       LogInJSON = $true
       LogFilePath = $LogFilePath
   }
   
   $msixPackages | .\Migrate-MsixPackagesToAppAttach.ps1 @parameters