Citrix Virtual Apps and Desktops

Azure Localカタログを作成する

May 31, 2026

寄稿者:

「マシンカタログの作成」(/ja-jp/citrix-virtual-apps-desktops/2511/install-configure/machine-catalogs-create.html)では、マシンカタログを作成するウィザードについて説明します。以下の情報は、Azure Local環境に固有の詳細を扱います。

注：

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イメージを準備する必要があります。

Azureポータルを使用してAzure Local VMを作成します。
作成したAzure Local VMに接続し、VDAと必要なソフトウェアをインストールします。

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 }
<!--NeedCopy-->

Azure Local 仮想マシンを停止します。
準備された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スタジオ
パワーシェル

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

Azure Local環境でMCSマシンカタログを作成できます。

マシンカタログセットアップウィザードで:

オペレーティングシステムページで、マルチセッションOSまたはシングルセッションOSを選択します。
マシン管理ページで:
1. 「電源管理されているマシン（仮想マシンやブレードPCなど）」を選択します。
2. 「Citrixプロビジョニングテクノロジー」を使用してマシンを展開することを選択します。
3. Citrix Machine Creation Services (MCS) の下にあるアジュールローカルホスティングユニットを選択します。
「デスクトップエクスペリエンス」ページで、マシンタイプページで選択したマシンタイプに応じてオプションを選択します。
「イメージ」ページで：
1. マスターイメージを選択します。現在、Azure Localは準備済みイメージをサポートしていません。
2. 選択したイメージにメモを追加できます。
「注：」
- マスターイメージを選択すると、OSタイプが自動的に入力されます。
- マシンプロファイルはサポートされていません。
「NIC」ページで、1つ以上のNICを選択し、各カードに仮想ネットワークを関連付けます。
「仮想マシン」ページで：
1. 作成する仮想マシンの数を指定します。作成しない場合は0を入力します。後で、マシンを追加することで、空のカタログにVMを作成できます。
2. 各VMが持つメモリ量（MB単位）と仮想CPU数を指定します。
3. I/Oパフォーマンスを向上させるために、マシンのライトバックキャッシュを構成します。
画面の指示に従って残りの手順を完了してください。これにはAzure Local固有の情報は含まれません。

Web Studioを使用してAzure Localカタログを作成し、Azure Localクラスター内の既存のマシンのパワーを配信および管理することもできます。

マシンカタログセットアップウィザードで:

オペレーティングシステムページで、マルチセッションOSまたはシングルセッションOSを選択します。
「マシン管理」ページで、「電源管理されているマシン」を選択し、マシンの展開方法として「その他のサービスまたはテクノロジー」を選択します。
仮想マシンページで、マシンとそのActive Directoryマシンアカウントを追加します。次のことができます。
- マシンを手動で追加する: マシンの追加をクリックして、マシンを手動で追加します。VMの選択ウィンドウが表示されます。以前に作成したAzure Local接続を展開し、追加するVMを選択します。次に、関連するマシンアカウント名を追加します。
- CSVファイルを使用してマシンを追加する: CSVファイルからインポートしてマシンを一括追加をクリックします。CSVファイルを使用してマシンを追加する方法については、「CSVファイルを使用してカタログにマシンを一括追加する」を参照してください。
画面の指示に従って残りの手順を完了してください。これには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>"
<!--NeedCopy-->

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

asnp シトリックス*

マシンカタログを作成する

New-BrokerCatalog -AllocationType "Random" -IsRemotePC $false -MinimumFunctionalLevel "L7_34" -Name $catalogName -PersistUserChanges "Discard" -ProvisioningType "MCS" -SessionSupport "SingleSession"
<!--NeedCopy-->

IDプールを作成する

New-AcctIdentityPool -AllowUnicode $true -Domain "test.local" -IdentityPoolName $catalogName -IdentityType "ActiveDirectory" -NamingScheme "demoVM#" -NamingSchemeType "Numeric" -OU "CN=Computers,DC=test,DC=local"
<!--NeedCopy-->

プロビジョニングスキームを作成する

New-ProvScheme -CleanOnBoot $true -CustomProperties $customPropertiesXml -HostingUnitName $hostingUnitName -IdentityPoolName $catalogName -MasterImageVM $masterImagePath -NetworkMapping $networkMapping -ProvisioningSchemeName $catalogName -ProvisioningSchemeType "MCS" -VMCpuCount 4 -VMMemoryMB 8192
<!--NeedCopy-->

カタログをプロビジョニングスキームにリンクする

$schemeUid =(Get-ProvScheme -ProvisioningSchemeName $catalogName).ProvisioningSchemeUid.Guid

Set-BrokerCatalog -Name $catalogName -ProvisioningSchemeId $schemeUid
<!--NeedCopy-->

ADアカウントを作成する

New-AcctADAccount -Count 1 -IdentityPoolName $catalogName
<!--NeedCopy-->

VMをプロビジョニングする

New-ProvVM -ADAccountName "domain\demoVM1" -ProvisioningSchemeName $catalogName
<!--NeedCopy-->

マシンをブローカーカタログに追加する

New-BrokerMachine -CatalogName $catalogName -MachineName 'domain\demoVM1'
<!--NeedCopy-->

次のステップ

これが最初に作成されたカタログである場合、Web Studioはデリバリーグループの作成を案内します。
Azure Local VMの電源管理については、Azure Local VMの電源管理を参照してください。

詳細情報

この製品ドキュメントの正式なバージョンは英語版です。英語以外のすべてのバージョンは、お客様の利便性のためにのみ提供され、機械翻訳された内容が含まれている場合があります。詳しくは、Cloud Software Group home で機械翻訳に関する免責事項（Machine Translation Disclaimer）をご覧ください。

この情報は役に立ちましたか?

Azure Localカタログを作成する

May 31, 2026

寄稿者:

May 31, 2026

寄稿者:

この情報は役に立ちましたか?