製品ドキュメント
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
PDFを表示

Azure Localカタログの作成

April 7, 2026
寄稿者: 
C C

マシンカタログの作成では、マシンカタログを作成するウィザードについて説明します。以下の情報は、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起動時にシステムコンテキストで次のスクリプトを実行するスケジュールタスクを作成します。

    ``` $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 }

    ```

  1. Azure Local VMを停止します。
  2. 準備した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ドキュメント](https://learn.microsoft.com/ja-jp/azure/azure-resource-manager/troubleshooting/error-reserved-resource-name)を参照してください

カタログは次の方法で作成できます。

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マシンアカウントを追加します。次のことができます。

    • マシンを手動で追加する: マシンの追加をクリックしてマシンを手動で追加します。VMの選択ウィンドウが表示されます。以前に作成したAzure Local接続を展開し、追加するVMを選択します。次に、関連するマシンアカウント名を追加します。
    • CSVファイルを使用してマシンを追加する: CSVファイルからインポートしてマシンを一括追加をクリックします。CSVファイルを使用してマシンを追加する方法については、CSVファイルを使用してマシンをカタログに一括追加するを参照してください。
    1. 画面の指示に従って、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 citrix*

マシンカタログの作成 
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-->

次のステップ

詳細情報

Azure Localカタログの作成
April 7, 2026
寄稿者: 
C C
April 7, 2026
寄稿者: 
C C

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.