Azure Localカタログを作成する

最終公開日 : Nov 13, 2026
マシンカタログを作成するウィザードについては、マシンカタログの作成で説明しています。以下の情報は、Azure Local環境に固有の詳細を扱っています。
注:
Azure Localマシンカタログを作成する前に、Azure Localへの接続作成を完了する必要があります。詳しくは、(/ja-jp/citrix-virtual-apps-desktops/2511/install-configure/connections/connection-azure-local.html)を参照してください。

要件

  • VDAバージョン:2507以降
  • Windows 10/11 マルチセッションワークロードはサポートされていません

マスターイメージを作成する

マシンカタログを作成するには、マスターイメージが必要です。
MCSはAzure Local VMイメージをマスターイメージとして使用します。Azure LocalクラスターでワークロードをプロビジョニングするためにMCSを使用する前に、VDAがインストールされたAzure Local VMイメージを準備する必要があります。
  1. Azureポータルを使用してAzure Local VMを作成します。
  2. 作成したAzure Local VMに接続し、VDAと必要なソフトウェアをインストールします。
  3. Windowsタスクスケジューラを使用して、VM起動時にシステムコンテキストで次のスクリプトを実行するスケジュールタスクを作成します。マスターイメージでタスクをスケジュールするこのタスクは、VDAバージョン2511以前の場合にのみ必要です。
    $tagFileName = 'E6DA6616-8EC4-48E0-BE93-58CE6ACE3CFB.tag'

    $foundDrive = $null

    foreach ($drive in Get-PSDrive -PSProvider FileSystem) {

    $tagPath = Join-Path $drive.Root $tagFileName

    if (Test-Path $tagPath) {

        $foundDrive = $drive.Root

        break

    }

    }


    if ([string]::IsNullOrEmpty($foundDrive)) { exit 0 }

    $installScript = Join-Path $foundDrive 'install.ps1'

    if (Test-Path $installScript) {

    powershell.exe -NoProfile -ExecutionPolicy Bypass -File $installScript

    } else { exit 1 }

    sc.exe stop mocguestagent 2>$null

    sc.exe delete mocguestagent 2>$null

    Remove-Item 'HKLM:\SYSTEM\CurrentControlSet\Services\EventLog\Application\mocguestagent' -Recurse -Force -ErrorAction SilentlyContinue

    $setupComplete = 'C:\Windows\Setup\Scripts\SetupComplete.cmd'

    if (Test-Path $setupComplete) { & $setupComplete }
  4. Azure Local VMを停止します。
  5. 準備されたAzure Local VMからAzure Local VMイメージを作成するには、既存のAzure Local VMからVMイメージを作成するを参照してください。
注:
Azure Connected Machine エージェントバージョン 1.61 以降がインストールされ、オンボードされた Azure Local VM を使用してマスターイメージを準備する場合、エージェント構成ファイルの削除時にアクセス拒否が発生するため、イメージ準備プロセスで MCS のカタログ作成が失敗します。回避策として、マスターイメージの作成中に次の手順を実行します。C:\ProgramData\AzureConnectedMachineAgent\Config\agentconfig.json に移動し、ファイルを右クリックして を選択し、 属性のチェックボックスをオフにします。

カタログを作成する

Azure Local カタログを作成して、Azure Local 環境でマシンを作成、配信、および電源管理できます。
注:
  • カタログ名の長さは 49 文字以下にする必要があります。
  • カタログ名またはマシン命名スキームで Microsoft Azure の予約語を使用しないでください。詳細については、Microsoft ドキュメント を参照してください。
カタログは以下を使用して作成できます。

Web Studio を使用してカタログを作成する

Azure Local 環境で MCS マシンカタログを作成できます。
マシンカタログセットアップウィザードで:
  1. ページで、 または を選択します。
  2. ページで:
    1. 「電源管理されているマシン(仮想マシンやブレードPCなど)」を選択します。
    2. 「Citrixプロビジョニングテクノロジー」を使用してマシンを展開することを選択します。
    3. Citrix Machine Creation Services (MCS) の下にあるAzure Localホスティングユニットを選択します。
  3. 「デスクトップエクスペリエンス」ページで、マシンタイプページで選択したマシンタイプに応じてオプションを選択します。
  4. イメージページで:
    1. マスターイメージを選択します。現在、Azure Localは準備済みイメージをサポートしていません。
    2. 選択したイメージにメモを追加できます。
    注:
    • マスターイメージを選択すると、OSタイプが自動的に入力されます。
    • マシンプロファイルはサポートされていません。
  5. 「NIC」ページで、1つ以上のNICを選択し、各カードに仮想ネットワークを関連付けます。
  6. 「仮想マシン」ページで:
    1. 作成する仮想マシンの数を指定します。作成しない場合は0を入力します。後で、マシンを追加することで、空のカタログにVMを作成できます。
    2. 各VMが持つメモリ量(MB単位)と仮想CPU数を指定します。
    3. I/Oパフォーマンスを向上させるために、マシンのライトバックキャッシュを構成します。
  7. 画面の指示に従って残りの手順を完了してください。これらの手順にはAzure Local固有の情報は含まれていません。
Web Studioを使用してAzure Localカタログを作成し、Azure Localクラスター内の既存のマシンのパワーを配信および管理することもできます。
マシンカタログセットアップウィザードで:
  1. オペレーティングシステムページで、マルチセッションOSまたはシングルセッションOSを選択します。
  2. マシン管理ページで、電源管理されているマシンを選択し、マシンの展開方法としてその他のサービスまたはテクノロジーを選択します。
  3. 仮想マシンページで、マシンとそのActive Directoryマシンアカウントを追加します。次のことができます。
    • マシンを手動で追加する: をクリックして、マシンを手動で追加します。 ウィンドウが表示されます。以前に作成したAzure Local接続を展開し、追加するVMを選択します。次に、関連するマシンアカウント名を追加します。
    • CSVファイルを使用してマシンを追加する: をクリックします。CSVファイルを使用してマシンを追加する方法については、「Use CSV files to bulk add machines to a catalog」を参照してください。
  4. 画面の指示に従って残りの手順を完了してください。これらの手順にはAzure Local固有の情報は含まれていません。

PowerShellを使用してカタログを作成する

PowerShellコマンドを使用して、Azure Local環境にMCSマシンカタログを作成できます。

スクリプトのヘッダー

スクリプトのヘッダーで定義されている正しいパラメーター値を指定していることを確認してください。
$catalogName = "" # Name of the catalog you want to create

$masterImageResourceGroupName = "" # Name of resource group that the master Azure Local VM image resides in

$catalogResourceGroup = "" # Name of resource group that the created VMs reside in

$masterImage = "" # Name of the master Azure Local VM image you want to use

$vNet = "" # Name of the logical network that the created VMs should be attached to

$masterImagePath = "XDHyp:\HostingUnits\$hostingUnitName\image.folder\$masterImageResourceGroupName.resourcegroup\$masterImage"

$networkMapping = @{"0"="XDHyp:\HostingUnits\$hostingUnitName\\network.folder\$vNet.network"}

$customPropertiesXml = "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"ResourceGroups`" Value=`"$catalogResourceGroup`" /><Property xsi:type=`"StringProperty`" Name=`"OsType`" Value=`"Windows`" /></CustomProperties>"

1つのVMでMCSカタログを作成する

エーエスエヌピー シトリックス*
マシンカタログを作成する
New-BrokerCatalog -AllocationType "Random" -IsRemotePC $false -MinimumFunctionalLevel "L7_34" -Name $catalogName -PersistUserChanges "Discard" -ProvisioningType "MCS" -SessionSupport "SingleSession"
IDプールを作成する
New-AcctIdentityPool -AllowUnicode $true -Domain "test.local" -IdentityPoolName $catalogName -IdentityType "ActiveDirectory" -NamingScheme "demoVM#" -NamingSchemeType "Numeric" -OU "CN=Computers,DC=test,DC=local"
プロビジョニングスキームを作成する
New-ProvScheme -CleanOnBoot $true -CustomProperties $customPropertiesXml -HostingUnitName $hostingUnitName -IdentityPoolName $catalogName -MasterImageVM $masterImagePath -NetworkMapping $networkMapping -ProvisioningSchemeName $catalogName -ProvisioningSchemeType "MCS" -VMCpuCount 4 -VMMemoryMB 8192
カタログをプロビジョニングスキームにリンクする
$schemeUid =(Get-ProvScheme -ProvisioningSchemeName $catalogName).ProvisioningSchemeUid.Guid

Set-BrokerCatalog -Name $catalogName -ProvisioningSchemeId $schemeUid
ADアカウントを作成する
New-AcctADAccount -Count 1 -IdentityPoolName $catalogName
VMをプロビジョニングする
New-ProvVM -ADAccountName "domain\demoVM1" -ProvisioningSchemeName $catalogName
ブローカーカタログへのマシンの追加
New-BrokerMachine -CatalogName $catalogName -MachineName 'domain\demoVM1'

次のステップ

詳細情報