Citrix DaaS™

マシンカタログの管理

April 6, 2026

寄稿者:

C C

注：

この記事では、Studio および PowerShell コマンドを使用してカタログを管理する方法について説明します。Quick Deploy ノードを使用してカタログを作成し、そのノードを使用してカタログの管理を継続する場合は、「Quick Deploy でのカタログの管理」を参照してください。

はじめに

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

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

Machine Creation Services™ (MCS) を使用して作成されたプールされたランダムマシンを含むカタログは、カタログで使用されているイメージを更新し、その後マシンを更新することでマシンを維持します。この方法により、多数のユーザーマシンを効率的に更新できます。
静的で永続的に割り当てられたマシンを含むカタログの場合、それらのカタログが現在使用しているイメージまたはテンプレートを管理できますが、後でカタログに追加するマシンのみが新しいイメージまたはテンプレートを使用して作成されます。
Remote PC Access カタログの場合、ユーザーマシンのアップデートは Studio の外部で管理します。このタスクは、個別に、またはサードパーティのソフトウェア配布ツールを使用して一括で実行します。
ホストハイパーバイザーおよびクラウドサービスへの接続の作成と管理については、「接続とリソースの作成と管理」を参照してください。
注：

MCS は Windows 10 IoT Core および Windows 10 IoT Enterprise をサポートしていません。詳細については、Microsoft のサイトを参照してください。

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

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

永続ディスクカタログの場合、既存のマシンは新しいイメージに更新されませんが、カタログに追加された新しいマシンは新しいイメージを使用します。
非永続ディスクカタログの場合、マシンイメージは、Studio または PowerShell 内でマシンが再起動された場合にのみ次回更新されます。Studio の外部でハイパーバイザーからマシンが再起動された場合、ディスクはリセットされません。
永続化しないカタログの場合、異なるマシンに異なるイメージを使用したい場合は、イメージを別々のカタログに配置する必要があります。

マシンカタログの管理

マシンカタログは、次の 2 つの方法で管理できます。
Studio の使用
PowerShell の使用

Studio の使用

このセクションでは、Studio を使用してカタログを管理する方法について詳しく説明します。
カタログの詳細の表示
カタログへのマシンの追加
カタログからのマシンの削除
カタログの編集
カタログの名前変更
カタログの削除
カタログ内の Active Directory コンピューターアカウントの管理
カタログのマスターイメージの変更
MCS プロビジョニング済みカタログをマスターイメージの使用から準備済みイメージの使用に変換。
機能レベルの変更または変更の取り消し
カタログのクローン作成

カタログの詳細の表示

検索機能を使用して、特定のマシンカタログを見つけます。手順については、「インスタンスの検索」を参照してください。
検索結果から、必要に応じてカタログを選択します。

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

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


マシンタイプ	カタログ内のマシンでサポートされているセッションの種類。可能な値には以下が含まれます • 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コンピューターアカウントがあることを確認してください。既存のアカウントを使用している場合、追加できるマシンの数は利用可能なアカウントの数によって制限されます
-  Studioを使用して追加のマシン用のActive Directoryコンピューターアカウントを作成する場合、適切なドメイン管理者権限が必要です

ヒント:

マシンカタログにマシンを追加するために使用されるCitrix DaaSアカウントのAD権限が制限されている場合は、Log on to.. 画面で、使用するすべてのCloud Connectorを追加してください。

カタログにマシンを追加するには:

Studioから、左ペインで マシンカタログ を選択します。
マシンカタログを選択し、アクションバーで マシンの追加 を選択します。
仮想マシン ページで、追加する仮想マシンの数を選択します。
マシンID ページで、次のように設定を構成します。
- リストからIDを選択します
- 該当する場合、アカウントを作成するか既存のアカウントを使用するか、およびそれらのアカウントの場所 (ドメイン) を指定します
- 追加するVMの数に対して既存のActive Directoryアカウントが不足している場合は、アカウントが作成されるドメインと場所を選択します。
- 既存のActive Directoryアカウントを使用する場合は、アカウントを参照するか、インポート を選択してアカウント名を含む ` .csv ` ファイルを指定します。追加するすべてのマシンに対して十分なアカウントがあることを確認してください。Studioはこれらのアカウントを管理します。そのインターフェイスですべてのアカウントのパスワードをリセットできるようにするか、すべてのアカウントで同じである必要があるアカウントパスワードを指定します。
- このIDプールが他のカタログで使用されている場合、Studioを使用して別のプールに変更することはできません。代わりに、Set-ProvScheme PowerShellコマンドレットを使用してください。詳細については、Citrix Virtual Apps and Desktops SDKドキュメントを参照してください
- 連続する数字または文字が表示される場所にハッシュマークを使用して、アカウントの命名スキームを指定します。たとえば、PC-Sales-## (0-9が選択されている場合) という命名スキームは、PC-Sales-01、PC-Sales-02、PC-Sales-03などのコンピューターアカウントになります
- オプションで、アカウント名の開始文字を指定できます。
  
  アカウント名の開始文字を指定する場合、次のシナリオに注意してください。開始番号または文字がすでに使用されている場合、最初に作成されるアカウントは、その後に続く最も近い未使用の番号または文字を使用して命名されます。
  
  MCS を使用して展開されるマシンのシーケンス番号を PowerShell コマンドでカスタマイズする方法については、「マシン名のシーケンス番号を管理する」を参照してください。
- 1. [ドメイン資格情報] ページで、[資格情報の入力] を選択し、マシンアカウントを作成するのに十分な権限を持つユーザー資格情報を入力します。

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

CSV ファイルを使用してマシンをカタログに一括追加する

CSV ファイルを使用してマシンを一括追加できます。この機能は、MCS を介してプロビジョニングされたカタログを除くすべてのカタログで利用できます。

マシンをカタログに一括追加するには、次の手順を実行します。

Studio から、左側のペインで [マシンカタログ] を選択します。
マシンカタログを選択し、アクションバーで [マシンの追加] を選択します。[マシンの追加] ウィンドウが表示されます。
[CSV ファイルの追加] を選択します。[マシンの一括追加] ウィンドウが表示されます。
[CSV テンプレートのダウンロード] を選択します。
テンプレートファイルに記入します。
ファイルをドラッグするか、参照してアップロードします。
[検証] を選択して、インポートの検証チェックを実行します。
[インポート] を選択してプロセスを完了します。

CSV ファイルを使用してマシンを追加する際の考慮事項

注:

Active Directory 以外のユーザーの場合、名前をこの形式で入力する必要があります: <identity provider>:<user name>。例: AzureAD:username。

VM 名は大文字と小文字を区別します。VM パスを入力する際は、VM 名を正しく入力していることを確認してください。

CSV テンプレートファイルを編集する際は、次の点に注意してください。

この機能により、CSV ファイルを介してマシンを一括追加する際の柔軟性が向上します。ファイルには、マシンのみ（ユーザーの自動割り当てで使用する場合）を追加することも、ユーザー割り当てとともにマシンを追加することもできます。データを次の形式で入力します。
- マシンアカウントとユーザー名 (samName) のペアの場合:
- Domain\ComputerName1, Domain\Username1
- Domain\ComputerName2, Domain\Username1;Domain\Username2
- Domain\ComputerName3, AzureAD:username
- マシンアカウントのみの場合:
- Domain\ComputerName1
- Domain\ComputerName2
- VM とユーザー名のペアの場合:
- XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName1.vm,Domain\ComputerName1,Domain\Username1
- XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName2.vm,Domain\ComputerName2,Domain\Username2
- VM のみの場合:
- XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName1.vm,Domain\ComputerName1
- XDHyp:\Connections\ConnectionName\RegionName\vm.folder\VMName2.vm,Domain\ComputerName2
  
  例: `XDHyp:\Connections\xpace-scale\East US.region\vm.folder\wsvdaV3-2.vm`
  
  ここで、
- `xpace-scale` は ConnectionName です: [ホスティング] > [接続とリソースの追加] で入力した接続の名前です。詳細については、「接続とリソースを作成する」を参照してください。
- `East US.region` は RegionName です: 拡張子 .region を持つリージョンの名前です。
- `wsvdaV3-2.vm` は VMName です: 拡張子 .vm を持つ仮想マシンの名前です。
- 1 つのファイルに含めることができるマシンの最大数は 1,000 台です。1,000 台を超えるマシンをインポートするには、それらを異なるファイルに分散させ、それらのファイルを 1 つずつインポートします。1,000 台を超えるマシンをインポートしないことをお勧めします。そうしないと、カタログの作成に長い時間がかかる可能性があります。
同じ [マシンの追加] ページで、カタログからマシンをエクスポートすることもできます。エクスポートされたマシンの CSV は、マシンを一括追加する際のテンプレートとして使用できます。マシンをエクスポートするには:

Studio から、左側のペインで [マシンカタログ] を選択します。
マシンカタログを選択し、アクションバーで [マシンの追加] を選択します。[マシンの追加] ウィンドウが表示されます。
[CSV ファイルにエクスポート] を選択します。マシンのリストを含む CSV ファイルがダウンロードされます。
必要に応じて CSV ファイルを開いてマシンを追加または編集します。保存した CSV ファイルを使用してマシンを一括追加するには、前のセクション「CSV ファイルを使用してマシンをカタログに一括追加する」を参照してください。

注:

この機能は、リモート PC アクセスおよび MCS プロビジョニングされたカタログでは利用できません。

CSV ファイルでのマシンのエクスポートとインポートは、同じ種類のカタログ間でのみサポートされます。

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

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

トラブルシューティング

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

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

ログに別のパスを指定した場合は、log:[log-file-path] を使用してログを取得できます。

次の表に、登録ツールによって返されるコードを示します。

コード	文字列	説明
0	Success	VDA がマシンカタログに正常に追加されました。

-1 InvalidArgument 登録トークンの入力パラメーターが無効です。
-2 BrokerAgentNotFound ブローカーエージェントサービスが見つかりません。
-3 TokenInvalid 入力されたトークンが無効です。

-4	TokenMissingRequiredClaims	トークンに必要なクレーム（CustomerId や登録 URI など）がありません。
-5	InternalError	一般的なエラーが発生しました。
-6	TimedOut	タスクがタイムアウトしました。
-7	FailedToDetermineMachineADJoinedStatus	マシンの AD 参加ステータスを返すサービスが失敗しました。
-8	ADMachineFailedToFindSid	AD マシンの SID を返すサービスが失敗しました。
-9	EnrollRequestFailed	HTTP エラーにより要求が失敗しました。
-10	EnrollResponseMissingRequiredFields	登録ツールの応答にパラメーター `VirtualSiteId` がありません。
-11	InsufficientPermission	タスクを実行するために必要な権限がありません。
-12	FailedToDetermineMachineAadJoinedStatus	マシンの AD 参加ステータスをチェックするサービスがエラーをスローしました。
-13	AadMachineFailedToFindDeviceId	システムによって追加された追加パラメーター `AAD device id` が空です。
-14	AadDeviceIdNotValid	システムによって追加された追加パラメーター `AAD device id` が有効な GUID ではありません。
-15	NoValidMacAddress	無効な MAC アドレスです。
-16	FailedToGetComputerHostNameForVdaInstanceName	追加パラメーター `VdaInstanceName` を設定するためのコンピューターホスト名の取得に失敗しました。

-17

VirtualDesktopAgentRegistryKeyFailedToOpen

デリバリーコントローラーのリストを書き込むための VDA レジストリキーを開くのに失敗しました。

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

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

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

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

カタログからマシンを削除するには：

Studio で、左側のペインで [マシンカタログ] を選択します。
カタログを選択し、アクションバーで [マシンの表示] を選択します。
1 つ以上のマシンを選択し、アクションバーで [削除] を選択します。
カタログから永続マシンを削除する場合は、ハイパーバイザーまたはクラウドサービスからも削除するかどうかを選択します。削除することを選択した場合は、Active Directory アカウントを保持、無効化、または削除するかどうかを指定します。

Azure Resource Manager カタログから永続マシンを削除すると、保持することを選択した場合でも、マシンと関連するリソースグループは Azure から削除されます。

カタログから非永続マシンを削除すると、それらはハイパーバイザーまたはクラウドサービスから自動的に削除されます。

カタログの編集

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

マシンプロファイルのない Azure マシンカタログにのみ NIC を追加できます。
注：
- AWS マシンカタログの場合、同じサブネットを複数の NIC にマッピングすることはできません。
- マシンプロファイルを持つマシンカタログの場合、カタログ上の NIC の数はマシンプロファイル上の NIC の数と等しくなければなりません。
- この機能は IBM Cloud ハイパーバイザーではサポートされていません。
- この機能は Nutanix ハイパーバイザーの Nutanix Prism Element でのみサポートされています。
[VDA アップグレード] ページで、アップグレードする VDA バージョンを変更または選択します。詳細については、「VDA アップグレード」を参照してください。
カタログの種類によっては、追加のページが表示される場合があります。

Azure Resource Manager イメージを使用して作成されたカタログの場合、次のページが表示されます。ここで行った変更は、後でカタログに追加するマシンにのみ適用されることに注意してください。既存のマシンは変更されません。
- [仮想マシン] ページで、マシンサイズとマシンを作成するアベイラビリティゾーンを変更します。
  注：
  - カタログがサポートするマシンサイズのみが表示されます。
  - 必要に応じて、[他のマシンカタログで使用されているマシンサイズのみを表示] を選択して、マシンサイズリストをフィルター処理します。
  - Azure カタログの場合、[ストレージとライセンスの種類] ページでストレージ冗長性が ZRS の場合、ゾーン選択をクリアして Azure に VM アベイラビリティゾーンを管理させることを推奨する警告が表示されます。
- [マシンプロファイル] ページで、マシンプロファイルを使用するか変更するかを選択します。
  
  注：
  
  Azure カタログの場合、アベイラビリティゾーンを含むマシンプロファイルを変更し、ストレージ冗長性に ZRS を選択すると、ゾーン選択をクリアすることを推奨する警告が表示されます。
- （カタログが専用グループホストで構成されている場合のみ）[専用ホストグループ] ページで、ホストグループを変更するかどうかを選択します。
- [ストレージとライセンスの種類] ページで、ストレージ冗長性の種類（Azure カタログの場合）、ストレージの種類、ライセンスの種類、および Azure Computer Gallery の設定（[準備されたイメージを Azure Gallery に配置] が使用されている場合にのみ利用可能）を変更するかどうかを選択します。
  
  注：
  
  新しく選択した設定が現在のマシンサイズをサポートしていない場合、設定を変更するとマシンサイズの設定がリセットされることを通知する警告ダイアログボックスが表示されます。続行することを選択した場合、[仮想マシン] メニューの横に赤い点が表示され、新しいマシンサイズを選択するように促されます。
ページで利用可能な設定の詳細については、「Azure Resource Manager イメージを使用してマシンカタログを作成する」を参照してください。

リモート PC アクセスカタログの場合、次のページが表示されます。

電源管理ページで、電源管理設定を変更し、電源管理接続を選択します。
組織単位ページで、Active Directory OU を追加または削除します。
1. 説明ページで、カタログの説明を変更します。
1. 変更を適用するには適用をクリックし、終了するには保存をクリックします。

カタログの名前変更

Studio から、左ペインで [マシンカタログ] を選択します。
カタログを選択し、アクションバーで [マシンカタログ名の変更] を選択します。

1. 新しい名前を入力します。

カタログの削除

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

すべてのユーザーがログオフしており、切断されたセッションが実行されていないこと。
カタログ内のすべてのマシンでメンテナンスモードがオンになっており、新しい接続ができないこと。
カタログ内のすべてのマシンがパワーオフされていること。
カタログがデリバリーグループに関連付けられていないこと。つまり、デリバリーグループにそのカタログのマシンが含まれていないこと。

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

-  1.  Studio から、左ペインで **[マシンカタログ]** を選択します。
-  1.  カタログを選択し、アクションバーで **[マシンカタログの削除]** を選択します。
-  1.  カタログに永続マシンが含まれている場合は、それらのマシンをハイパーバイザーまたはクラウドサービスからも削除するかどうかを指定します。削除することを選択した場合は、それらのActive Directoryコンピューターアカウントを保持、無効化、または削除するかどうかを選択します。

必要に応じて、[進行状況を非表示] を選択して、バックグラウンドで削除を実行します。

注：
-  Azure Resource Managerカタログを削除すると、関連付けられているマシンとリソースグループは、保持することを選択した場合でもAzureから削除されます。
非永続マシンを含むカタログを削除すると、それらのマシンはハイパーバイザーまたはクラウドサービスから削除されます。

カタログの削除中にハイパーバイザーまたはクラウドサービスに到達できない場合、カタログとVMの両方の削除が失敗します。必要に応じて、CitrixサイトデータベースからVMレコードのみを削除することを選択できます。これを行うには、[マシンカタログ] ノードでマシンカタログを選択し、[トラブルシューティング] タブに表示されている削除を実行します。この操作では、VMはホスト上にそのまま残ることに注意してください。

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

マシンカタログでActive Directoryアカウントを管理するには、次の操作を実行できます。

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

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

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

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

カタログのマスターイメージの変更

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

重要：

永続カタログのマスターイメージを変更する場合は、次の点に注意してください。カタログに後で追加するマシンのみが新しいイメージを使用して作成されます。既存のカタログ内のマシンには新しいイメージを展開しません。

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

MCSプロビジョニングされたカタログをマスターイメージから準備済みイメージに変換

MCSプロビジョニングされたカタログをマスターイメージから準備済みイメージに変換するには、次の手順に従います。

左ペインで [マシンカタログ] をクリックし、変換するマシンカタログを選択します。右クリックして [準備済みイメージに変換] を選択します。
[イメージ] ページで、準備済みイメージを選択します。
[ロールアウト戦略] ページで、選択した準備済みイメージでこのカタログを更新するタイミングを選択します。
[概要] ページで詳細を確認し、[完了] をクリックします。
[テンプレートのプロパティ] で、変換されたマシンカタログの詳細を確認します。
- 現在、この機能はAzureおよびVMware仮想化環境でのみ利用可能です。

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

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

ハイパーバイザーまたはクラウドサービスプロバイダーで、現在のVMのスナップショットを作成し、スナップショットにわかりやすい名前を付けます。このスナップショットは、マスターイメージをロールバックするために使用できます。
必要に応じて、イメージの電源をオンにし、ログオンします。
更新プログラムをインストールするか、イメージに必要な変更を加えます。
イメージがPersonal vDiskを使用している場合は、インベントリを更新します。
VMの電源をオフにします。
VMのスナップショットを作成し、マスターイメージを変更するときに認識されるわかりやすい名前をスナップショットに付けます。

注：

管理インターフェイスを使用してスナップショットを作成することもできますが、ハイパーバイザー管理コンソールを使用してスナップショットを作成し、Studioでそのスナップショットを選択することをお勧めします。これにより、自動生成された名前ではなく、わかりやすい名前と説明を提供できます。GPUイメージの場合、イメージはXenServer XenCenter®コンソールからのみ変更できます。

マスターイメージの変更

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

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

ヒント：

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

[ロールアウト戦略] ページで、マシンカタログ内のマシンを新しいイメージに変更するタイミング（次回のシャットダウン時または即時）を選択します。

注：
[ロールアウト戦略] ページは、ロールアウトが非永続VMにのみ適用されるため、永続VMでは利用できません。

[概要] ページで情報を確認し、[完了] を選択します。各マシンは更新後に自動的に再起動します。

アップデートの進行状況を追跡するには、マシンカタログでカタログを見つけ、インラインの進行状況バーと段階的な進行状況グラフを表示します。非永続カタログの場合、イメージの更新列で、完全に更新済み、部分的に更新済み、更新保留中、イメージ準備中などのイメージ更新ステータスを追跡できます。

ヒント:

イメージの更新列を表示するには、アクションバーの表示する列アイコンを選択し、マシンカタログ > イメージステータスを選択してから、保存をクリックします。

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

Azureベースのマシンカタログへの新しいマスターイメージの展開

1. Studioから、左側のペインでマシンカタログを選択します。

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

展開戦略

-  次回のシャットダウン時にイメージを変更すると、現在使用されていないマシン、つまりアクティブなユーザーセッションがないマシンにすぐに影響します。使用中のシステムは、現在のアクティブセッションが終了したときに更新を受け取ります。

-  > **注:** > > 展開戦略は、非永続VMにのみ適用されます。

次の点を考慮してください。

該当するマシンでの更新が完了するまで、新しいセッションを起動することはできません。
シングルセッションマシンの場合、マシンが使用されていないとき、またはユーザーがログオンしていないときに、マシンはすぐに更新されます。
子マシンを持つマルチセッションOSの場合、再起動は自動的に行われません。更新されたマスターイメージを適用するには、Studio、PowerShell、またはWorkspaceを使用してマシンを再起動します。マシンまたはハイパーバイザーからの再起動では、更新は適用されません。
ヒント:

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

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

更新されたイメージまたは新しいイメージを展開した後、それをロールバックできます。これは、新しく更新されたマシンで問題が発生した場合に必要になることがあります。ロールバックすると、カタログ内のマシンは最後に正常に動作したイメージにロールバックされます。新しいイメージを必要とする新機能は利用できなくなります。展開と同様に、マシンのロールバックには再起動が含まれます。
1. Studioから、左側のペインでマシンカタログを選択します。
1. カタログを選択し、アクションバーでマスターイメージのロールバックを選択します。
  - 1. 展開操作で説明されているように、以前のイメージをマシンに適用するタイミングを指定します。
- ロールバックは、元に戻す必要があるマシンにのみ適用されます。新しいイメージまたは更新されたイメージに変更されていないマシン（たとえば、ログオフしていないユーザーがいるマシン）の場合、ユーザーは通知メッセージを受け取らず、ログオフを強制されることもありません。
- ロールバックの進行状況を追跡するには、マシンカタログでカタログを見つけ、インラインの進行状況バーと段階的な進行状況グラフを表示します。
- 次のシナリオを含む特定の状況では、ロールバックできません。（マスターイメージのロールバックオプションは表示されません）。
- ロールバックする権限がない。
- カタログがMCSを使用して作成されていない。
- カタログがOSディスクのイメージを使用して作成された。
カタログの作成に使用されたスナップショットが破損している。
カタログ内のマシンに対するユーザーの変更が永続化されない。
- カタログ内のマシンが実行中である。

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

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

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

    -  アップグレードされたマシンを起動して、Citrix DaaSに登録します。これにより、管理インターフェイスは、カタログ内のマシンがアップグレードを必要としていることを判断できます。

カタログの機能レベルを変更するには：

Studioから、左側のペインでマシンカタログを選択します。 - 1. カタログを選択します。下部のペインにある詳細タブにバージョン情報が表示されます。
機能レベルの変更を選択します。管理インターフェイスがカタログの機能レベルを変更する必要があると検出した場合、メッセージが表示されます。プロンプトに従います。1つ以上のマシンを変更できない場合、その理由を説明するメッセージが表示されます。すべてのマシンが正常に機能するように、変更をクリックする前にこれらの問題を解決することをお勧めします。

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

カタログのクローン作成

カタログをクローンする前に、次の考慮事項に注意してください。

    -  [オペレーティングシステム](/ja-jp/citrix-daas/install-configure/machine-catalogs-create.html#operating-system)および[マシン管理](/ja-jp/citrix-daas/install-configure/machine-catalogs-create.html#machine-management)に関連する設定は変更できません。クローンされたカタログは、元のカタログからこれらの設定を継承します。

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

-  カタログのクローン作成には時間がかかる場合があります。必要に応じて、**進行状況を非表示**を選択して、バックグラウンドでクローン作成を実行します。
-  クローンされたカタログは元のカタログの名前を継承し、サフィックス`Copy`が付きます。名前は変更できます。[カタログの名前変更](/ja-jp/citrix-daas/install-configure/machine-catalogs-manage.html#rename-a-catalog)を参照してください。

クローン作成が完了したら、クローンされたカタログをデリバリーグループに割り当てるようにしてください。
クローン作成によって空のカタログを作成できます。カタログのクローン作成中に、MCSプロビジョニングされたカタログのマシン数をゼロに設定したり、非MCSプロビジョニングされたカタログにマシンを追加しないようにしたりできます。

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

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

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

ヒント:

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

必要な役割

デフォルトでは、カタログフォルダーを作成および管理するには、次の組み込みの役割（クラウド管理者、フル管理者、またはマシンカタログ管理者）が必要です。必要に応じて、カタログフォルダーの作成と管理のための役割をカスタマイズできます。詳細については、「必要な権限」を参照してください。

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

-  開始する前に、まずカタログの整理方法を計画してください。次の点を考慮してください。

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

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

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

Studioから、左ペインでマシンカタログを選択します。
フォルダー階層でフォルダーを選択し、アクションバーでフォルダーの作成を選択します。
新しいフォルダーの名前を入力し、完了をクリックします。

ヒント:

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

カタログの移動

カタログをフォルダー間で移動できます。詳細な手順は次のとおりです。

Studioから、左ペインでマシンカタログを選択します。
フォルダー別にカタログを表示します。フォルダー階層の上にあるすべて表示をオンにして、一度にすべてのカタログを表示することもできます。
カタログを右クリックし、マシンカタログの移動を選択します。
カタログを移動するフォルダーを選択し、完了をクリックします。
- ヒント:
  
  カタログをフォルダーにドラッグできます。

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

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

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

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

Studioから、左ペインでマシンカタログを選択します。
フォルダー階層でフォルダーを選択し、必要に応じてアクションバーでアクションを選択します。
- フォルダーの名前を変更するには、フォルダーの名前変更を選択します。
- フォルダーを削除するには、フォルダーの削除を選択します。
- フォルダーを移動するには、フォルダーの移動を選択します。
画面の指示に従って、残りの手順を完了します。

必要な権限

次の表に、カタログフォルダーに対するアクションを実行するために必要な権限を示します。

アクション	必要な権限
カタログフォルダーの作成	マシンカタログフォルダーの作成
カタログフォルダーの削除	マシンカタログフォルダーの削除
カタログフォルダーの移動	マシンカタログフォルダーの移動
カタログフォルダーの名前変更	マシンカタログフォルダーの編集
カタログのフォルダーへの移動	マシンカタログフォルダーの編集およびマシンカタログプロパティの編集

VDAのアップグレード

Studioインターフェイスを使用して、VDAを簡単にアップグレードできます。詳細および段階的なガイダンスについては、Citrix VDAアップグレードサービスドキュメントを参照してください。

カタログのエクスペリエンス最適化設定の管理

開始する前に、Workspace Environment Management (WEM) サービス展開がセットアップされていることを確認してください。詳細については、「Workspace Environment Managementサービスの概要」を参照してください。

必要な権限

デフォルトでは、マシンカタログの構成セットを作成および管理するには、WEMフル管理者の役割と、次のいずれかの役割が必要です。

フルアクセス管理者
クラウド管理者
マシンカタログ管理者
他の役割に構成セットの管理を許可するには、構成セットの管理権限とWEMフル管理者の役割の両方を割り当てます。

エクスペリエンス最適化設定の編集

カタログに適用するエクスペリエンス最適化オプションを選択します。

デフォルト設定の適用: このオプションを選択すると、自動CPUスパイク保護やインテリジェントCPU最適化など、デフォルトの最適化設定が適用されます。
カスタム設定の適用: 名前を入力して構成セットを作成し、要件に応じて最適化設定をカスタマイズします。または、既存の構成セットを選択することもできます。

カタログ作成の再試行

注:

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

失敗したカタログにはエラーアイコンが表示されます。詳細を確認するには、各カタログの [トラブルシューティング] タブに移動します。カタログ作成を再試行する前に、以下の考慮事項に注意してください。

まずトラブルシューティング情報を確認し、問題を解決します。この情報には、検出された問題とその解決策に関する推奨事項が記載されています。
オペレーティングシステムおよびマシン管理に関連する設定は変更できません。カタログは、元の設定を継承します。
作成には時間がかかる場合があります。必要に応じて、[進行状況を非表示] を選択して、バックグラウンドで作成を実行します。

カタログの作成を再試行するには、次の手順を実行します。

Studioで、左側のペインの [マシンカタログ] を選択します。
カタログを選択し、その [トラブルシューティング] タブに移動します。
再試行ハイパーリンクをクリックして、カタログの作成を再試行します。
表示されるウィザードで、必要に応じて設定を変更します。変更する必要がない場合は、直接 [概要] ページに移動できます。

1. 完了したら、[完了] を選択して作成を開始します。

(Citrix以外でプロビジョニングされたVDAのみ) 登録トークンの生成と管理

注:
- このタスクを実行するには、Cloud Administratorの役割が必要です。
- Citrix以外でプロビジョニングされたマシンにトークンベースの登録を採用することを決定したら、マシンカタログごとにトークンを生成し、VDAインストール管理者と共有します。

登録トークンの機能:

-  登録範囲: 1～5000台のVDAマシン

有効期間: 最大14日間

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

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

トークンリストにトークンレコードが表示されます。
VDAインストール管理者とトークンを共有します。

マシンへのVDAとトークンのインストール方法について詳しくは、「VDAのインストール」を参照してください。

トークンの管理

トークンを取り消してVDA登録に使用できないようにするには、2つのオプションがあります。

取り消し: トークンを取り消しますが、ログ記録のためにリストに残します。
削除: トークンを取り消し、リストから削除します。

注:

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

PowerShellの使用

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

マシン名のシーケンス番号の管理

PowerShellコマンドを使用して、MCSで展開されたマシンのシーケンス番号をカスタマイズするには、次の手順を実行します。

1. Delivery ControllerでPowerShellを管理者として開きます。
1. asnp citrix* コマンドを実行してCitrixモジュールをロードします。
1. 次のコマンドを実行して、カタログのIDプールの開始カウントを確認します。
Get-AcctIdentityPool -IdentityPoolName xxx
IdentityPoolName はカタログの名前です。
1. このカウントを別の値に設定する場合は、次のコマンドを実行し、StartCountをXとして指定します。
Set-AcctIdentityPool -IdentityPoolName xxx -StartCount X
1. マシンをカタログに追加して、必要なカウントでマシンが作成されるようにします。
1. マシンを作成した後、次のコマンドを実行して元の値Yに戻します。
Set-AcctIdentityPool -IdentityPoolName xxx -StartCount Y

イメージへの説明の追加

マシンカタログのイメージ更新に関連する変更について、情報を提供する説明を追加できます。この機能を使用して、カタログの作成時、またはカタログの既存のマスターイメージを更新する際に説明を追加します。また、カタログ内の各マスターイメージの情報を表示することもできます。この機能は、たとえば Office 365 installed のように、カタログで使用されるマスターイメージを更新する際に説明的なラベルを追加したい管理者に役立ちます。イメージの説明を追加または表示するには、次のコマンドを使用します。
NewProvScheme。新しいパラメーター masterImageNote を使用すると、イメージにノートを追加できます。例：

-  C:\PS>New-ProvScheme -ProvisioningSchemeName XenPS -HostingUnitName XenHu -IdentityPoolName idPool1 -MasterImageVM XDHyp:\HostingUnits\XenHU\Base.vm\Base.snapshot -MasterImageNote "Office365 installed"
-  <!--NeedCopy-->

Publish-ProvMasterVMImage。このパラメーターを使用してノートを公開します。例：

C:\PS>Publish-ProvMasterVMImage -ProvisioningSchemeName MyScheme -MasterImageVM XDHyp:\HostingUnits\HostUnit1\RhoneCC_baseXP.vm\base.snapshot -MasterImageNote "Visual Studio 2019 installed"

Get-ProvSchemeMasterVMImageHistory。各イメージの情報を表示します。例：

`C:\PS>Get-ProvSchemeMasterVMImageHistory -ProvisioningSchemeName MyScheme -Showall

VMImageHistoryUid : 3cba3a75-89cd-4868-989b-27feb378fec5

ProvisioningSchemeUid : 7585f0de-192e-4847-a6d8-22713c3a2f42

ProvisioningSchemeName : MyScheme

MasterImageVM : /Base.vm/base.snapshot
Date : 17/05/2021 09:27:50

MasterImageNote : Office365 installed`

OSディスクのリセット

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

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

-  ターゲットVMが永続的なMCSカタログにあること。
-  MCSマシンカタログが正常に機能していること。これは、プロビジョニングスキームとホストが存在し、プロビジョニングスキームに正しいエントリがあることを意味します。 -  ハイパーバイザーがメンテナンスモードではないこと。 -  ターゲットVMがパワーオフされ、メンテナンスモードであること。

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

PowerShell ウィンドウを開きます。
asnp citrix* を実行して、Citrix固有のPowerShellモジュールをロードします。
次のいずれかの方法でPowerShellコマンド Reset-ProvVMDisk を実行します。
- VMのリストをコンマ区切りのリストとして指定し、各VMでリセットを実行します。
```
 Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName ("abc","def") -OS
 
```
- VMのリストを Get-ProvVM コマンドからの出力として指定し、各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 キーを押すと、それ以上の操作は行われません。

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
 
```
注:

リセット処理が完了するまで、VM をメンテナンスモードから解除したり、電源をオンにしたりしないでください。
Reset-ProvVMDisk コマンドによって返されたタスクのステータスを取得するには、Get-ProvTask を実行します。

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

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

注:

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

条件

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 または Microsoft Entra ID) に対する書き込み権限を持つユーザーアカウント。
  - 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 -VMname -Identity -Recreate
```

アクションを確認するには、y と入力します。-Force パラメーターを使用して確認プロンプトをスキップすることもできます。例：
```
Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMName <name> -Identity -Force

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

既存のマシンカタログのネットワーク設定の変更

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

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

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

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

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

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

WriteBackCacheMemorySize
WriteBackCacheDiskSize
この機能は現在、以下に適用されます。
GCPおよびMicrosoft Azure環境
MCSIOが有効な非永続カタログ

要件

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

VDAの最新バージョン（2308以降）に更新します

既存のマシンカタログに対して UseWriteBackCache パラメーターを有効にします。New-ProvScheme を使用して、UseWriteBackCache が有効なマシンカタログを作成します。例：

 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-->

注記:

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

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

これらの変更は、変更後にカタログに追加された新しい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 が派生しないようにします。

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

MCSマシンカタログの問題を理解し、それらの問題を修正するために、過去のエラーと警告を取得できます。

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

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

PowerShellコマンドを実行するには：

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

エラーと警告のリストを取得するには：

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

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

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

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

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

エラーまたは警告を削除するには：

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

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

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

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

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

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

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

制限事項

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

PurgeDBOnlyコマンドの使用

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

ホスト接続がメンテナンスモードである
無効な資格情報
認証の失敗
許可されていない操作
ハイパーバイザーに到達できない

注記:

Remove-provVM -ForgetVM は永続的な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

個々のVMのプロパティの更新

PowerShellコマンド Set-ProvVM を使用して、永続的なMCSマシンカタログ内の個々のVMのプロパティを更新できます。ただし、更新はすぐに適用されません。更新を適用するには、PowerShellコマンド Set-ProvVMUpdateTimeWindow を使用して時間枠を設定する必要があります。

この実装により、マシンカタログ全体を更新することなく、個々のVMを効率的に管理できます。現在、この機能はAzureおよびVMware環境に適用できます。

現在、更新できるプロパティは次のとおりです。

CustomProperties
ServiceOffering (VMwareには適用されません)
MachineProfile
CpuCount
Memory

この機能を使用すると、次のことができます。

VMのプロパティの更新
マシンカタログの更新後にVMで更新されたプロパティの保持
VMに適用された構成更新の元に戻す

VMのプロパティを更新する前に：

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

既存のマシンカタログの構成を確認します。例：

Get-ProvScheme -ProvisioningSchemeName <catalog name>
<!--NeedCopy-->

更新を適用するVMの構成を確認します。例：

Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1
<!--NeedCopy-->

VMのプロパティの更新

VMのプロパティを更新するには、次の手順を実行します。

更新を適用するVMの電源をオフにします。

VMのプロパティを更新します。たとえば、VMのストレージタイプ (StorageType) カスタムプロパティを更新する場合は、次を実行します。

Set-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."
<!--NeedCopy-->

マシンカタログ内の2つのVMのプロパティを同時に更新できます。例：

Set-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."
<!--NeedCopy-->

Set-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine2 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."
<!--NeedCopy-->

注記:

更新はすぐに適用されません。

更新が指定されているプロパティのリストと構成バージョンを取得します。例：
```
Get-ProvVMConfiguration -ProvisioningSchemeName <catalog name> -VMName machine1

```
Version のプロパティ値と、更新するプロパティ（この場合は StorageType）を確認します。
構成バージョンを確認します。例：
```
Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1

```
ProvVMConfigurationVersion のプロパティ値を確認します。更新はまだ適用されていません。VMはまだ古い構成のままです。
スケジュールされた更新を要求します。例：
```
 Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <catalog name> -StartsNow -DurationInMinutes -1
 
```
スケジュールされた更新の詳細については、「プロビジョニングされたマシンを現在のプロビジョニングスキームの状態に更新」を参照してください。

注記:

保留中のプロビジョニングスキームの更新も適用されます。

VMを再起動します。例：

New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
<!--NeedCopy-->

構成バージョンを確認します。例:
```
Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1

```
ProvVMConfigurationVersion のプロパティ値を確認します。更新が適用されました。VM には新しい構成が適用されています。
VM にさらに構成の更新を適用するには、VM をシャットダウンし、手順を繰り返します。

マシンカタログの更新後に VM で更新されたプロパティを保持する

VM で更新されたプロパティを保持するには、次の手順を実行します。

更新を適用する VM をシャットダウンします。

マシンカタログを更新します。たとえば、VM サイズ (ServiceOffering) とストレージタイプ (StorageType) を変更する場合は、次を実行します。

Set-ProvScheme -ProvisioningSchemeName <catalog name> -ServiceOffering Standard_E4_v3 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."
<!--NeedCopy-->

マシンカタログの構成詳細を取得します。例:
```
Get-ProvScheme -ProvisioningSchemeName <catalog name>

```
ProvisioningSchemeVersion は 1 ずつインクリメントされます。VM サイズとストレージタイプも更新されます。

VM のプロパティを更新します。たとえば、VM にマシンプロファイルを提供します。

Set-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1 -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\machineprofile.folder\<resource-group>.resourcegroup\<template-spec>.templatespec\<template-spec-version>.templatespecversion"
<!--NeedCopy-->

注:

マシンプロファイルの入力には、タグと異なる VM サイズ (ServiceOffering) が指定されています。

VM 上の構成更新とマシンカタログ更新をマージした後に VM が持つプロパティのリストを取得します。例:
```
Get-ProvVMConfigurationResultantSet -ProvisioningSchemeName <catalog name> -VMName machine1

```
注:

VM 上の更新は、マシンカタログで行われた更新を上書きします。

VM のスケジュールされた更新を要求します。例:

Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <catalog name> -VMName machine1 -StartsNow -DurationInMinutes -1
<!--NeedCopy-->

VM を再起動します。例:
```
New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn

```
VM は、マシンプロファイルから派生した更新された VM サイズを保持します。マシンプロファイルで指定されたタグ値も VM に適用されます。ただし、ストレージタイプは最新のプロビジョニングスキームから派生します。
VM の構成バージョンを取得します。例:
```
Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1

```
ProvisioningSchemeVersion と ProvVMConfigurationVersion には最新バージョンが表示されます。

VM に適用された構成更新を元に戻す

VM に更新を適用した後、VM をシャットダウンします。

VM に適用された更新を削除するには、次のコマンドを実行します。例:

Set-ProvVM -RevertToProvSchemeConfiguration -ProvisioningSchemeName <catalog name> -VMName machine1
<!--NeedCopy-->

VM のスケジュールされた更新を要求します。例:

Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <catalog name> -VMName machine1 -StartsNow -DurationInMinutes -1
<!--NeedCopy-->

VM を再起動します。例:

New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
<!--NeedCopy-->

VM の構成バージョンを確認します。例:

Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1
<!--NeedCopy-->

ProvVMConfigurationVersion の値は、マシンカタログの構成バージョンになりました。

VMのストレージ移行

既存のVMのディスクストレージを、VMwareおよびXenServer環境で古いストレージから新しいストレージに移動できます。移行中、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 *
 
```
OSディスク、IDディスク、およびWBCディスク (非永続VMに適用) を、Move-ProvVMDisk PowerShellコマンドを使用して宛先ストレージに移行します。
注:
- DiskType および DestinationStorageId パラメーターには、常にOSディスクとIDディスクを指定してください。
- OSディスクとIDディスクの DestinationStorageId は同じである必要があります。
例:

永続VM:
```
(Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName "myFullCloneProvScheme" -VMName "machine01" -DiskType OS,Identity -DestinationStorageId datastore1,datastore1

```
重要:

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

非永続VM:
```
(Get-ProvVM -ProvisioningSchemeName xxxxx) | Move-ProvVMDisk -ProvisioningSchemeName "myCleanOnBootProvScheme" -VMName "machine01" -DiskType OS,Identity,WBC -DestinationStorageId None,None,datastore1

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

トラブルシューティング

いずれかのディスクの移行に失敗した場合、いずれのディスクも宛先ストレージに移行されません。次のコマンドを使用して失敗レポートを取得できます。

(Get-ProvTask -TaskID xxxxxxxxx).DiskMoveFailedVirtualMachines

<!--NeedCopy-->

VMwareにおける非永続VMの移行に関する重要な考慮事項

OSディスクとIDディスクを新しいストレージに移動しようとすると、VM固有のファイルも新しいストレージに移動されます。
VMwareは、スナップショットがあるディスクの移動をサポートしていません。

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

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

制限事項

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

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

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

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

StudioまたはPowerShellコマンドを使用して、イメージ定義とイメージバージョンを作成します。イメージ定義とイメージバージョンを作成する手順については、以下を参照してください。
- Azure：
  - Studio
  - PowerShell
- VMware：
  - 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
<!--NeedCopy-->

既存の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 Connectorが正常に動作していない場合、MCSプロビジョニング操作（カタログの更新など）に通常よりも時間がかかり、管理コンソールのパフォーマンスが著しく低下します。

次のステップ

特定のハイパーバイザーカタログの管理については、以下を参照してください。

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

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

マシンカタログの管理

April 6, 2026

寄稿者:

C C

April 6, 2026

寄稿者:

C C

この記事の概要

はじめに
永続インスタンスについて
マシンカタログの管理
Studio の使用
カタログの詳細の表示
カタログへのマシンの追加
カタログからのマシンの削除
カタログの編集
カタログの名前変更
カタログの削除
カタログ内のActive Directoryコンピューターアカウントの管理
カタログのマスターイメージの変更
MCSプロビジョニングされたカタログをマスターイメージから準備済みイメージに変換
機能レベルの変更または変更の取り消し
カタログのクローン作成
フォルダーを使用したカタログの整理
VDAのアップグレード
カタログのエクスペリエンス最適化設定の管理
カタログ作成の再試行
(Citrix以外でプロビジョニングされたVDAのみ) 登録トークンの生成と管理
PowerShellの使用
マシン名のシーケンス番号の管理
イメージへの説明の追加
OSディスクのリセット
アクティブなコンピューターアカウントのID情報の修復
既存のマシンカタログのネットワーク設定の変更
マシンカタログのバージョンの管理
既存のマシンカタログのキャッシュ構成の変更
マシンプロファイルに基づかないマシンカタログのマシンプロファイルに基づくマシンカタログへの変換
カタログに関連する警告とエラーの取得
ハイパーバイザーアクセスなしでのマシンの削除
個々のVMのプロパティの更新
VMのストレージ移行
既存のMCSプロビジョニング済みカタログから準備済みイメージマシンカタログへの移行
トラブルシューティング
次のステップ

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

マシンカタログの管理

はじめに

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

マシンカタログの管理

Studio の使用

カタログの詳細の表示

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

CSV ファイルを使用してマシンをカタログに一括追加する

CSV ファイルを使用してマシンを追加する際の考慮事項

WebSocket VDA 登録ツールを使用してマシンをカタログに登録する

トラブルシューティング

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

カタログの編集

カタログの名前変更

カタログの削除

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

カタログのマスターイメージの変更

MCSプロビジョニングされたカタログをマスターイメージから準備済みイメージに変換

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

マスターイメージの変更

展開戦略

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

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

カタログのクローン作成

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

必要な役割

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

カタログの移動

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

必要な権限

VDAのアップグレード

カタログのエクスペリエンス最適化設定の管理

必要な権限

エクスペリエンス最適化設定の編集

カタログ作成の再試行

(Citrix以外でプロビジョニングされたVDAのみ) 登録トークンの生成と管理

トークンの管理

PowerShellの使用

マシン名のシーケンス番号の管理

イメージへの説明の追加

OSディスクのリセット

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

条件

ID情報のリセット

既存のマシンカタログのネットワーク設定の変更

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

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

要件

キャッシュ構成の変更

マシンプロファイルに基づかないマシンカタログのマシンプロファイルに基づくマシンカタログへの変換

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

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

制限事項

PurgeDBOnlyコマンドの使用

個々のVMのプロパティの更新

VMのプロパティの更新

マシンカタログの更新後に VM で更新されたプロパティを保持する

VM に適用された構成更新を元に戻す

VMのストレージ移行

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

トラブルシューティング

VMwareにおける非永続VMの移行に関する重要な考慮事項

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

制限事項

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

トラブルシューティング

次のステップ

この記事の概要