Citrix Virtual Apps and Desktops

マシンカタログの管理

April 7, 2026

寄稿者:

C C

注:

バージョン2511以降、Citrix Web Studio (Webベース) はCitrix Virtual Apps and Desktops™の唯一の管理コンソールです。Citrix Studio (MMCベース) はインストーラーから削除されました。この記事はWeb Studioにのみ適用されます。Citrix Studioに関する情報については、Citrix Virtual Apps and Desktops 7 2212以前の同等の記事を参照してください。

はじめに

マシンカタログへのマシンの追加または削除、名前の変更、説明の変更、またはカタログのActive Directoryコンピューターアカウントの管理が可能です。

カタログの保守には、各マシンに最新のOSアップデートが適用されていることを確認することも含まれます。これには、ウイルス対策アップデート、オペレーティングシステムのアップグレード、または構成の変更が含まれます。

Machine Creation Services™ (MCS) を使用して作成されたプールされたランダムマシンを含むカタログは、カタログで使用されるマスターイメージを更新し、その後マシンを更新することでマシンを保守します。この方法により、多数のユーザーマシンを効率的に更新できます。
静的で永続的に割り当てられたマシンを含むカタログ、およびRemote PC Accessマシンカタログの場合、ユーザーマシンの更新はWeb Studioの外部で管理します。このタスクは、サードパーティのソフトウェア配布ツールを使用して、個別にまたはまとめて実行します。
ホストハイパーバイザーへの接続の作成と管理については、「接続とリソース」を参照してください。
注:
MCSはWindows 10 IoT CoreおよびWindows 10 IoT Enterpriseをサポートしていません。詳細については、Microsoftサイトを参照してください。
永続インスタンスについて

永続インスタンスまたは専用インスタンスを使用して作成されたMCSカタログを更新する場合、カタログ用に作成された新しいマシンは更新されたイメージを使用します。既存のインスタンスは元のインスタンスを引き続き使用します。イメージの更新プロセスは、他の種類のカタログと同じ方法で行われます。次の点を考慮してください。

永続ディスクカタログの場合、既存のマシンは新しいイメージに更新されませんが、カタログに追加された新しいマシンは新しいイメージを使用します。
非永続ディスクカタログの場合、マシンイメージは次回のマシンリセット時に更新されます。
- 永続マシンカタログの場合、イメージを更新すると、それを使用するカタログインスタンスも更新されます。
- 永続しないカタログの場合、異なるマシンに異なるイメージを使用したい場合は、イメージを別々のカタログに配置する必要があります。
マシンカタログの管理
- マシンカタログは次の2つの方法で管理できます。
Web Studioの使用
- PowerShellの使用

Web Studioの使用

このセクションでは、Web Studioを使用してカタログを管理する方法について詳しく説明します。
マシンカタログの管理
- はじめに
- 永続インスタンスについて
マシンカタログの管理
Web Studioの使用
カタログの詳細の表示
カタログの名前変更
カタログの別のゾーンへの移動
カタログの削除
機能レベルの変更または変更の取り消し
カタログのクローン作成
フォルダーを使用したカタログの整理
VDAのアップグレード
カタログ作成の再試行
- トークンを使用した非MCSプロビジョニングVDAの登録
- PowerShellの使用
カタログに関連付けられた警告とエラーの取得
- イメージへの説明の追加
- OSディスクのリセット
既存のプロビジョニングスキームのネットワーク設定の変更
既存のマシンカタログのキャッシュ構成の変更
- 要件
- キャッシュ構成の変更
ローカルファイル共有アクセスによるVDA更新のサポート
次のステップ

カタログの詳細の表示

特定のコンピューターカタログを検索するには、検索機能を使用します。手順については、「インスタンスの検索」を参照してください。
必要に応じて、検索結果からカタログを選択します。
カタログ列の説明については、次の表を参照してください。

カタログ列の説明については、次の表を参照してください。

列	説明
マシンカタログ	カタログの名前と割り当ての種類。割り当ての種類には以下が含まれます • ランダム：カタログ内のマシンはユーザーにランダムに割り当てられます • 永続：カタログ内のマシンはユーザーに永続的に割り当てられます


マシンタイプ	カタログ内のマシンでサポートされているセッションの種類。可能な値は次のとおりです • OSの種類：マルチセッションOS (仮想)、ユーザーデータ：破棄 • OSの種類：マルチセッションOS (仮想)、ユーザーデータ：ローカルディスク上 • OSの種類：シングルセッションOS (Remote PC Access) • OSの種類：シングルセッションOS (仮想)、ユーザーデータ：破棄 • OSの種類：シングルセッションOS (仮想)、ユーザーデータ：ローカルディスク上





マシン数	カタログ内のマシン数とプロビジョニング方法。可能なプロビジョニング方法には、Machine Creation Services (MCSマシン)、手動、およびCitrix Provisioning™ Servicesが含まれます
割り当て済み数	デリバリーグループに割り当てられているカタログ内のマシンの数
フォルダー	マシンカタログツリー内のカタログの場所。カタログが存在するフォルダーの名前 (末尾のバックスラッシュを含む) を表示します。カタログがルートレベルにある場合は「-」と表示されます
VDAアップグレード	VDAアップグレードの状態。可能な値には、未構成、スケジュール済み、利用可能、最新が含まれます

イメージステータス

カタログのイメージ更新のステータス。非永続マシンカタログにのみ適用されます。指定可能な値は次のとおりです: 完全に更新済み、部分的に更新済み、更新保留中、準備中

選択したカタログの詳細については、下部の詳細ペインにあるタブをクリックします。

タブ説明

|——|——–|

詳細	マシンタイプ、プロビジョニング方法、サービスアカウント、OS、VDAバージョンなど、主要なマシンカタログ設定を要約し、リソースを迅速に表示および管理できます。

テンプレートプロパティ	MCSプロビジョニングされたカタログでのみ利用可能です。選択したカタログの詳細なプロビジョニング情報を表示します。これには以下が含まれます。 • マシンテンプレートプロパティ • ハイパーバイザー固有の詳細 • マシンプロファイルプロパティ




マシン	選択したカタログ内のマシン名がページ分割されたリストで表示されます。
デリバリーグループ	Remote PCカタログで利用可能です。選択したカタログに関連付けられているデリバリーグループを表示します。デリバリーグループ名とカタログの関連付けが表示されます。

タグ	マルチテナント環境では利用できません。選択したマシンカタログに割り当てられているタグのタグ名と説明を表示します。

Workspace Environment Management	WEMサービスがプロビジョニングされ、アクセス可能な場合にのみ表示されます。

^^ ^^ Workspace Environment Managementシステムの最適化設定を表示します。

コストインサイト Azure MCSカタログにのみ適用され、以下が表示されます。

^^	^^ • 過去30日間に発生した総コスト • 現在の30日間の総コストと、以前の30日間の期間との比較このタブを表示するには、CitrixのCost Management > Manage > Read cost権限（クラウド管理者にはデフォルト）が必要です。コストの詳細を表示するには、`Microsoft.CostManagement/query/read` Azure権限が必要です。


トラブルシューティング	カタログのエラーまたは警告と推奨されるアクションを表示します。

カタログへのマシンの追加

開始する前に:

仮想化ホストに、追加のマシンを収容するのに十分なプロセッサー、メモリ、およびストレージがあることを確認します。
- 未使用のActive Directoryコンピューターアカウントが十分にあることを確認します。既存のアカウントを使用している場合、追加できるマシンの数は利用可能なアカウントの数によって制限されます。
- Web Studioを使用して追加のマシン用のActive Directoryコンピューターアカウントを作成する場合、適切なドメイン管理者権限が必要です。
- カタログにマシンを追加するには:

Web Studioにサインインします。
左側のペインでマシンカタログを選択します。
マシンカタログを選択し、アクションバーでマシンの追加を選択します。
追加する仮想マシンの数を選択します。
追加するVMの数に対して既存のActive Directoryアカウントが不足している場合は、アカウントが作成されるドメインと場所を選択します。連続する数字または文字が表示される場所を示すためにハッシュマークを使用して、アカウントの命名スキームを指定します。OU名にスラッシュ (/) を使用しないでください。名前は数字で始めることはできません。たとえば、PC-Sales-## (0-9を選択) の命名スキームでは、PC-Sales-01、PC-Sales-02、PC-Sales-03などのコンピューターアカウントが作成されます。
既存のActive Directoryアカウントを使用する場合は、アカウントを参照するか、インポートをクリックしてアカウント名を含む.csvファイルを指定します。追加するすべてのマシンに対して十分なアカウントがあることを確認してください。Web Studioはこれらのアカウントを管理します。Web Studioがすべてのアカウントのパスワードをリセットすることを許可するか、すべてのアカウントで同じである必要があるアカウントパスワードを指定します。

マシンはバックグラウンドプロセスとして作成され、多数のマシンを作成する場合は時間がかかることがあります。Web Studioを閉じてもマシンの作成は続行されます。

カタログからのマシンの削除

マシンカタログからマシンを削除すると、ユーザーはアクセスできなくなります。そのため、マシンを削除する前に、以下を確認してください。

-  ユーザーデータがバックアップされているか、不要になっていること。
-  すべてのユーザーがログオフしていること。メンテナンスモードをオンにすると、マシンへの新しい接続が停止されます。
-  マシンが電源オフになっていること。

カタログからマシンを削除する:

Web Studioにサインインします。
- 1. 左ペインで [マシンカタログ] を選択します。
- 1. カタログを選択し、アクションバーで [マシンの表示] を選択します。
1つ以上のマシンを選択し、アクションバーで [削除] を選択します。

削除するマシンを削除するかどうかを選択します。マシンを削除することを選択した場合、それらのマシンのActive Directoryアカウントを保持するか、無効にするか、削除するかを指定します。

カタログの編集

-  1.  **[説明]** ページで、カタログの説明を変更します。

左ペインで [マシンカタログ] を選択します。
カタログを選択し、アクションバーで [マシンカタログの編集] を選択します。
[スコープ] ページで、スコープを変更します。
[NIC] ページで、次のアクションを実行します。
- NICのサブネットマッピングを変更するには、[関連付けられたネットワーク] フィールドからネットワークを選択します。
- サブネットマッピングを追加するには、[NICの追加] を選択し、[関連付けられたネットワーク] フィールドからネットワークを選択して、[保存] をクリックします。
カタログに関連付けられているホストに存在するサブネットのみが、[関連付けられたネットワーク] フィールドに表示されます。

マシンプロファイルのないAzureマシンカタログにのみNICを追加できます。
注:
- AWSマシンカタログの場合、同じサブネットを複数のNICにマッピングすることはできません。

マシンプロファイルを持つマシンカタログの場合、カタログ上のNICの数は、マシンプロファイル上のNICの数と等しくなければなりません。

この機能は、IBM Cloudハイパーバイザーではサポートされていません。

この機能は、Nutanixハイパーバイザーの場合、Nutanix Prism Elementでのみサポートされています。

カタログの種類によっては、他のページが表示される場合があります。

Azure Resource Managerイメージを使用して作成されたカタログの場合、次のページが表示されます。行った変更は、後でカタログに追加するマシンにのみ適用されることに注意してください。既存のマシンは変更されません。
- [仮想マシン] ページで、マシンのサイズと、マシンを作成するアベイラビリティゾーンを変更します。
  注:
  - カタログがサポートするマシンサイズのみが表示されます。
  - 必要に応じて、[他のマシンカタログで使用されているマシンサイズのみを表示] を選択して、マシンサイズリストをフィルター処理します。
  - Azureカタログの場合、[ストレージとライセンスの種類] ページで [ストレージ冗長性] が [ZRS] の場合、ゾーン選択をクリアしてAzureにVMアベイラビリティゾーンを管理させることを示唆する警告が表示されます。
- [マシンプロファイル] ページで、マシンプロファイルを使用するか変更するかを選択します。
  
  注:
  
  Azureカタログの場合、アベイラビリティゾーンを含むマシンプロファイルを変更し、ストレージ冗長性にZRSを選択すると、ゾーン選択をクリアするよう促す警告が表示されます。
- (カタログが専用グループホストで構成されている場合にのみ表示) [専用ホストグループ] ページで、ホストグループを変更するかどうかを選択します。
- [ストレージとライセンスの種類] ページで、ストレージ冗長性タイプ (Azureカタログの場合)、ストレージタイプ、ライセンスタイプ、およびAzureコンピューターギャラリー設定 ( [準備済みイメージをAzureギャラリーに配置] が使用されている場合にのみ利用可能) を変更するかどうかを選択します。
注:

新しく選択した設定が現在のマシンサイズをサポートしていない場合、設定を変更するとマシンサイズ設定がリセットされることを通知する警告ダイアログボックスが表示されます。続行することを選択した場合、[仮想マシン] メニューの横に赤い点が表示され、新しいマシンサイズを選択するよう促されます。
- [ライセンスの種類] ページで、WindowsライセンスまたはLinuxライセンス設定を変更するかどうかを選択します。
Remote PC Accessカタログの場合、次のページが表示されます。
- [電源管理] ページで、電源管理設定を変更し、電源管理接続を選択します。
- [組織単位] ページで、Active Directory OUを追加または削除します。
行った変更を適用するには [適用] をクリックし、終了するには [保存] をクリックします。

カタログの名前変更

Web Studioにサインインします。
左ペインで [マシンカタログ] を選択します。
カタログを選択し、アクションバーで [マシンカタログの名前変更] を選択します。
新しい名前を入力します。

カタログを別のゾーンに移動

展開に複数のゾーンがある場合、カタログをあるゾーンから別のゾーンに移動できます。

カタログ内のVMを含むハイパーバイザー以外のゾーンにカタログを移動すると、パフォーマンスに影響します。

Web Studioにサインインします。
左ペインで [マシンカタログ] を選択します。
カタログを選択し、アクションバーで [移動] を選択します。
カタログを移動するゾーンを選択します。

カタログの削除

カタログを削除する前に、以下を確認してください。

-  すべてのユーザーがログオフしており、切断されたセッションが実行されていないこと。

カタログ内のすべてのマシンでメンテナンスモードがオンになっており、新しい接続が確立できないこと。
カタログ内のすべてのマシンが電源オフになっていること。
カタログがデリバリーグループに関連付けられていないこと。つまり、デリバリーグループにそのカタログのマシンが含まれていないこと。

カタログを削除するには：

Web Studioにサインインします。
左ペインでマシンカタログを選択します。
カタログを選択し、アクションバーでマシンカタログの削除を選択します。
カタログ内のマシンを削除するかどうかを指定します。マシンを削除することを選択した場合、それらのマシンのActive Directoryコンピューターアカウントを保持、無効化、または削除するかどうかを指定します。

AzureのレガシーMCSカタログをマシンプロファイルベースのカタログに変換

マシンプロファイルベースではないマシンカタログをマシンプロファイルベースのマシンカタログに変換するには、次の手順を実行します。

マシンカタログページで、変換するマシンカタログ名を右クリックし、マシンカタログの編集を選択します。
マシンカタログの編集 > マシンプロファイルページで、マシンプロファイルを使用する (Microsoft Entra IDでは必須) チェックボックスをオンにします。
マシンプロファイルの選択をクリックします。

1. マシンプロファイルの選択ページで、マシンプロファイルとして使用する仮想マシンまたは起動テンプレートを選択します。

現在の設定の一部が新しいマシンプロファイルの設定と異なる場合は、使用する設定に必要なオプションを選択し、続行をクリックします。
適用をクリックします。

注：

現在、この機能はAzure、AWS、およびVMwareでのみサポートされています。

カタログ内のActive Directoryコンピューターアカウントの管理

マシンカタログ内のActive Directoryアカウントを管理するには、次のことができます。

シングルセッションOSおよびマルチセッションOSカタログからActive Directoryコンピューターアカウントを削除することで、未使用のマシンアカウントを解放します。これらのアカウントは、他のマシンで使用できます。
- アカウントを追加して、カタログにマシンが追加されたときにコンピューターアカウントがすでに存在するようにします。OU名にスラッシュ (/) を使用しないでください。
- Active Directoryアカウントを管理するには：

Web Studioにサインインします。
左ペインでマシンカタログを選択します。
カタログを選択し、アクションバーでADアカウントの管理を選択します。
コンピューターアカウントを追加または削除するかどうかを選択します。アカウントを追加する場合は、アカウントのパスワードをどうするかを指定します。すべてリセットするか、すべてのアカウントに適用されるパスワードを入力します。

現在のアカウントパスワードが不明な場合は、パスワードをリセットできます。パスワードリセットを実行する権限が必要です。パスワードを入力すると、インポート時にアカウントのパスワードが変更されます。アカウントを削除する場合は、Active Directory内のアカウントを保持、無効化、または削除するかどうかを選択します。

カタログからマシンを削除したり、カタログを削除したりする際に、Active Directoryアカウントを保持、無効化、または削除するかどうかを指定します。

カタログの更新

-  カタログ内のマシンを更新する前に、マスターイメージのコピーまたはスナップショットを保存することをお勧めします。データベースには、各マシンカタログで使用されたマスターイメージの履歴レコードが保持されます。カタログ内のマシンを以前のバージョンのマスターイメージに戻す（ロールバックする）ことができます。ユーザーがデスクトップに展開した更新プログラムで問題が発生した場合に、このタスクを実行します。これにより、ユーザーのダウンタイムが最小限に抑えられます。マスターイメージを削除、移動、または名前変更しないでください。それらを使用してカタログを元に戻すことはできません。

-  マシンが更新されると、自動的に再起動します。

マスターイメージの更新または作成

マシンカタログを更新する前に、既存のマスターイメージを更新するか、ホストハイパーバイザー上に新しいマスターイメージを作成します。

ハイパーバイザー上で、現在のVMのスナップショットを作成し、意味のある名前を付けます。このスナップショットは、必要に応じてカタログ内のマシンを元に戻す（ロールバックする）ために使用できます。
必要に応じて、マスターイメージの電源をオンにし、ログオンします。
更新プログラムをインストールするか、マスターイメージに必要な変更を加えます。
VMの電源をオフにします。
VMのスナップショットを作成します。Web Studioでカタログが更新されるときに認識される、意味のある名前を付けます。Web Studioでスナップショットを作成することもできますが、Citrixではハイパーバイザー管理コンソールを使用して作成することをお勧めします。その後、Web Studioでそのスナップショットを選択します。このプロセスにより、自動生成された名前ではなく、意味のある名前と説明を提供できます。GPUマスターイメージの場合、マスターイメージはXenServer®コンソールからのみ変更できます。

マスターイメージの変更

カタログ内のすべてのマシンに更新プログラムを準備して展開するには：

Web Studioにサインインします。
左ペインでマシンカタログを選択します。
カタログを選択し、アクションバーでマスターイメージの変更を選択します。
イメージページで、展開するホストとイメージを選択します。

ヒント：

MCSで作成されたカタログの場合、イメージにメモを追加して注釈を付けることができます。メモは最大500文字まで含めることができます。マスターイメージを変更するたびに、メモを追加したかどうかにかかわらず、メモ関連のエントリが作成されます。メモを追加せずにカタログを更新した場合、エントリはnull (-) と表示されます。イメージのメモ履歴を表示するには、カタログを選択し、下部のペインでテンプレートプロパティをクリックし、メモ履歴の表示をクリックします。
ロールアウト戦略ページで、マシンカタログ内のマシンを新しいマスターイメージで更新するタイミング（次回のシャットダウン時または即時）を選択します。

注：

ロールアウト戦略ページは、永続VMには適用されません。ロールアウトは非永続VMにのみ適用されるためです。
概要ページで情報を確認し、完了をクリックします。各マシンは更新後に自動的に再起動します。
- 更新の進行状況を追跡するには、マシンカタログでカタログを見つけ、インラインの進行状況バーと段階的な進行状況グラフを表示します。

Web StudioではなくPowerShell SDKを直接使用してカタログを更新する場合は、ハイパーバイザーテンプレート (VMTemplates) を指定します。これは、イメージまたはイメージのスナップショットの代替として使用します。

Azureベースのマシンカタログに新しいマスターイメージを展開するには：

Web Studioから、左ペインでマシンカタログを選択します。
Azureカタログを選択し、アクションバーでマスターイメージの変更を選択します。
マスターイメージの変更ページで、マスターイメージの下にあるイメージを選択します。ブレードには、リソースと同じリージョンに属するすべてのイメージが一覧表示されます。

ロールアウト戦略：
次回のシャットダウン時にイメージを更新すると、現在使用されていないマシン、つまりアクティブなユーザーセッションがないマシンにすぐに影響します。使用中のシステムは、現在のアクティブセッションが終了したときに更新を受け取ります。以下を考慮してください。
適用されるマシンで更新が完了するまで、新しいセッションを起動できません。
シングルセッションOSマシンでは、マシンが使用されていないとき、またはユーザーがログインしていないときに、マシンはすぐに更新されます。
子マシンを持つマルチセッションOSの場合、再起動は自動的に行われません。更新されたマスターイメージを適用するには、Studio、PowerShell、またはWorkspaceを使用してマシンを再起動します。マシンまたはハイパーバイザーからの再起動では、更新は適用されません。

ヒント:

ホスト接続の詳細設定を使用して、再起動されるマシンの数を制限します。これらの設定を使用して、特定のカタログに対して実行されるアクションを変更します。詳細設定はハイパーバイザーによって異なります。

マスターイメージのロールバック

更新された、または新しいマスターイメージを展開した後、それをロールバックできます。このプロセスは、新しく更新されたマシンで問題が発生した場合に必要になることがあります。ロールバックすると、カタログ内のマシンは最後に正常に動作していたイメージにロールバックされます。新しいイメージを必要とする新機能は利用できなくなります。展開と同様に、マシンのロールバックには再起動が含まれます。

Web Studioにサインインします
左ペインでマシンカタログを選択します
カタログを選択し、アクションバーでマスターイメージのロールバックを選択します
展開操作の前のセクションで説明されているように、以前のマスターイメージをマシンに適用するタイミングを指定します

ロールバックは、元に戻す必要があるマシンにのみ適用されます。新規または更新されたマスターイメージで更新されていないマシンは、通知メッセージを受信せず、強制的にログオフされることもありません。

ロールバックの進行状況を追跡するには、マシンカタログでカタログを見つけて、インラインの進行状況バーと段階的な進行状況グラフを表示します。

機能レベルの変更または変更の取り消し

マシンのVDAを新しいバージョンにアップグレードした後、マシンカタログの機能レベルを変更します。Citrixは、すべての最新機能にアクセスできるように、すべてのVDAを最新バージョンにアップグレードすることを推奨します。

マシンカタログの機能レベルを変更する前に:

アップグレードされたマシンを起動し、Controllerに登録させます。このプロセスにより、Web Studioはカタログ内のマシンがアップグレードを必要としていることを判断できます
- カタログの機能レベルを変更するには:

Web Studioにサインインします
左ペインでマシンカタログを選択します
カタログを選択します。下ペインの詳細タブにバージョン情報が表示されます
機能レベルの変更を選択します。Web Studioがカタログのアップグレードが必要であると検出した場合、メッセージが表示されます。プロンプトに従います。1つ以上のマシンをアップグレードできない場合、その理由を説明するメッセージが表示されます。すべてのマシンが正常に機能するように、Citrixは変更をクリックして続行する前に、マシンの問題を解決することを推奨します

カタログの変更が完了した後、カタログを選択し、アクションバーで機能レベルの変更を元に戻すを選択することで、マシンを以前のVDAバージョンに戻すことができます。

カタログのクローン作成

カタログをクローンする前に、次の考慮事項に注意してください:
オペレーティングシステムおよびマシン管理に関連する設定は変更できません。クローンされたカタログは、元のカタログからこれらの設定を継承します

注:

クローンするAzureカタログを選択し、マスターイメージを選択すると、ブレードにはリソースと同じリージョンに属するすべてのイメージが一覧表示されます。

カタログのクローン作成には時間がかかる場合があります。必要に応じて、進行状況を非表示を選択して、バックグラウンドでクローン作成を実行します
クローンされたカタログは元のカタログの名前を継承し、サフィックスCopyが付きます。名前は変更できます。「カタログの名前変更」を参照してください
クローン作成が完了したら、クローンされたカタログをデリバリーグループに必ず割り当ててください

Web Studioにサインインし、左ペインでマシンカタログを選択します
カタログを選択し、アクションバーでクローンを選択します
選択したマシンカタログのクローン作成ウィンドウで、クローンされたカタログの設定を表示し、必要に応じて設定を構成します。次へを選択して次のページに進みます
概要ページで、設定の概要を表示し、完了を選択してクローン作成を開始します
必要に応じて、進行状況を非表示を選択して、バックグラウンドでクローン作成を実行します

フォルダーを使用したカタログの整理

フォルダーを作成して、カタログを整理し、簡単にアクセスできるようにすることができます。たとえば、イメージの種類別または組織構造別にカタログを整理できます。

ヒント:

アクションバーの右上にあるフォルダーアイコンをクリックすると、マシンカタログノードの優先するデフォルトビュー（フォルダービューまたはリストビュー）を設定できます。

カタログフォルダーの作成

開始する前に、まずカタログをどのように整理するかを計画してください。次の点を考慮してください:

フォルダーは最大5レベルまでネストできます（デフォルトのルートフォルダーを除く）
カタログフォルダーには、カタログとサブフォルダーを含めることができます
Web Studioのすべてのノード（マシンカタログ、デリバリーグループ、アプリケーション、アプリケーショングループなど）は、バックエンドで同じフォルダーツリーを共有します。フォルダーの名前変更または移動時の名前の競合を避けるため、異なるノード間で最上位フォルダーに一意の名前を使用してください

New-BrokerAdminFolder SDKコマンドレットを使用してフォルダーを作成し、それをマシンカタログノードの下に表示させたい場合は、Set-BrokerAdminFolderMetadataコマンドレットを使用してContainsMachineCatalogsメタデータを追加する必要があります。

例:
```
 Set-BrokerAdminFolderMetadata -AdminFolderId {adminFolderUid} -Name ContainsMachineCatalogs -Value true
 
```

カタログフォルダーを作成するには、次の手順に従います:

左ペインで Machine Catalogs を選択します。
フォルダー階層でフォルダーを選択し、Action バーで Create Folder を選択します。
新しいフォルダーの名前を入力し、Done をクリックします。

ヒント：

意図しない場所にフォルダーを作成した場合、正しい場所にドラッグできます。

カタログの移動
カタログはフォルダー間で移動できます。詳細な手順は次のとおりです。
1. 左ペインで Machine Catalogs を選択します。
1. フォルダー別にカタログを表示します。フォルダー階層の上にある View all をオンにして、すべてのカタログを一度に表示することもできます。
1. カタログを右クリックし、Move Machine Catalog を選択します。
1. カタログの移動先フォルダーを選択し、Done をクリックします。

ヒント：

カタログをフォルダーにドラッグできます。

カタログフォルダーの管理

カタログフォルダーの削除、名前変更、移動が可能です。

フォルダーとそのサブフォルダーにカタログが含まれていない場合にのみ、フォルダーを削除できます。

フォルダーを管理するには、以下の手順に従います。

1. 左ペインで Machine Catalogs を選択します。
1. フォルダー階層でフォルダーを選択し、必要に応じて Action バーでアクションを選択します。
- フォルダーの名前を変更するには、Rename Folder を選択します。
- フォルダーを削除するには、Delete Folder を選択します。
- フォルダーを移動するには、Move Folder を選択します。
1. 画面の指示に従って残りの手順を完了します。

VDAのアップグレード

Studioインターフェイスを使用して、VDAを簡単にアップグレードできます。詳細およびステップバイステップのガイダンスについては、Citrix VDA Upgrade Service ドキュメントを参照してください。
カタログ作成の再試行

注：

この機能はMCSカタログにのみ適用されます。

失敗したカタログにはエラーアイコンが表示されます。詳細を確認するには、各カタログの Troubleshoot タブに移動します。カタログ作成を再試行する前に、以下の考慮事項に注意してください。
まずトラブルシューティング情報を確認し、問題を解決してください。この情報には、検出された問題が記述されており、それらを解決するための推奨事項が提供されています。
Operating system および machine management に関連する設定は変更できません。カタログは元の設定を継承します。
作成には時間がかかる場合があります。必要に応じて、Hide progress を選択して、バックグラウンドで作成を実行します。
カタログ作成を再試行するには、次の手順を実行します。
1. Web Studioから、左ペインで Machine Catalogs を選択します。
1. カタログを選択し、その Troubleshoot タブに移動します。

再試行のハイパーリンクをクリックして、カタログ作成を再試行します。
表示されるウィザードで、必要に応じて設定を変更します。変更の必要がない場合は、直接 Summary ページに進むことができます。
完了したら、Finish を選択して作成を開始します。

トークンを使用した非MCSプロビジョニングVDAの登録

非MCSプロビジョニングVDAの登録トークンを生成および管理できるようになりました。この実装により、MCSでVDAをプロビジョニングすることなく、WebSocket経由でのVDA登録が可能になります。この機能は、Linux Virtual Delivery Agent、macOS用Citrix Virtual Delivery Agent、およびCitrix Virtual Apps™ and Desktopsを使用した非ドメイン参加VDAもサポートします。

開始する前に

サイトを構成します。詳細については、「Create a site」を参照してください。
Delivery ControllerにTLS証明書をインストールします。詳細については、「Install TLS server certificates on Controllers」を参照してください。
Delivery Controllerを信頼するために、VDAにルートCAおよび中間CAをインストールします。
Delivery ControllerでWebSocket接続を有効にします。サイトに存在する各Delivery Controllerで次のコマンドを実行します。
```
New-ItemProperty "HKLM:\SOFTWARE\Citrix\DesktopServer\WorkerProxy" -Name "WebSocket_Enabled" -PropertyType "DWord" -Value 1 -Force

```
注：

WebSocketを有効にした後、Delivery Controllerを再起動してください。

登録トークンの生成

Citrix以外のプロビジョニングマシンに対してトークンベースの登録を有効にすることを決定したら、まずマシンカタログごとにトークンを生成し、VDAインストール管理者と共有する必要があります。
登録トークンの機能：
登録範囲：1～5000台のVDAマシン
有効期間：最大14日間

Web Studioを使用してカタログのトークンを生成するには、次の手順に従います。

1. Web Studio > マシンカタログで、プロビジョニング方法: 手動がマシン数列に表示されている、MCSでプロビジョニングされていないカタログを見つけます。
1. カタログを右クリックし、登録トークンの管理を選択します。
  - 1. 表示される登録トークンの生成ページで、次のトークン情報を入力します。
  - トークンの名前を入力します。
  - 有効期間を入力します。期間は14日以内である必要があります。トークンは指定された期間のみ有効です。
  - (オプション) トークンで登録されたVDAの電源管理のためにホスト接続を選択します。オプションには、このカタログのゾーン下のすべてのホスト接続が含まれます。
  - トークンの使用制限を入力します (1～5000)。

生成をクリックします。
- 1. 表示されるトークンが正常に生成されましたウィンドウで、トークンをコピーして安全な場所に保存するか、ダウンロードをクリックしてダウンロードフォルダーにダウンロードします。
トークンレコードがトークンリストに表示されます。
トークンをVDAインストール管理者と共有します。
- マシンにVDAとトークンをインストールする方法の詳細については、「VDAのインストール」を参照してください。

トークンの管理

-  トークンを失効させ、VDA登録に使用できないようにするには、2つのオプションがあります。

失効: トークンを失効させますが、ログ記録のためにリストに残します。
削除: トークンを失効させ、リストから削除します。

注:

期限切れのトークンは14日後に自動的に削除されます。

WebSocket VDA登録ツールを使用したマシンカタログへのマシンの登録

WebSocket VDA登録ツールは、VDAマシン向けのトークンベースの登録を容易にします。このツールは、登録トークンを使用してVDAをマシンカタログに追加することで、接続をWebSocket接続に変換するのに役立ちます。

注: - > このツールは、どのマシンカタログにも登録されていないVDAマシンを登録するために設計されています。

-  登録ツールを実行するには、次の手順に従います。

VDAにログインします。
ツールEnrollMachine.exeをC:\Program Files\Citrix\Virtual Desktop Agent\Web Socket Vda Enrollment Toolで見つけます。
適切な入力パラメーターを指定してツールを実行します。例: EnrollMachine.exe -websocket_token_string:xxxxxxxxx

次の表は、登録ツールの入力パラメーターについて説明しています。

パラメーター名	必須	説明	例
`-websocket_token_stdin`	はい	登録トークンを読み取ります。	`.\EnrollMachine.exe -websocket_token_stdin`
`-websocket_token_string`		コマンドラインパラメーターから登録トークンを直接読み取ります。	`.\EnrollMachine.exe -websocket_token_string:<token>`
`-websocket_token_file:[token-file-path]`		指定されたパスから登録トークンを読み取ります。	`.\EnrollMachine.exe -websocket_token_file:C:\token\test2.txt`
`log:[log-file-path]`	いいえ	登録ツールのログを表示します。	`.\EnrollMachine.exe log:[C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt]`
`-help`	いいえ	簡単なヘルプテキストを表示します。	`.\EnrollMachine.exe -help`

登録が成功すると、ツールとログに成功メッセージが表示されます。Web Studioにサインインして、VDAマシンがカタログに追加され、マシンのステータスが登録済みであることを確認してください。

トラブルシューティング

デフォルトでは、登録ツールのログは次の場所にあります。

C:\ProgramData\Citrix\EnrollMachine\EnrollMachine.txt

ログに別のパスを指定した場合は、log:[log-file-path]を使用してログを取得できます。
次の表は、登録ツールによって返されるコードを一覧表示します。
コード文字列説明
|–|–|–|
0 成功 VDAがマシンカタログに正常に追加されました。
-1 無効な引数登録トークンの入力パラメーターが無効です。
-2 BrokerAgentNotFound ブローカーエージェントサービスが見つかりません。
-3 無効なトークン入力されたトークンが無効です。

-4	TokenMissingRequiredClaims	トークンに必要なクレーム (例: CustomerId、Enrollment URIs) がありません。
-5	内部エラー	一般的なエラーが発生しました。

-6	タイムアウト	タスクがタイムアウトしました。
-7	FailedToDetermineMachineADJoinedStatus	マシンのAD参加ステータスを返すサービスが失敗しました。
-8	ADMachineFailedToFindSid	ADマシンのSidを返すサービスが失敗しました。
-9	EnrollRequestFailed	HTTPエラーによりリクエストが失敗しました。

-10	EnrollResponseMissingRequiredFields	登録ツールの応答にパラメーター`VirtualSiteId`がありません。
-11	権限不足	タスクを実行するために必要な権限がありません。
-12	FailedToDetermineMachineAadJoinedStatus	マシンのAD参加ステータスをチェックするサービスがエラーをスローしました。
-13	AadMachineFailedToFindDeviceId	システムによって追加された追加パラメーター`AAD device id`が空です。

-14	AadDeviceIdNotValid	システムによって追加された追加パラメーター`AAD device id`が有効なGUIDではありません。
-15	無効なMACアドレス	無効なMACアドレスです。
-16	FailedToGetComputerHostNameForVdaInstanceName	追加パラメーター`VdaInstanceName`を設定するためのコンピューターホスト名の取得に失敗しました。
-17	VirtualDesktopAgentRegistryKeyFailedToOpen	デリバリーコントローラーのリストを書き込むためのVDAレジストリキーを開くのに失敗しました。

-18 Failed Token reached the max count トークンが最大数に達しました。

PowerShellの使用

-  このセクションでは、PowerShellを使用してカタログを管理する方法について詳しく説明します。

-  [カタログに関連する警告とエラーの取得](/ja-jp/citrix-virtual-apps-desktops/install-configure/machine-catalogs-manage.html#retrieve-warnings-and-errors-associated-with-a-catalog)
-  [イメージへの説明の追加](/ja-jp/citrix-virtual-apps-desktops/install-configure/machine-catalogs-manage.html#add-descriptions-to-an-image)

カタログに関連する警告とエラーの取得

履歴エラーと警告を取得して、MCSマシンカタログの問題を理解し、それらの問題を修正できます。

PowerShellコマンドを使用して、次のことができます。

*  エラーまたは警告のリストを取得
*  警告の状態を**新規**から**確認済み**に変更

エラーまたは警告を削除

PowerShellコマンドの実行:

-  1.  PowerShellウィンドウを開きます。

asnp citrix* を実行して、Citrix固有のPowerShellモジュールをロードします。

エラーと警告のリストの取得:

Get-ProvOperationEvent コマンドを実行します。

パラメーターなしの場合: すべてのエラーと警告を取得
LinkedObjectType および LinkedObjectUid パラメーターを使用する場合: 特定のプロビジョニングスキームに関連付けられているすべてのエラーと警告を取得
EventId パラメーターを使用する場合: このイベントIDに一致する特定のエラーまたは警告を取得
Filter パラメーターを使用する場合: カスタマイズされたフィルターによってエラーまたは警告を取得

エラーまたは警告の状態を新規から確認済みに変更:

Confirm-ProvOperationEvent コマンドを実行します。

EventId パラメーターを使用する場合: このイベントIDに一致する特定のエラーまたは警告の状態を設定します。特定のイベントまたは警告の EventId は、Get-ProvOperationEvent コマンドの出力として取得できます。
LinkedObjectType および LinkedObjectUid パラメーターを使用する場合: 特定のプロビジョニングスキームに関連付けられているすべてのエラーと警告の状態を設定します。
All パラメーターを使用する場合: すべてのエラーと警告の状態を確認済みに設定します。

エラーまたは警告の削除:

Remove-ProvOperationEvent コマンドを実行します。

EventId パラメーターを使用する場合: このイベントIDに一致する特定のエラーまたは警告を削除します。特定のイベントまたは警告の EventId は、Get-ProvOperationEvent コマンドの出力として取得できます。
LinkedObjectType および LinkedObjectUid パラメーターを使用する場合: 特定のプロビジョニングスキームに関連付けられているすべてのエラーと警告を削除します。
All パラメーターを使用する場合: すべてのエラーと警告を削除します。

詳細については、Citrix PowerShell SDK を参照してください。

    -  ## ハイパーバイザーアクセスなしでのマシンの削除

    -  VMまたはプロビジョニングスキームを削除する場合、MCSはVMから、場合によってはベースディスクからもタグを削除する必要があります。これにより、削除オプションに含まれるリソースがMCSによって追跡または識別されなくなります。ただし、これらのリソースの一部はハイパーバイザーを介してのみアクセス可能です。ハイパーバイザーアクセスがない場合でも、`Remove-ProvVM` PowerShellの `PurgeDBOnly` オプションを使用して、VM、ベースディスク、ACG内のイメージなどのVMリソースオブジェクトをデータベースから削除します。

-  このオプションは以下で有効です。

サポートされているすべてのハイパーバイザー
- 永続VMおよび非永続VM

制限事項

-  `-PurgeDBOnly` コマンドと `-ForgetVM` コマンドを同時に使用することはできません。

PurgeDBOnlyコマンドの使用

PowerShellコマンド Remove-ProvVM -ProvisioningSchemeName SCVMM-MC -VMName SCVMM01 -ForgetVM を実行すると、以下のシナリオで削除操作が失敗する可能性があります。

*  ホスト接続がメンテナンスモードである

無効な資格情報
認証の失敗
不正な操作
ハイパーバイザーに到達できない

注:

Remove-ProvVM -ForgetVM は永続VMのみを対象とします。リスト内のVMのいずれかが非永続VMである場合、操作は失敗します。

ハイパーバイザーに到達できないために操作が失敗すると、次のプロンプトが表示されます。

Try to use -PurgeDBOnly option to clean DDC database.

Remove-ProvVM PowerShellコマンドで -PurgeDBOnly オプションを使用して、MCSデータベースからVMの参照を削除します。例:

Remove-ProvVM -ProvisioningSchemeName SCVMM-MC -VMName SCVMM01 -PurgeDBOnly

イメージへの説明の追加

マシンカタログのイメージ更新に関連する変更について、情報を提供する説明を追加できます。この機能を使用して、カタログの作成時、またはカタログの既存のマスターイメージを更新する際に説明を追加します。カタログ内の各マスターイメージの情報を表示することもできます。イメージの説明を追加または表示するには、次のコマンドを使用します。

*  マスターイメージを使用してマシンカタログを作成する際にメモを追加するには、`NewProvScheme` コマンドで `MasterImageNote` パラメーターを使用します。例:

```
C:\PS>New-ProvScheme -ProvisioningSchemeName <name> -HostingUnitName <name> -IdentityPoolName <name> -MasterImageVM
XDHyp:\HostingUnits\<hosting unit name>\<vm name>.vm\Base.snapshot -MasterImageNote "Note"
<!--NeedCopy--> ```

-  マシンカタログに関連付けられたマスターイメージを更新するには、`Publish-ProvMasterVMImage` コマンドでパラメーター `MasterImageNote` を使用します。例:

```
C:\PS>Publish-ProvMasterVMImage -ProvisioningSchemeName <name> -MasterImageVM XDHyp:\HostingUnits\<hosting unit name>\<vm name>.vm\base.snapshot -MasterImageNote "Note"
<!--NeedCopy--> ```

各イメージの情報を表示するには、Get-ProvSchemeMasterVMImageHistory コマンドを使用します。例:
```
 C:\PS>Get-ProvSchemeMasterVMImageHistory -ProvisioningSchemeName MyScheme -Showall
 
```
ロールバックの進行状況を追跡するには、マシンカタログでカタログを見つけ、インラインの進行状況バーと段階的な進行状況グラフを表示します。
次のシナリオを含む特定の状況では、ロールバックできません。（マスターイメージのロールバックオプションは表示されません）。
ロールバックする権限がない
カタログがMCSを使用して作成されていない
カタログがOSディスクのイメージを使用して作成された
- カタログの作成に使用されたスナップショットが破損している
  - カタログ内のマシンに対するユーザーの変更が永続化されない
  - カタログ内のマシンが実行中である

OSディスクのリセット

PowerShellコマンド Reset-ProvVMDisk を使用して、MCSで作成されたマシンカタログ内の永続VMのOSディスクをリセットします。現在、この機能はAWS、Azure、XenServer、Google Cloud、SCVMM、およびVMwareの仮想化環境に適用できます。

PowerShellコマンドを正常に実行するには、以下を確認してください。

-  ターゲットVMが永続MCSカタログ内にあること
    -  MCSマシンカタログが正常に機能していること
    -  これは、プロビジョニングスキームとホストが存在し、プロビジョニングスキームに正しいエントリがあることを意味します。

ハイパーバイザーがメンテナンスモードではないこと
ターゲットVMがパワーオフされ、メンテナンスモードになっていること

OSディスクをリセットするには、次の手順を実行します。

PowerShellウィンドウを開きます。
Citrix固有のPowerShellモジュールをロードするために、asnp citrix* を実行します。
次のいずれかの方法でPowerShellコマンド Reset-ProvVMDisk を実行します。
- VMのリストをコンマ区切りのリストとして指定し、各VMでリセットを実行します。
```
 Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName ("abc","def") -OS
 
```
- Get-ProvVM コマンドからの出力としてVMのリストを指定し、各VMでリセットを実行します。
```
 (Get-ProvVM -ProvisioningSchemeName "xxx") | Reset-ProvVMDisk "abc" -OS
 
```
- 名前で単一のVMを指定します。
  
```
- Reset-ProvVMDisk -ProvisioningSchemeName “xxx” -VMName “abc” -OS
  
```
- Get-ProvVM コマンドによって返される各VMに対して個別のリセットタスクを作成します。これは、各タスクがハイパーバイザーの機能チェック、各VMの接続チェックなど、同じ冗長なチェックを実行するため、効率が低下します。
```
 Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS
 
```
リセットされるVMのリストと、回復不能な操作であるという警告メッセージが表示された確認プロンプトが表示されます。回答を提供せずに Enter を押すと、それ以上のアクションは実行されません。

注:

リセットプロセスが完了するまで、VMをメンテナンスモードから解除したり、電源をオンにしたりしないでください。

PowerShellコマンド -WhatIf を実行すると、実行されるアクションが出力され、アクションを実行せずに終了できます。

次のいずれかの方法を使用して、確認プロンプトをバイパスすることもできます。
- -Force パラメーターを指定します。
```
 Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Force
 
```
- -Confirm:$false パラメーターを指定します。
```
 Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Confirm:$false
 
```
- Reset-ProvVMDisk を実行する前に、$ConfirmPreference を None に変更します。
```
 PS C:\Windows\system32> $ConfirmPreference='None'
 PS C:\Windows\system32> $ConfirmPreference
 None
 PS C:\Windows\system32> Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
 
```

Get-ProvTask を実行して、Reset-ProvVMDisk コマンドによって返されたタスクのステータスを取得します。

既存のプロビジョニングスキームのネットワーク設定を変更

既存のプロビジョニングスキームのネットワーク設定を変更して、新しいVMが新しいサブネットワーク上に作成されるようにすることができます。ネットワーク設定を変更するには、Set-ProvScheme コマンドでパラメーター -NetworkMapping を使用します。

注:

この機能は、Citrix Virtual Apps and Desktops 2203 LTSR CU3 以降のバージョンでサポートされています。

既存のプロビジョニングスキームのネットワーク設定を変更するには、次の手順を実行します。

PowerShell ウィンドウで、asnp citrix* コマンドを実行して PowerShell モジュールをロードします。
(Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps を実行して、変更するネットワークパスにアクセスします。

新しいネットワーク設定に変数を割り当てます。例:

$NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"}
<!--NeedCopy-->

Set-ProvScheme -ProvisioningSchemeName "name" -NetworkMapping $NewNetworkMap を実行します。
(Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps を実行して、既存のプロビジョニングスキームの新しいネットワーク設定を確認します。

マシンカタログのバージョン管理

MCS マシンカタログが Set-ProvScheme コマンドで更新されると、現在の構成がバージョンとして保存されます。その後、PowerShell コマンドを使用してマシンカタログのさまざまなバージョンを管理できます。次のことができます。

マシンカタログのバージョンリストを表示
以前のバージョンを使用してマシンカタログを更新
そのマシンカタログのVMによって使用されていないバージョンを手動で削除
マシンカタログによって保持される最大バージョン数を変更（デフォルトは99）
```
 -  バージョンには、マシンカタログの次の情報が含まれます。
```
VMCpuCount
VMMemoryMB
CustomProperties
ServiceOffering
MachineProfile
NetworkMapping
SecurityGroup

マシンカタログのさまざまなバージョンを管理するには、次のコマンド（例として提供）を実行します。

マシンカタログのさまざまなバージョンの構成詳細を表示するには:
```
 Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog
 
```

マシンカタログの特定のバージョンの構成詳細を表示するには:

 Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 2
 <!--NeedCopy-->

マシンカタログに関連付けられている合計バージョン数を表示するには:

```
(Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog).Count

```

以前のバージョンを使用してマシンカタログを更新するには:

 Set-ProvScheme -ProvisioningSchemeName AzureCatalog -Version 2
 <!--NeedCopy-->

そのマシンカタログのVMによって使用されていないバージョンを手動で削除するには:
```
 Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 3
 
```
マシンカタログによって保持される最大バージョン数を設定するには（デフォルトは99）。この設定はすべてのカタログに適用されます。たとえば、この場合、すべてのMCSプロビジョニング済みカタログに対して最大15バージョンが保持されます。
```
 Set-ProvServiceConfigurationData -Name "MaxProvSchemeVersions" -Value 15
 
```

バージョン数が最大バージョン数に達した場合、マシンカタログ内のいずれかのVMで古いバージョンが使用されていると、新しいバージョンを作成できません。その場合は、次のいずれかを実行します。

マシンカタログによって保持される最大バージョン数の制限を増やします。
古いバージョンを使用している一部のVMを更新して、それらの古いバージョンがどのVMからも参照されなくなり、削除できるようにします。

マシンプロファイルベースではないマシンカタログをマシンプロファイルベースのマシンカタログに変換

VM、テンプレート仕様 (Azure の場合)、起動テンプレート (AWS の場合)、または VMware テンプレート (VMware の場合) をマシンプロファイル入力として使用し、マシンプロファイルに基づかないマシンカタログをマシンプロファイルに基づくマシンカタログに変換できます。カタログに追加される新しい VM は、明示的なカスタムプロパティによって上書きされない限り、マシンプロファイルからプロパティ値を取得します。

注:

既存のマシンプロファイルに基づくマシンカタログを、マシンプロファイルに基づかないマシンカタログに変更することはできません。

これを行うには:

VM を使用し、マシンプロファイルなしで永続または非永続マシンカタログを作成します。
PowerShell ウィンドウを開きます。

Set-ProvScheme コマンドを実行して、マシンプロファイルからのプロパティ値をマシンカタログに追加された新しい VM に適用します。例:

Azure の場合:

 Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile XDHyp:\HostingUnits\<HostingUnitName>\machineprofile.folder\<ResourceGroupName>\<TemplateSpecName>\<VersionName>
 <!--NeedCopy-->

AWS の場合:

 Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\<launch-template>.launchtemplate\<launch-template-version>.launchtemplateversion"
 <!--NeedCopy-->

VMware の場合:
```
  Set-ProvScheme -ProvisioningSchemeName "my-prov-scheme" -MachineProfile "XDHyp:\HostingUnits\my-hosting-unit\my-template.template"
 
```
注:

FolderID をカスタムプロパティとして設定し、VMware テンプレートから FolderID が派生しないようにします。

アクティブなコンピューターアカウントのID情報の修復

ID関連の問題があるアクティブなコンピューターアカウントのID情報をリセットできます。マシンパスワードと信頼キーのみをリセットするか、IDディスクのすべての構成をリセットするかを選択できます。この実装は、永続および非永続 MCS マシンカタログの両方に適用されます。

注:

現在、この機能は AWS、GCP、Azure、SCVMM、XenServer、および VMware の仮想化環境でサポートされています。

条件

IDディスクを正常にリセットするには、以下を確認してください。

VM をシャットダウンし、メンテナンスモードに設定
PowerShell コマンドにパラメーター -OS を含めない

IDディスクのリセット

IDディスクをリセットするには:

PowerShell ウィンドウを開きます。
asnp citrix* を実行して、Citrix 固有の PowerShell モジュールをロードします。
ID情報をリセットします。
- マシンパスワードと信頼キーのみをリセットするには、次のコマンドを実行します。
```
 Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
 
```
  コマンドで使用されるパラメーターの説明は次のとおりです。
  - IdentityAccountName: 修復する必要があるIDアカウントの名前。
  - PrivilegedUserName: IDプロバイダー (AD または AzureAD) に対する書き込み権限を持つユーザーアカウント。
  - PrivilegedUserPassword: PrivilegedUserName のパスワード。
  - Target: 修復アクションのターゲット。アカウントパスワード/信頼キーを修復するための IdentityInfo、および Microsoft Entra ハイブリッド参加済みマシンIDのユーザー証明書属性を修復するための UserCertificate を指定できます。
- IDディスクのすべての構成をリセットするには、次のコマンドを次の順序で実行します。
```
 Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
 
```
```
 Reset-ProvVMDisk ProvisioningSchemeName <name> -VMName <name>  -Identity
 
```
- IDディスクを完全に再作成するには:
```
 Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMname <name> -Identity -Recreate
 
```
  注:
  
  マシンが VDA バージョン 2511 以降を使用する Windows マシンの場合、-Recreate 設定に関係なく、以前と同じ MachineGuid を引き続き使用します。
アクションを確定するには y と入力します。-Force パラメーターを使用すると、確認プロンプトをスキップすることもできます。例えば:
```
Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMName <name> -Identity -Force

```
更新されたIDディスク設定を確認するには、Get-ProvVM -ProvisioningSchemeName <name -VMName <name> を実行します。IDディスクの属性（例えば、IdentityDiskId）は更新されている必要があります。StorageId と IdentityDiskIndex は変更されてはなりません。

既存のマシンカタログでのキャッシュ構成の変更

MCSIOが有効な非永続カタログを作成した後、Set-ProvSchemeコマンドを使用して以下のパラメーターを変更できます。

WriteBackCacheMemorySize
WriteBackCacheDiskSize

この機能は現在、以下に適用されます。

GCPおよびMicrosoft Azure環境
MCSIOが有効な非永続カタログ

要件

キャッシュ構成を変更するための要件は次のとおりです。

VDAの最新バージョン（2308以降）への更新

既存のマシンカタログでパラメーター UseWriteBackCache を有効にする。UseWriteBackCache を有効にしてマシンカタログを作成するには、New-ProvScheme を使用します。例えば:

 New-ProvScheme -ProvisioningSchemeName $CatalogName -HostingUnitUid $HostingUnitUid `
 -IdentityPoolUid $acctPool.IdentityPoolUid -CleanOnBoot `
 -MasterImageVM $MasterImage `
 -ServiceOffering $ServiceOffering `
 -NetworkMap $NetworkMap `
 -SecurityGroup $SecurityGroup `
 -UseWriteBackCache -WriteBackCacheDiskSize 8
 <!--NeedCopy-->

キャッシュ構成の変更

Set-ProvSchemeコマンドを実行します。例えば:

Set-ProvScheme -ProvisioningSchemeName $provScheme.ProvisioningSchemeName -WriteBackCacheDisk32 -WriteBackCacheMemorySize 128
<!--NeedCopy-->

注:

WriteBackCacheDiskSize の値は、少なくとも1 GBのキャッシュディスクストレージが必要なため、ゼロより大きい値である必要があります。

WriteBackCacheMemorySize の値は、マシンカタログのメモリサイズよりも小さい値である必要があります。

これらの変更は、変更後にカタログに追加された新しいVMにのみ影響します。既存のVMはこれらの変更の影響を受けません。

ローカルファイル共有アクセスによるVDA更新サポート

PowerShellコマンドレットを介してVDAインストーラーの場所を指定することで、各VDAがCitrix Managed Azure CDNから新しいVDAインストーラーを取得するためのネットワークルールを提供する手間を省きます。

PowerShellコマンドレット

ローカルファイル共有からインストーラーを使用できるようにする、New-VusCatalogSchedule および New-VusMachineUpgrade コマンドレットに追加された2つの新しいオプションパラメーター

VdaWorkstationPackageUri - ワークステーションOS VDAインストーラーへのUNCパスを指定
VdaServerPackageUri - サーバーOS VDAインストーラーへのUNCパスを指定

前提条件

VDA 2311に付属するVUSエージェントインストーラー
VDAアップグレードエージェントのバージョン7.40.0.35以降（VDAインストーラーバージョン2311以降を使用）
Virtual Apps and Desktops Remote PowerShell SDKバージョン7.40以降（2024年1月10日以降にリリース）

ファイル共有権限の設定方法

VDAインストーラーパッケージを含むネットワーク共有には、ローカルシステム（NT AUTHORITY\SYSTEMプリンシパル）として実行されるVDAアップグレードエージェントサービスに対する読み取りアクセス権が必要です。

ドメイン参加済みファイル共有権限

VDAマシンがドメインに参加している場合、ローカルシステムアカウント（VUAはローカルシステムとして実行）は、ネットワーク共有にアクセスする際にコンピューターの資格情報を使用します。

最小特権の権限は、ドメインコンピューターに読み取りアクセス権を付与することで設定できます。
1. ファイルを共有したいネットワーク上のユーザーを選択します。
2. 詳細な共有設定をクリックし、ファイルとプリンターの共有をオンにします。
ドメイン非参加ファイル共有権限

VDAマシンがドメインに参加していない場合、ローカルシステムアカウント（VUAはローカルシステムとして実行）は、ネットワーク共有にアクセスする際に匿名ログオンを使用します。

共有フォルダーを選択します
パスワード保護を無効にします
1. フォルダーのプロパティに移動します
2. ネットワークと共有センターを選択します
3. パスワード保護共有をオフにします
詳細な共有をクリックして共有アクセス許可を付与します
1. アクセス許可を選択します
2. 匿名ログオンに読み取り共有アクセス許可を付与します
セキュリティタブを選択してフォルダーアクセス許可を付与します
1. 編集をクリックして共有フォルダーにアクセス許可を追加します
2. 共有フォルダーを選択して匿名ログオンにフォルダーアクセス許可を付与します
詳細設定をクリックしてファイルとプリンターの共有をオンにします
共有フォルダー名をネットワークアクセスセキュリティポリシーに追加します

注記:

変更をすぐに有効にするには、マシンを再起動してください。

ローカルファイル共有からのVDAアップデート

VDAインストーラーをダウンロードし、共有ファイルに配置します。

注記:

Virtual Upgrade Serviceを使用すると、Current ReleaseトラックまたはLTSRトラックのいずれかを選択できます。

例: マシンカタログがCurrent Release 2311に設定されており、VDAバージョンが2305の場合、VDAをバージョン2311にアップグレードする必要があります。
1. 弊社のWebサイトのダウンロードページに移動します。
2. 製品としてCitrix Virtual Apps and Desktopsを選択します。
3. Citrix Virtual Apps and Desktops 7 2311, All Editionsを選択します。
4. 製品ISOに含まれるが個別にパッケージ化されているコンポーネントの展開可能な項目からVDAインストーラーを選択します。
カタログタイプに基づいて関連するVDAインストーラーを選択します。
- カタログタイプがマルチセッションの場合は、マルチセッションOS VDAインストーラーをダウンロードします
- カタログタイプがシングルセッションの場合は、シングルセッションOS VDAインストーラーをダウンロードします
- カタログタイプがRemote PC Accessの場合は、シングルセッションOSコアサービスVDAインストーラーをダウンロードします

注記:

ファイル共有インストーラーのバージョンは、VUSによってクラウドに公開された最新のインストーラーバージョンと完全に一致している必要があります。

VMのストレージ移行

VMwareおよびXenServer環境では、既存のVMのディスクストレージを古いストレージから新しいストレージに移動できます。移行中、MCSは電源管理、OSディスクのリセットなどのVM機能を保持します。新しいディスクストレージを使用して、新しいVMをマシンカタログに追加することもできます。これを行うには、PowerShellコマンドMove-ProvVMDiskを使用します。

フルクローン永続VMと非永続VMを移行できます。

永続フルクローンVMの場合: OSディスク、IDディスク、および非MCSプロビジョニングディスク
非永続VMの場合: OSディスク、IDディスク、およびライトバックキャッシュ（WBC）ディスク

新しいストレージは、次の条件を満たす必要があります。

古いストレージと同じクラスター内にあること
VMが実行されているホストが、古いデータストアと新しいデータストアの両方にアクセスできること

ディスクストレージの移行

ディスクストレージを移行するには:

既存のホスティングユニットに宛先ストレージを追加します。PowerShellコマンドAdd-Hyphostingunitstorageを実行して、宛先ストレージを追加できます。

古いストレージに新しいVMを追加したくない場合は、古いストレージをSupersededに変更します。これは、StudioまたはPowerShellコマンドを使用して実行できます。Studioについては、「ストレージの編集」を参照してください。または、Set-Hyphostingunitstorageを実行し、Supersededをtrueに設定して、古いストレージでの新しいVM作成を無効にします。
注記:

非永続VMの場合:
- WBCを使用している場合は、ホスティングユニットでWBC宛先ストレージを構成します。
- OS宛先ストレージが構成されている場合、WBC（使用されている場合）はOS宛先ストレージと互換性がある必要があります。
- OS宛先ストレージが構成されていない場合、WBC（使用されている場合）は現在のOSストレージと互換性がある必要があります。
VMをシャットダウンし、メンテナンスモードをオンにします。
プロビジョニングスキーム、ホスティングユニット、OSディスクストレージ、およびWBCディスクストレージに関する情報を取得します。
- OSストレージ情報については、ProvResourceInStorageを実行します。例:
```
 $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
 $result
 $result.ProvResourceInStorage | Format-List -Property *
 
```
- WBCストレージ情報については、TemporaryStorageInfoを実行します。例:
```
 $result=Get-ProvSchemeResourceInStorage -ProvisioningSchemeName xxxxx
 $result
 $result.TemporaryStorageInfo | Format-List -Property *
 
```
Move-ProvVMDisk PowerShellコマンドを使用して、OSディスク、IDディスク、およびWBCディスク（非永続VMに適用）を宛先ストレージに移行します。
注記:
- DiskTypeおよびDestinationStorageIdパラメーターには、常にOSディスクとIDディスクを指定してください。
- OSディスクとIDディスクのDestinationStorageIdは同じである必要があります。

例:

永続VM:

```
(Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName "myFullCloneProvScheme" -VMName "machine01" -DiskType OS,Identity -DestinationStorageId datastore1,datastore1
<!--NeedCopy--> ```

> **重要:**
>
> 永続VMの場合、すべてのディスクが移動されます。移動するディスクを選択することはできません。

非永続VM:

```
(Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName "myCleanOnBootProvScheme" -VMName "machine01" -DiskType OS,Identity,WBC -DestinationStorageId None,None,datastore1
<!--NeedCopy--> ```

> **重要:**
>
> -  特定のディスクを移行したくない場合は、`DestinationStorageId` パラメーターの値を `None` に設定します。
> -  VMにWBCディスクがある場合は、`DiskType` パラメーターにWBCディスクを追加し、`DestinationStorageId` パラメーターに必要な情報を追加します。

既存のMCSプロビジョニング済みカタログを準備済みイメージマシンカタログに移行

PowerShellコマンド Set-ProvSchemeImage を使用して、既存のMCSプロビジョニング済みマシンカタログを準備済みイメージマシンカタログに変換できます。ただし、移行後にレガシーカタログに戻すことはできません。現在、この機能はAzureおよびVMware仮想化環境に適用可能です。

制限事項

以下の制限事項を考慮してください。

MCSカタログが永続データディスクを使用している場合、そのカタログを準備済みイメージを使用するように移行することはできません。
MCSカタログがアンマネージドディスクを使用している場合、そのカタログを準備済みイメージを使用するように移行することはできません。

準備済みイメージマシンカタログへの移行

移行するには、次の手順を実行します。

StudioまたはPowerShellコマンドを使用して、イメージ定義とイメージバージョンを作成します。イメージ定義とイメージバージョンの作成手順については、以下を参照してください。
- Azure:
  - Web Studio
  - PowerShell
- VMware:
  - Web Studio
  - PowerShell
プロビジョニングスキームのUIDを取得するために、Get-ProvScheme コマンドを実行します。例:
```
Get-ProvScheme -ProvisioningSchemeName <name> | select ProvisioningSchemeName, ProvisioningSchemeUid

```
イメージ定義名、イメージバージョン仕様のUIDを取得するために、Get-ProvImageVersionSpec コマンドを実行します。例:
```
Get-ProvImageVersionSpec -ImageDifinitionName <name> -Filter {IsPrepared -eq $true} | select ImageDefinitionName ImageVersionSpecUId

```
既存のMCSプロビジョニング済みマシンカタログを準備済みイメージマシンカタログに移行するために、Set-ProvSchemeImage コマンドを実行します。例:
```
Set-ProvSchemeImage -ProvisioningSchemeName [ProvisioningSchemeName] -ImageVersionSpecUid [ImageVersionSpecUid]

```

カタログが移行されたことを確認するために、Get-ProvScheme コマンドを実行します。例:

Get-ProvScheme -ProvisioningSchemeName <name> | select ProvisioningSchemeName, ProvisioningSchemeUid, ImageVersionSpecUid
<!--NeedCopy-->

トラブルシューティング

「Power State Unknown」ステータスのマシンについては、ガイダンスとしてCTX131267を参照してください。
不明な電源状態を継続的に表示するVMを修正するには、「How to fix VMs that continuously show an unknown power state」を参照してください。

次のステップ

特定のクラウドサービスカタログの管理については、以下を参照してください。

このコンテンツの正式なバージョンは英語で提供されています。Cloud Software Groupドキュメントのコンテンツの一部は、お客様の利便性のみを目的として機械翻訳されています。Cloud Software Groupは機械翻訳されたコンテンツを管理していないため、誤り、不正確な情報、不適切な用語が含まれる場合があります。英語の原文から他言語への翻訳について、精度、信頼性、適合性、正確性、またはお使いのCloud Software Group製品またはサービスと機械翻訳されたコンテンツとの整合性に関する保証、該当するライセンス契約書またはサービス利用規約、あるいはCloud Software Groupとのその他すべての契約に基づき提供される保証、および製品またはサービスのドキュメントとの一致に関する保証は、明示的か黙示的かを問わず、かかるドキュメントの機械翻訳された範囲には適用されないものとします。機械翻訳されたコンテンツの使用に起因する損害または問題について、Cloud Software Groupは責任を負わないものとします。

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

マシンカタログの管理

April 7, 2026

寄稿者:

C C

April 7, 2026

寄稿者:

C C

この記事の概要

はじめに
マシンカタログの管理
Web Studioの使用
カタログの詳細の表示
カタログへのマシンの追加
カタログからのマシンの削除
カタログの編集
カタログの名前変更
カタログを別のゾーンに移動
カタログの削除
AzureのレガシーMCSカタログをマシンプロファイルベースのカタログに変換
カタログ内のActive Directoryコンピューターアカウントの管理
カタログの更新
機能レベルの変更または変更の取り消し
カタログのクローン作成
フォルダーを使用したカタログの整理
VDAのアップグレード
カタログ作成の再試行
トークンを使用した非MCSプロビジョニングVDAの登録
PowerShellの使用
カタログに関連する警告とエラーの取得
イメージへの説明の追加
OSディスクのリセット
既存のプロビジョニングスキームのネットワーク設定を変更
マシンカタログのバージョン管理
マシンプロファイルベースではないマシンカタログをマシンプロファイルベースのマシンカタログに変換
アクティブなコンピューターアカウントのID情報の修復
既存のマシンカタログでのキャッシュ構成の変更
ローカルファイル共有アクセスによるVDA更新サポート
VMのストレージ移行
既存のMCSプロビジョニング済みカタログを準備済みイメージマシンカタログに移行
トラブルシューティング
次のステップ

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

マシンカタログの管理

はじめに

永続インスタンスについて