Azure Localカタログを作成する

最終公開日 : Nov 13, 2026
マシンカタログを作成するウィザードについては、マシンカタログの作成で説明しています。以下の情報は、Azure Local環境に固有の詳細を扱っています。
注:
Azure Localマシンカタログを作成する前に、Azure Localへの接続の作成を完了する必要があります。Azure Localへの接続を参照してください。

要件

  • 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. オペレーティングシステムページで、マルチセッションOSまたはシングルセッションOSを選択します。
  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'

次のステップ

詳細情報