マシンカタログを管理する

最終公開日 : Oct 24, 2026
注：
この記事では、StudioとPowerShellコマンドを使用してカタログを管理する方法について説明します。Quick Deployノードを使用してカタログを作成し、引き続きそのノードを使用してカタログを管理する場合は、「Quick Deployでのカタログの管理」に従ってください。
Related information
展開の計画と構築
AWS EC2カタログの管理Amazon WorkSpaces Core マネージドインスタンスのカタログを管理するGoogle Cloud Platformカタログを管理するHPE Moonshot カタログの管理Microsoft Azureカタログを管理するMicrosoft SCVMMカタログの管理Nutanixカタログの管理VMwareカタログを管理するXenServer®カタログの管理

はじめに

マシンカタログへのマシンの追加または削除、名前の変更、説明の変更、またはカタログの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を使用する

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

カタログの詳細を表示

  1. 検索機能を使用して特定のマシンカタログを見つけます。手順については、インスタンスの検索を参照してください。
  2. 検索結果から、必要に応じてカタログを選択します。
  3. カタログ列の説明については、次の表を参照してください。
    列 説明
    マシンカタログ カタログの名前と割り当てタイプ。割り当てタイプには以下が含まれます。
    • ランダム: カタログ内のマシンはユーザーにランダムに割り当てられます。
    • 永続: カタログ内のマシンはユーザーに永続的に割り当てられます。
    マシンタイプ カタログ内のマシンでサポートされているセッションタイプ。可能な値には以下が含まれます。
    • OSタイプ: マルチセッションOS (仮想); ユーザーデータ: 破棄。
    • OSタイプ: マルチセッションOS (仮想); ユーザーデータ: ローカルディスク上
    • OSタイプ: シングルセッションOS (リモートPCアクセス)
    • OSタイプ: シングルセッションOS (仮想); ユーザーデータ: 破棄
    • OSタイプ: シングルセッションOS (仮想); ユーザーデータ: ローカルディスク上
    マシン数 カタログ内のマシン数とプロビジョニング方法。可能なプロビジョニング方法には、Machine Creation Services (MCSマシン)、手動、およびCitrix Provisioning™ Servicesが含まれます。
    割り当て済み数 デリバリーグループに割り当てられているカタログ内のマシンの数。
    フォルダー マシンカタログツリー内のカタログの場所。カタログが存在するフォルダーの名前（末尾のバックスラッシュを含む）が表示されます。カタログがルートレベルにある場合は-が表示されます。
    VDAアップグレード VDAアップグレードの状態。可能な値は、未構成、スケジュール済み、利用可能、および最新です。
    イメージステータス カタログのイメージ更新のステータス。非永続マシンカタログにのみ適用されます。可能な値は、完全に更新済み、部分的に更新済み、更新保留中、準備中です。
  4. 下部の詳細ペインでタブをクリックすると、選択したカタログに関する詳細情報が表示されます。
    タブ 説明
    詳細 マシンタイプ、プロビジョニング方法、サービスアカウント、OS、VDAバージョンなど、主要なマシンカタログ設定を要約し、リソースを迅速に表示および管理できるようにします。
    テンプレートプロパティ MCSでプロビジョニングされたカタログでのみ利用可能です。
    選択したカタログの詳細なプロビジョニング情報を表示します。これには以下が含まれます。
    • マシンテンプレートプロパティ
    • ハイパーバイザー固有の詳細
    • マシンプロファイルプロパティ
    マシン 選択したカタログ内のマシン名のページ分割されたリストを表示します。
    デリバリーグループ リモートPCカタログで利用可能です。
    選択したカタログに関連付けられているデリバリーグループを表示します。デリバリーグループ名とカタログの関連付けが表示されます。
    タグ マルチテナント環境では利用できません。
    選択したマシンカタログに割り当てられているタグのタグ名と説明を表示します。
    ワークスペース環境管理 WEMサービスがプロビジョニングされ、アクセス可能な場合にのみ表示されます。
    Workspace Environment Management のシステム最適化設定を表示します。
    コストインサイト Azure MCSカタログにのみ適用され、以下が表示されます。
    過去30日間に発生した総コスト。
    現在の30日間の総コストと、以前の30日間の期間との比較。
    タブを表示するにはCitrix コスト管理 > 管理 > コストの読み取り 権限 (クラウド管理者向けデフォルト) が必要であり、コストの詳細を表示するには Microsoft.CostManagement/query/read Azure権限が必要です。
    トラブルシューティング 推奨されるアクションとともに、カタログのエラーまたは警告を表示します。

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

開始する前に:
  • 仮想化ホスト (ハイパーバイザーまたはクラウドサービスプロバイダー) に、追加のマシンを収容するのに十分なプロセッサー、メモリ、ストレージがあることを確認してください。
  • 未使用のActive Directoryコンピューターアカウントが十分にあることを確認してください。既存のアカウントを使用している場合、追加できるマシンの数は利用可能なアカウントの数によって制限されます。
  • Studioを使用して追加のマシン用のActive Directoryコンピューターアカウントを作成する場合、適切なドメイン管理者権限が必要です。
ヒント:
マシンカタログにマシンを追加するために使用されるCitrix DaaSアカウントにAD権限の制限がある場合は、ログオン先.. 画面で使用するすべてのCloud Connectorを追加します。
カタログにマシンを追加するには:
  1. Studioから、左ペインでマシンカタログを選択します。
  2. マシンカタログを選択し、アクションバーでマシンの追加を選択します。
  3. 仮想マシンページで、追加する仮想マシンの数を選択します。
  4. マシンIDページで、設定を次のように構成します。
    • リストからIDを選択します。
    • 該当する場合は、アカウントを作成するか既存のアカウントを使用するか、およびそれらのアカウントの場所（ドメイン）を指定します。
      追加するVMの数に対して既存のActive Directoryアカウントが不足している場合は、アカウントが作成されるドメインと場所を選択します。
      既存のActive Directoryアカウントを使用する場合は、アカウントを参照するか、インポートを選択してアカウント名を含む.csvファイルを指定します。追加するすべてのマシンに対して十分なアカウントがあることを確認してください。Studioはこれらのアカウントを管理します。そのインターフェイスですべてのアカウントのパスワードをリセットできるようにするか、すべてのアカウントで同じである必要があるアカウントパスワードを指定します。
    • このIDプールが他のカタログで使用されている場合、Studioを使用して別のプールに変更することはできません。代わりに、Set-ProvScheme PowerShellコマンドレットを使用してください。詳しくは、Citrix Virtual Apps and Desktops SDK Documentationを参照してください。
    • 連続する数字または文字が表示される場所を示すハッシュマークを使用して、アカウントの命名スキームを指定します。たとえば、PC-Sales-##（0-9を選択）という命名スキームは、PC-Sales-01、PC-Sales-02、PC-Sales-03などのコンピューターアカウントになります。
    • オプションで、アカウント名の開始文字を指定できます。
      アカウント名の開始文字を指定する際は、次のシナリオに注意してください。開始番号または文字がすでに使用されている場合、最初に作成されるアカウントは、その後に続く最も近い未使用の番号または文字を使用して命名されます。
      マシンの名前のシーケンス番号を管理するを参照して、MCSを使用して展開されるマシンのシーケンス番号をPowerShellコマンドでカスタマイズします。
  5. ドメイン資格情報ページで、資格情報の入力を選択し、マシンアカウントを作成するのに十分な権限を持つユーザー資格情報を入力します。
マシンはバックグラウンドプロセスとして作成され、多数のマシンを作成する場合は時間がかかることがあります。Studioを閉じてもマシンの作成は続行されます。

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

CSVファイルを使用してマシンを一括追加できます。この機能は、MCSを介してプロビジョニングされたカタログを除くすべてのカタログで利用できます。
マシンをカタログに一括追加するには、次の手順を実行します。
  1. Studioから、左ペインで を選択します。
  2. マシンカタログを選択し、アクションバーで を選択します。 ウィンドウが表示されます。
  3. を選択します。 ウィンドウが表示されます。
  4. を選択します。
  5. テンプレートファイルに記入します。
  6. ファイルをドラッグするか、参照してアップロードします。
  7. インポートの検証チェックを実行するには、 を選択します。
  8. プロセスを完了するには、 を選択します。

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
    • ドメイン\ComputerName3, AzureAD:ユーザー名
    • マシンアカウントのみの場合：
    • 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です: Hosting > 接続とリソースの追加で入力した接続の名前です。詳細については、「接続とリソースの作成」を参照してください。
    • East US.regionはRegionNameです: .regionを拡張子とするリージョンの名前です。
    • wsvdaV3-2.vmはVMNameです: .vmを拡張子とする仮想マシンの名前です。
  • 1つのファイルに含めることができるマシンの最大数は1,000台です。1,000台を超えるマシンをインポートするには、それらを複数のファイルに分散させ、それらのファイルを1つずつインポートします。1,000台を超えるマシンをインポートしないことをお勧めします。そうしないと、カタログの作成に時間がかかる場合があります。
同じマシンの追加ページで、カタログからマシンをエクスポートすることもできます。エクスポートされたマシンのCSVは、マシンを一括で追加する際のテンプレートとして使用できます。マシンをエクスポートするには:
  1. Studioで、左側のペインでマシンカタログを選択します。
  2. マシンカタログを選択し、アクションバーでマシンの追加を選択します。マシンの追加ウィンドウが表示されます。
  3. CSVファイルにエクスポートを選択します。マシンの一覧を含むCSVファイルがダウンロードされます。
  4. 必要に応じて、CSVファイルを開いてマシンを追加または編集します。保存したCSVファイルを使用してマシンを一括で追加するには、前のセクション「CSVファイルを使用してマシンをカタログに一括追加する」を参照してください。
注:
  • この機能は、リモートPCアクセスおよびMCSプロビジョニングされたカタログでは使用できません。
  • CSVファイルでのマシンのエクスポートとインポートは、同じ種類のカタログ間でのみサポートされています。

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

WebSocket VDA登録ツールは、VDAマシン向けのトークンベースの登録を容易にします。このツールは、登録トークンを使用してVDAをマシンカタログに追加することで、接続をWebSocket接続に変換するのに役立ちます。
注：
このツールは、どのマシンカタログにも登録されていないVDAマシンを登録するために設計されています。
登録ツールを実行するには、以下の手順に従ってください。
  1. VDAにログオンします。
  2. C:\Program Files\Citrix\Virtual Desktop Agent\Web Socket Vda Enrollment ToolにあるツールEnrollMachine.exeを見つけます。
  3. 適切な入力パラメータを指定してツールを実行します。例： 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 成功 VDAがマシンカタログに正常に追加されました。
-1 InvalidArgument 登録トークン内の入力パラメーターが無効です。
-2 BrokerAgentNotFound ブローカーエージェントサービスが見つかりません。
-3 TokenInvalid 入力されたトークンが無効です。
-4 TokenMissingRequiredClaims トークンに必要なクレーム（CustomerIdや登録URIなど）がありません。
-5 InternalError 一般的なエラーが発生しました。
-6 タイムアウト タスクがタイムアウトしました。
-7 マシンのAD参加ステータスの判別失敗 マシンのAD参加ステータスを返すサービスが失敗しました。
-8 ADマシンSIDの検索失敗 ADマシンSIDを返すサービスが失敗しました。
-9 登録要求の失敗 HTTPエラーにより要求が失敗しました。
-10 登録応答に必須フィールドがありません 登録ツールの応答にパラメーター VirtualSiteId がありません。
-11 権限不足 タスクを実行するために必要な権限がありません。
-12 マシンのAAD参加ステータスを判断できませんでした マシンのAD参加ステータスを確認するサービスがエラーをスローしました。
-13 AADマシンがデバイスIDを見つけられませんでした システムによって追加された追加パラメーター AAD device id が空です。
-14 AADデバイスIDが無効です システムによって追加された追加パラメーター AAD device id は有効なGUIDではありません。
-15 有効なMACアドレスがありません 無効なMACアドレスです。
-16 FailedToGetComputerHostNameForVdaInstanceName 追加パラメーター VdaInstanceName を設定するためのコンピューターホスト名の取得に失敗しました。
-17 VirtualDesktopAgentRegistryKeyFailedToOpen デリバリーコントローラーのリストを書き込むためのVDAレジストリキーを開くのに失敗しました。
-18 失敗したトークンが最大数に達しました 失敗したトークンが最大数に達しました。

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

マシンカタログからマシンを削除すると、ユーザーはそのマシンにアクセスできなくなるため、マシンを削除する前に、以下を確認してください。
  • ユーザーデータがバックアップされているか、不要になっていること。
  • すべてのユーザーがログオフしていること。メンテナンスモードをオンにすると、マシンへの新しい接続が停止します。
  • マシンが電源オフになっていること。
カタログからマシンを削除するには：
  1. Studioで、左ペインのマシンカタログを選択します。
  2. カタログを選択し、アクションバーでマシンを表示を選択します。
  3. 1つ以上のマシンを選択し、アクションバーで削除を選択します。
  4. カタログから永続マシンを削除する場合、ハイパーバイザーまたはクラウドサービスからも削除するかどうかを選択します。削除することを選択した場合、それらのActive Directoryアカウントを保持するか、無効にするか、削除するかを指定します。
Azure Resource Managerカタログから永続マシンを削除すると、保持することを選択した場合でも、マシンと関連するリソースグループはAzureから削除されます。
カタログから非永続マシンを削除すると、それらはハイパーバイザーまたはクラウドサービスから自動的に削除されます。

カタログを編集する

  1. Studioから、左側のペインでマシンカタログを選択します。
  2. カタログを選択し、アクションバーでマシンカタログの編集を選択します。
  3. スコープページで、スコープを変更します。
  4. NICページで、次のアクションを実行します。
    • NICのサブネットマッピングを変更するには、関連ネットワークフィールドからネットワークを選択します。
    • サブネットマッピングを追加するには、NICの追加を選択し、関連ネットワークフィールドからネットワークを選択して、保存をクリックします。
    カタログに関連付けられているホストに存在するサブネットのみが、関連ネットワークフィールドに表示されます。
    マシンプロファイルのないAzureマシンカタログにのみNICを追加できます。
    注：
    • AWSマシンカタログの場合、同じサブネットを複数のNICにマッピングすることはできません。
    • マシンプロファイルを持つマシンカタログの場合、カタログ上のNICの数は、マシンプロファイル上のNICの数と等しくなければなりません。
    • この機能は、IBM Cloudハイパーバイザーではサポートされていません。
    • この機能は、NutanixハイパーバイザーのNutanix Prism Elementでのみサポートされています。
  5. VDA Upgradeページで、アップグレードするVDAバージョンを変更または選択します。詳細については、VDA upgradeを参照してください。
  6. カタログの種類によっては、追加のページが表示される場合があります。
    Azure Resource Managerイメージを使用して作成されたカタログの場合、以下のページが表示されます。行った変更は、後でカタログに追加するマシンにのみ適用されることに注意してください。既存のマシンは変更されません。
    • Virtual Machinesページで、マシンを作成するマシンサイズと可用性ゾーンを変更します。
      注：
      • カタログがサポートするマシンサイズのみが表示されます。
      • 必要に応じて、Show only machine sizes used in other machine catalogsを選択して、マシンサイズリストをフィルターします。
      • Azureカタログの場合、Storage and License Typesページでストレージ冗長性がZRSである場合、ゾーン選択をクリアしてAzureにVM可用性ゾーンを管理させることを示唆する警告が表示されます。
    • Machine Profileページで、マシンプロファイルを使用するか変更するかを選択します。
      注：
      Azureカタログの場合、可用性ゾーンを含むマシンプロファイルを変更し、ストレージ冗長性にZRSを選択すると、ゾーン選択をクリアするよう促す警告が表示されます。
    • (カタログが専用グループホストで構成されている場合のみ) 専用ホストグループページで、ホストグループを変更するかどうかを選択します。
    • ストレージとライセンスの種類ページで、ストレージ冗長タイプ (Azureカタログの場合)、ストレージタイプ、ライセンスタイプ、およびAzure Computer Gallery設定 (「準備済みイメージをAzure Galleryに配置」が使用されている場合にのみ利用可能) を変更するかどうかを選択します。
      注：
      新しく選択した設定が現在のマシンサイズをサポートしていない場合、警告ダイアログボックスが表示され、設定を変更するとマシンサイズ設定がリセットされることを通知します。続行を選択すると、仮想マシンメニューの横に赤い点が表示され、新しいマシンサイズを選択するように促されます。
    各ページで利用可能な設定の詳細については、「Azure Resource Managerイメージを使用してマシンカタログを作成する」を参照してください。
    Remote PC Accessカタログの場合、以下のページが表示されます。
    • 電源管理ページで、電源管理設定を変更し、電源管理接続を選択します。
    • 組織単位ページで、Active Directory OUを追加または削除します。
  7. 説明ページで、カタログの説明を変更します。
  8. 行った変更を適用するには適用をクリックし、終了するには保存をクリックします。

カタログの名前を変更する

  1. Studioで、左ペインのマシンカタログを選択します。
  2. カタログを選択し、アクションバーでマシンカタログの名前を変更を選択します。
  3. 新しい名前を入力します。

カタログを削除する

カタログを削除する前に、以下を確認してください。
  • すべてのユーザーがログオフしており、切断されたセッションが実行されていないこと。
  • カタログ内のすべてのマシンでメンテナンスモードがオンになっており、新しい接続が確立できないこと。
  • カタログ内のすべてのマシンが電源オフになっていること。
  • カタログがデリバリーグループに関連付けられていないこと。つまり、デリバリーグループにそのカタログのマシンが含まれていないこと。
カタログを削除するには：
  1. Studioで、左側のペインでマシンカタログを選択します。
  2. カタログを選択し、アクションバーでその他を選択してから、マシンカタログの削除を選択します。
  3. カタログに永続マシンが含まれている場合は、それらのマシンをハイパーバイザーまたはクラウドサービスからも削除するかどうかを指定します。削除することを選択した場合は、それらのActive Directoryコンピューターアカウントを保持、無効化、または削除するかを選択します。
  4. 必要に応じて、進行状況を非表示を選択して、バックグラウンドで削除を実行します。
注：
  • Azure Resource Managerカタログを削除すると、関連付けられているマシンとリソースグループは、保持することを選択した場合でもAzureから削除されます。
  • 非永続マシンを含むカタログを削除すると、それらのマシンはハイパーバイザーまたはクラウドサービスから削除されます。
  • カタログの削除中にハイパーバイザーまたはクラウドサービスに到達できない場合、カタログとVMの両方の削除が失敗します。必要に応じて、CitrixサイトデータベースからVMレコードのみを削除することを選択できます。これを行うには、マシンカタログノードでマシンカタログを選択し、トラブルシューティングタブに表示される削除を実行します。この操作では、ホスト上のVMはそのまま残ることに注意してください。

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

マシンカタログ内のActive Directoryアカウントを管理するには、次の操作を実行できます。
  • シングルセッションおよびマルチセッションカタログからActive Directoryコンピューターアカウントを削除して、未使用のマシンアカウントを解放します。これらのアカウントは、他のマシンで使用できます。
  • カタログにマシンが追加されたときにコンピューターアカウントがすでに存在するように、アカウントを追加します。OU名にスラッシュ（/）を使用しないでください。
Active Directoryアカウントを管理するには：
  1. Studioで、左側のペインのMachine Catalogsを選択します。
  2. カタログを選択し、アクションバーでManage AD accountsを選択します。
  3. コンピューターアカウントを追加するか削除するかを選択します。アカウントを追加する場合は、アカウントのパスワードをどうするかを指定します。すべてリセットするか、すべてのアカウントに適用されるパスワードを入力します。
    現在のアカウントパスワードがわからない場合は、パスワードをリセットできます。パスワードリセットを実行する権限が必要です。パスワードを入力すると、アカウントがインポートされるときにパスワードが変更されます。アカウントを削除する場合は、Active Directory内のアカウントを保持するか、無効にするか、削除するかを選択します。
カタログからマシンを削除したり、カタログを削除したりするときに、Active Directoryアカウントを保持するか、無効にするか、削除するかを指定することもできます。

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

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

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

マスターイメージを使用するMCSプロビジョニング済みカタログを、準備済みイメージを使用するように変換するには、次の手順に従います。
  1. 左ペインでマシンカタログをクリックし、変換するマシンカタログを選択します。右クリックして準備済みイメージに変換を選択します。
  2. イメージページで、準備済みイメージを選択します。
  3. ロールアウト戦略ページで、選択した準備済みイメージでこのカタログを更新するタイミングを選択します。
  4. 概要ページで詳細を確認し、完了をクリックします。
  5. 変換されたマシンカタログの詳細をテンプレートプロパティで確認します。
現在、この機能はAzureおよびVMware仮想化環境でのみ利用可能です。

イメージを更新または作成する

カタログのマスターイメージを変更する前に、既存のイメージを更新するか、新しいイメージを作成して、ホストハイパーバイザー上に新しいイメージを準備します。
  1. ハイパーバイザーまたはクラウドサービスプロバイダーで、現在のVMのスナップショットを取得し、スナップショットにわかりやすい名前を付けます。このスナップショットは、マスターイメージをロールバックするために使用できます。
  2. 必要に応じて、イメージの電源をオンにしてログオンします。
  3. 更新プログラムをインストールするか、イメージに必要な変更を加えます。
  4. イメージがPersonal vDiskを使用している場合は、インベントリを更新します。
  5. VMの電源をオフにします。
  6. VMのスナップショットを取得し、マスターイメージを変更する際に認識されるようなわかりやすい名前をスナップショットに付けます。
注記:
管理インターフェースを使用してスナップショットを作成することもできますが、ハイパーバイザー管理コンソールを使用してスナップショットを作成し、Studioでそのスナップショットを選択することをお勧めします。これにより、自動生成された名前ではなく、意味のある名前と説明を付けることができます。GPUイメージの場合、イメージはXenServer XenCenter®コンソールからのみ変更できます。

マスターイメージを変更する

新しいマスターイメージをカタログ内のすべてのマシンに展開するには：
  1. Studioで、左ペインの ［マシンカタログ］ を選択します。
  2. カタログを選択し、アクションバーで ［マスターイメージの変更］ を選択します。
  3. ［イメージ］ ページで、展開するホストとイメージを選択します。
    ヒント:
    MCSで作成されたカタログの場合、イメージにメモを追加して注釈を付けることができます。メモには最大500文字を含めることができます。マスターイメージを変更するたびに、メモを追加したかどうかにかかわらず、メモ関連のエントリが作成されます。メモを追加せずにカタログを更新した場合、エントリはnull (-) として表示されます。イメージのメモ履歴を表示するには、カタログを選択し、下部ペインで ［テンプレートプロパティ］ をクリックし、 ［メモ履歴の表示］ をクリックします。
  4. ［ロールアウト戦略］ ページで、マシンカタログ内のマシンを新しいイメージに変更するタイミング（次回のシャットダウン時、または即時）を選択します。
    注記:
    ［ロールアウト戦略］ ページは永続VMでは利用できません。ロールアウトは非永続VMにのみ適用されるためです。
  5. ［概要］ ページで情報を確認し、 ［完了］ を選択します。各マシンは更新後に自動的に再起動します。
    更新の進行状況を追跡するには、 ［マシンカタログ］ でカタログを見つけて、インライン進捗バーと段階的な進捗グラフを表示します。非永続カタログの場合、 ［イメージ更新］ 列を通じて、 ［完全に更新済み］ 、 ［部分的に更新済み］ 、 ［更新保留中］ 、 ［イメージ準備中］ などのイメージ更新ステータスを追跡できます。
    ヒント:
    「イメージの更新」列を表示するには、アクションバーの「表示する列」アイコンを選択し、「マシンカタログ > イメージステータス」を選択して、「保存」をクリックします。
PowerShell SDK を使用してカタログを更新する場合、イメージまたはイメージのスナップショットの代替として、ハイパーバイザーテンプレート (VMTemplates) を指定できます。
Azure ベースのマシンカタログに新しいマスターイメージを展開するには：
  1. Studio から、左側のペインで「マシンカタログ」を選択します。
  2. Azure カタログを選択し、アクションバーで「マスターイメージの変更」を選択します。
  3. 「マスターイメージの変更」ページで、マスターイメージの下にあるイメージを選択します。ブレードには、リソースと同じリージョンに属するすべてのイメージが一覧表示されます。

展開戦略

次回のシャットダウン時にイメージを変更すると、現在使用されていないマシン、つまりアクティブなユーザーセッションがないマシンにすぐに影響します。使用中のシステムは、現在のアクティブセッションが終了したときに更新を受け取ります。
注：
展開戦略は、非永続的なVMにのみ適用されます。
以下を考慮してください：
  • 該当するマシンでの更新が完了するまで、新しいセッションを起動することはできません。
  • シングルセッションマシンでは、マシンが使用されていないとき、またはユーザーがログインしていないときに、マシンはすぐに更新されます。
  • 子マシンを持つマルチセッションOSの場合、再起動は自動的に行われません。更新されたマスターイメージを適用するには、Studio、PowerShell、またはWorkspaceを使用してマシンを再起動します。マシンまたはハイパーバイザーからの再起動では、更新は適用されません。
ヒント：
ホスト接続の詳細設定を使用して、再起動されるマシンの数を制限します。これらの設定を使用して、特定のカタログに対して実行されるアクションを変更します。詳細設定はハイパーバイザーによって異なります。

マスターイメージをロールバックする

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

機能レベルを変更または変更を元に戻す

マシンのVDAを新しいバージョンにアップグレードした後、マシンカタログの機能レベルを変更します。すべてのVDAを最新バージョンにアップグレードして、すべての最新機能にアクセスできるようにすることをお勧めします。
マシンカタログの機能レベルを変更する前に、次の点に注意してください。
  • アップグレードされたマシンを起動して、Citrix DaaSに登録します。これにより、管理インターフェイスは、カタログ内のマシンがアップグレードを必要としていることを判断できます。
カタログの機能レベルを変更するには：
  1. Studioで、左ペインの**「マシンカタログ」**を選択します。
  2. カタログを選択します。下ペインの**「詳細」**タブにバージョン情報が表示されます。
  3. **「機能レベルの変更」を選択します。管理インターフェイスがカタログの機能レベルを変更する必要があると検出した場合、メッセージが表示されます。プロンプトに従ってください。1つ以上のマシンを変更できない場合、その理由を説明するメッセージが表示されます。すべてのマシンが適切に機能するように、「変更」**をクリックする前にこれらの問題を解決することをお勧めします。
カタログのアップグレードが完了した後、カタログを選択し、アクションバーで**「機能レベルの変更を元に戻す」**を選択することで、マシンを以前のVDAバージョンに戻すことができます。

カタログを複製する

カタログを複製する前に、次の考慮事項に注意してください。
  • オペレーティングシステムおよびマシン管理に関連する設定は変更できません。複製されたカタログは、元のカタログからこれらの設定を継承します。
    注：
    複製するAzureカタログを選択し、マスターイメージを選択した場合、ブレードにはリソースと同じリージョンに属するすべてのイメージが一覧表示されます。
  • カタログの複製には時間がかかる場合があります。必要に応じて、**「進行状況を非表示」**を選択して、バックグラウンドで複製を実行します。
  • クローンされたカタログは元の名前を継承し、サフィックス Copy を持ちます。名前は変更できます。「カタログの名前を変更する」を参照してください。
  • クローン作成が完了したら、クローンされたカタログをデリバリーグループに割り当てるようにしてください。
  • クローン作成によって空のカタログを作成できます。カタログのクローン作成中に、MCSプロビジョニングされたカタログではマシンの数をゼロに設定し、MCSプロビジョニングされていないカタログではマシンを追加しないようにできます。
  1. Studioから、左側のペインで を選択します。
  2. カタログを選択し、アクションバーで を選択します。
  3. ウィンドウで、クローンされたカタログの設定を表示し、必要に応じて設定を構成します。 を選択して次のページに進みます。
  4. ページで、設定の概要を表示し、 を選択してクローン作成を開始します。
  5. 必要に応じて、 を選択して、バックグラウンドでクローン作成を実行します。

フォルダーを使用してカタログを整理する

フォルダーを作成してカタログを整理し、簡単にアクセスできるようにすることができます。たとえば、イメージの種類別または組織構造別にカタログを整理できます。
ヒント:
マシンカタログノードのデフォルトの表示（フォルダー表示またはリスト表示）を設定するには、アクションバーの右上にある アイコンをクリックします。

必要な役割

デフォルトでは、カタログフォルダーを作成および管理するには、Cloud Administrator、Full Administrator、またはMachine Catalog Administratorの組み込み役割が必要です。必要に応じて、カタログフォルダーを作成および管理するための役割をカスタマイズできます。詳しくは、「必要な権限」を参照してください。

カタログフォルダーを作成する

開始する前に、まずカタログの整理方法を計画してください。次の点を考慮してください。
  • フォルダーは最大5レベルまでネストできます（デフォルトのルートフォルダーを除く）。
  • カタログフォルダーには、カタログとサブフォルダーを含めることができます。
  • Studioのすべてのノード（マシンカタログ、デリバリーグループ、アプリケーション、アプリケーショングループなど）は、バックエンドで同じフォルダーツリーを共有します。フォルダーの名前変更や移動時に名前の競合を避けるため、異なるノード間で最上位フォルダーに一意の名前を使用してください。
    New-BrokerAdminFolder SDKコマンドレットを使用してフォルダーを作成し、それをマシンカタログノードの下に表示させたい場合は、Set-BrokerAdminFolderMetadataコマンドレットを使用してContainsMachineCatalogsメタデータを追加する必要があります。
    例:
    Set-BrokerAdminFolderMetadata -AdminFolderId {adminFolderUid} -Name ContainsMachineCatalogs -Value true
カタログフォルダーを作成するには、次の手順に従います。
  1. Studioで、左ペインのマシンカタログを選択します。
  2. フォルダー階層でフォルダーを選択し、アクションバーでフォルダーの作成を選択します。
  3. 新しいフォルダーの名前を入力し、完了をクリックします。
ヒント:
意図しない場所にフォルダーを作成した場合でも、正しい場所にドラッグして移動できます。

カタログを移動する

カタログはフォルダー間で移動できます。詳細な手順は次のとおりです。
  1. Studioで、左ペインのマシンカタログを選択します。
  2. フォルダー別にカタログを表示します。フォルダー階層の上にあるすべて表示をオンにすると、すべてのカタログを一度に表示することもできます。
  3. カタログを右クリックし、マシンカタログの移動を選択します。
  4. カタログの移動先のフォルダーを選択し、完了をクリックします。
ヒント:
カタログをフォルダーにドラッグできます。

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

カタログフォルダーの削除、名前の変更、移動ができます。
フォルダーとそのサブフォルダーにカタログが含まれていない場合にのみ、フォルダーを削除できます。
フォルダーを管理するには、次の手順に従います。
  1. Studioで、左ペインのマシンカタログを選択します。
  2. フォルダー階層でフォルダーを選択し、必要に応じてアクションバーでアクションを選択します。
    • フォルダーの名前を変更するには、フォルダー名の変更を選択します。
    • フォルダーを削除するには、フォルダーの削除を選択します。
    • フォルダーを移動するには、フォルダーの移動を選択します。
  3. 画面の指示に従って、残りの手順を完了します。

必要な権限

次の表に、カタログフォルダーに対してアクションを実行するために必要な権限を示します。
アクション 必要な権限
カタログフォルダーの作成 マシンカタログフォルダーの作成
カタログフォルダーの削除 マシンカタログフォルダーの削除
カタログフォルダーの移動 マシンカタログフォルダーの移動
カタログフォルダーの名前変更 マシンカタログフォルダーの編集
カタログをフォルダーに移動 マシンカタログフォルダーの編集とマシンカタログプロパティの編集

VDAのアップグレード

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

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

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

必要な権限

デフォルトでは、マシンカタログの構成セットの作成と管理には、WEM Full Administratorロールと、以下のいずれかのロールが必要です。
  • フルアクセス管理者
  • クラウド管理者
  • マシンカタログ管理者
他のロールが構成セットを管理できるようにするには、それらにManage configuration sets権限とWEM Full Administratorロールの両方を割り当てます。

エクスペリエンス最適化設定を編集する

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

カタログ作成を再試行する

注：
この機能はMCSカタログにのみ適用されます。
失敗したカタログにはエラーアイコンが表示されます。詳細を確認するには、各カタログのトラブルシューティングタブに移動します。カタログの作成を再試行する前に、以下の考慮事項に注意してください。
  • まずトラブルシューティング情報を確認し、問題を解決してください。この情報には、検出された問題が記述されており、それらを解決するための推奨事項が提供されています。
  • オペレーティングシステムおよびマシン管理に関連する設定は変更できません。カタログは、元の設定を継承します。
  • 作成には時間がかかる場合があります。必要に応じて、進行状況を非表示を選択して、バックグラウンドで作成を実行します。
カタログの作成を再試行するには、次の手順を実行します。
  1. Studioで、左ペインのマシンカタログを選択します。
  2. カタログを選択し、そのトラブルシューティングタブに移動します。
  3. 再試行ハイパーリンクをクリックして、カタログの作成を再試行します。
  4. 表示されるウィザードで、必要に応じて設定を変更します。変更する必要がない場合は、直接概要ページに移動できます。
  5. 完了したら、完了を選択して作成を開始します。

（CitrixによってプロビジョニングされていないVDAのみ）登録トークンの生成と管理

注：
このタスクを実行するには、Cloud Administratorの役割が必要です。
Citrixによってプロビジョニングされていないマシンにトークンベースの登録を採用することを決定したら、マシンカタログごとにトークンを生成し、VDAインストール管理者と共有します。
登録トークンの特徴：
  • 登録範囲：1～5000台のVDAマシン
  • 有効期間：最大14日間
Studioを使用してカタログのトークンを生成するには、次の手順に従います。
  1. マシンカタログで、マシン数列にプロビジョニング方法：手動と表示されている、MCSでプロビジョニングされていないカタログを見つけます。
  2. カタログを右クリックし、登録トークンの管理を選択します。
  3. 表示される登録トークンの生成ページで、次のトークン情報を提供します。
    • トークンの名前を入力します。
    • 有効期間を入力します。期間は14日以内である必要があります。トークンは指定された期間のみ有効です。
    • （オプション）トークンで登録されたVDAの電源管理のためにホスト接続を選択します。オプションには、このカタログのゾーン下のすべてのホスト接続が含まれます。
    • トークンの使用制限（1～5000）を入力します。
  4. 生成をクリックします。
  5. 表示されるトークンが正常に生成されましたウィンドウで、トークンをコピーして安全な場所に保存するか、ダウンロードをクリックしてダウンロードフォルダーにダウンロードします。
    トークンリストにトークンレコードが表示されます。
    トークンの生成(/en-us/citrix-daas/media/token-based-enrollment.png)
  6. トークンをVDAインストール管理者と共有します。
    マシンにVDAとトークンをインストールする方法の詳細については、「VDAsのインストール」を参照してください。

トークンの管理

トークンを取り消してVDA登録に使用できないようにするには、2つのオプションがあります。
  • 取り消し：トークンを取り消しますが、ログ記録のためにリストに残します。
  • 削除：トークンを取り消し、リストから削除します。
注：
期限切れのトークンは14日後に自動的に削除されます。

PowerShellの使用

このセクションでは、PowerShellを使用してカタログを管理する方法について詳しく説明します。
  • PowerShellを使用してVDAのアップグレードステータスとVDAバージョンを確認する
  • マシン名のシーケンス番号を管理する
  • イメージに説明を追加する
  • OSディスクをリセットする
  • アクティブなコンピューターアカウントのID情報を修復する
  • 既存のマシンカタログのネットワーク設定を変更する(/ja-jp/citrix-daas/install-configure/machine-catalogs-manage.html#change-the-network-setting-for-an-existing-machine-catalog)
  • マシンカタログのバージョンを管理する(/ja-jp/citrix-daas/install-configure/machine-catalogs-manage.html#manage-versions-of-a-machine-catalog)
  • 既存のマシンカタログのキャッシュ構成を変更する(/ja-jp/citrix-daas/install-configure/machine-catalogs-manage.html#change-cache-configuration-of-an-existing-machine-catalog)
  • マシンプロファイルに基づかないマシンカタログを、マシンプロファイルに基づくマシンカタログに変換する(/ja-jp/citrix-daas/install-configure/machine-catalogs-manage.html#convert-a-non-machine-profile-based-machine-catalog-to-machine-profile-based-machine-catalog)
  • カタログに関連付けられている警告とエラーを取得する(/ja-jp/citrix-daas/install-configure/machine-catalogs-manage.html#retrieve-warnings-and-errors-associated-with-a-catalog)
  • ハイパーバイザーアクセスなしでマシンを削除する(/ja-jp/citrix-daas/install-configure/machine-catalogs-manage.html#delete-machines-without-hypervisor-access)
  • 個々のVMのプロパティを更新する(#update-properties-of-individual-vms)

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

MCSを使用して展開されたマシンのシーケンス番号をPowerShellコマンドでカスタマイズするには、次の手順を実行します。
  1. Delivery ControllerでPowerShellを管理者として開きます。
  2. Citrixモジュールをロードするには、コマンドasnp citrix*を実行します。
  3. カタログのIDプールに対する開始カウントを確認するには、次のコマンドを実行します。
    Get-AcctIdentityPool -IdentityPoolName xxx
    IdentityPoolNameはカタログの名前です。
  4. このカウントを別の値に設定する場合は、次のコマンドを実行し、StartCountをXとして指定します。
    Set-AcctIdentityPool -IdentityPoolName xxx -StartCount X
  5. マシンが必要な数で作成されるように、マシンをカタログに追加します。
  6. マシンを作成した後、次のコマンドを実行して元の値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"
  • 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
プロビジョニングスキームUID : 7585f0de-192e-4847-a6d8-22713c3a2f42
ProvisioningSchemeName : MyScheme
MasterImageVM : /Base.vm/base.snapshot
日付：17/05/2021 09:27:50
マスターイメージノート：Office365がインストールされています`

OSディスクをリセットする

PowerShellコマンドReset-ProvVMDiskを使用して、MCSで作成されたマシンカタログ内の永続VMのOSディスクをリセットします。現在、この機能はAWS、Azure、Google Cloud、SCVMM、VMware、およびXenServer®仮想化環境に適用されます。
PowerShellコマンドを正常に実行するには、以下を確認してください。
  • ターゲットVMが永続MCSカタログ内にあること。
  • MCSマシンカタログが正常に機能していること。これは、プロビジョニングスキームとホストが存在し、プロビジョニングスキームに正しいエントリがあることを意味します。
  • ハイパーバイザーがメンテナンスモードではないこと。
  • ターゲットVMの電源がオフになっており、メンテナンスモードになっていること。
OSディスクをリセットするには、次の手順を実行します。
  1. PowerShellウィンドウを開きます。
  2. asnp citrix*を実行して、Citrix固有のPowerShellモジュールをロードします。
  3. 次のいずれかの方法で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
  4. リセットされる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をメンテナンスモードから解除したり、電源をオンにしたりしないでください。
  5. Reset-ProvVMDiskコマンドによって返されるタスクのステータスを取得するには、Get-ProvTaskを実行します。

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

ID関連の問題があるアクティブなコンピューターアカウントのID情報をリセットできます。マシンパスワードと信頼キーのみをリセットするか、IDディスクのすべての構成をリセットするかを選択できます。この実装は、永続的および非永続的な両方のMCSマシンカタログに適用できます。
注：
現在、この機能はAWS、Azure、GCP、SCVMM、VMware、およびXenServerの仮想化環境でのみサポートされています。

条件

IDディスクを正常にリセットするには、以下を確認してください。
  • VMをシャットダウンし、メンテナンスモードに設定します
  • PowerShellコマンドにパラメーター-OSを含めないでください

ID情報をリセットする

ID情報をリセットするには：
  1. PowerShellウィンドウを開きます。
  2. Citrix固有のPowerShellモジュールをロードするためにasnp citrix*を実行します。
  3. 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 IdentityInfoReset-ProvVMDisk ProvisioningSchemeName <name> -VMName <name>  -Identity
    • IDディスクを完全に再作成するには:
      Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMname <name> -Identity -Recreate
      注:
      マシンがVDAバージョン2511（アップデート1）以降で、一意のMachineGuid (HKLM:\Software\Citrix\MachineIdentityServiceAgent\EnableUniqueMachineGuid) を有効にするレジストリキーが設定されている場合、-Recreate の設定に関係なく、以前と同じMachineGuid を引き続き使用します。
  4. アクションを確定するには「y」と入力します。-Force パラメーターを使用して確認プロンプトをスキップすることもできます。例:
    Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMName <name> -Identity -Force
  5. 更新されたIDディスク設定を確認するには、Get-ProvVM -ProvisioningSchemeName <name -VMName <name> を実行します。IDディスクの属性（例: IdentityDiskId）は更新されている必要があります。StorageId と IdentityDiskIndex は変更されていてはなりません。

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

既存のマシンカタログのネットワーク設定を変更して、新しいVMが新しいサブネットワーク上に作成されるようにすることができます。ネットワーク設定を変更するには、Set-ProvScheme コマンドでパラメーター -NetworkMapping を使用します。
既存のプロビジョニングスキームのネットワーク設定を変更するには、次の手順を実行します。
  1. PowerShellウィンドウで、コマンド asnp citrix* を実行してPowerShellモジュールをロードします。
  2. 変更するネットワークパスに移動するには、(Get-Provscheme -ProvisioningSchemeName "name").NetworkMaps を実行します。
  3. 新しいネットワーク設定に変数を割り当てます。例:
    $NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"}
  4. Set-ProvScheme -ProvisioningSchemeName "name" -NetworkMapping $NewNetworkMap を実行します。
  5. 既存のプロビジョニングスキームの新しいネットワーク設定を確認するには、(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
  • マシンカタログに関連付けられているバージョンの総数を確認するには：
    (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 を有効にします。UseWriteBackCache が有効なマシンカタログを作成するには、New-ProvScheme を使用します。例:
    New-ProvScheme -ProvisioningSchemeName $CatalogName -HostingUnitUid $HostingUnitUid `
    -IdentityPoolUid $acctPool.IdentityPoolUid -CleanOnBoot `
    -MasterImageVM $MasterImage `
    -ServiceOffering $ServiceOffering `
    -NetworkMap $NetworkMap `
    -SecurityGroup $SecurityGroup `
    -UseWriteBackCache -WriteBackCacheDiskSize 8

キャッシュ構成を変更する

Set-ProvScheme コマンドを実行します。例:
Set-ProvScheme -ProvisioningSchemeName $provScheme.ProvisioningSchemeName -WriteBackCacheDisk32 -WriteBackCacheMemorySize 128
注:
  • 少なくとも 1 GB のキャッシュディスクストレージが必要なため、WriteBackCacheDiskSize の値はゼロより大きくする必要があります。
  • WriteBackCacheMemorySize の値は、マシンカタログのメモリサイズよりも小さくする必要があります。
  • これらの変更は、変更後にカタログに追加された新しい VM にのみ影響します。既存の VM はこれらの変更の影響を受けません。

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

VM、テンプレート仕様 (Azure の場合)、起動テンプレート (AWS の場合)、または VMware テンプレート (VMware の場合) をマシンプロファイルの入力として使用して、マシンプロファイルベースではないマシンカタログをマシンプロファイルベースのマシンカタログに変換できます。カタログに追加された新しい VM は、マシンプロファイルからプロパティ値を取得します。
注:
既存のマシンプロファイルベースのマシンカタログを、マシンプロファイルベースではないマシンカタログに変更することはできません。
これを行うには:
  1. 永続的または非永続的なマシンカタログを、VMを使用して、マシンプロファイルなしで作成します。
  2. PowerShellウィンドウを開きます。
  3. マシンプロファイルからのプロパティ値を、マシンカタログに追加された新しいVMに適用するには、Set-ProvSchemeコマンドを実行します。例:
    • Azureの場合:
      Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile XDHyp:\HostingUnits\<HostingUnitName>\machineprofile.folder\<ResourceGroupName>\<TemplateSpecName>\<VersionName>
    • AWSの場合:
      Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile "XDHyp:\HostingUnits\<hosting-unit>\<launch-template>.launchtemplate\<launch-template-version>.launchtemplateversion"
    • VMwareの場合:
      Set-ProvScheme -ProvisioningSchemeName "my-prov-scheme" -MachineProfile "XDHyp:\HostingUnits\my-hosting-unit\my-template.template"
      注:
      VMwareテンプレートからFolderIDが派生するのを避けるために、FolderIDをカスタムプロパティとして設定します。

カタログに関連付けられた警告とエラーを取得する

履歴エラーと警告を取得して、MCSマシンカタログの問題を理解し、それらの問題を修正できます。
PowerShellコマンドを使用して、次のことができます。
  • エラーまたは警告のリストを取得する
  • 警告の状態を新規から確認済みに変更する
  • エラーまたは警告を削除する
PowerShellコマンドを実行するには:
  1. PowerShell ウィンドウを開きます。
  2. Citrix 固有の PowerShell モジュールをロードするには、asnp citrix* を実行します。
エラーと警告のリストを取得するには：
Get-ProvOperationEvent コマンドを実行します。
  • パラメーターなしの場合：すべてのエラーと警告を取得します
  • LinkedObjectType および LinkedObjectUid パラメーターを使用する場合：特定のプロビジョニングスキームに関連付けられているすべてのエラーと警告を取得します
  • EventId パラメーターを使用する場合：このイベント ID に一致する特定のエラーまたは警告を取得します
  • Filter パラメーターを使用する場合：カスタマイズされたフィルターによってエラーまたは警告を取得します
エラーまたは警告の状態を New から Acknowledged に変更するには：
Confirm-ProvOperationEvent コマンドを実行します。
  • EventId パラメーターを使用する場合：このイベント ID に一致する特定のエラーまたは警告の状態を設定します。特定のイベントのエラーまたは警告の EventId は、Get-ProvOperationEvent コマンドの出力として取得できます。
  • LinkedObjectType および LinkedObjectUid パラメーターを使用する場合：特定のプロビジョニングスキームに関連付けられているすべてのエラーと警告の状態を設定します
  • All パラメーターを使用する場合：すべてのエラーと警告の状態を Acknowledged に設定します
エラーまたは警告を削除するには：
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のいずれかが非永続的である場合、操作は失敗します。
ハイパーバイザーに到達できないために操作が失敗すると、次のプロンプトが表示されます。
Try to use -PurgeDBOnly option to clean DDC database..
MCSデータベースからVMの参照を削除するには、Remove-ProvVM PowerShellコマンドで-PurgeDBOnlyオプションを使用します。例：
Remove-ProvVM -ProvisioningSchemeName SCVMM-MC -VMName SCVMM01 -PurgeDBOnly

個々のVMのプロパティを更新する

永続的なMCSマシンカタログ内の個々のVMのプロパティは、PowerShellコマンドSet-ProvVMを使用して更新できます。ただし、更新はすぐに適用されません。更新を適用するには、PowerShellコマンドSet-ProvVMUpdateTimeWindowを使用して時間枠を設定する必要があります。
この実装により、マシンカタログ全体を更新することなく、個々のVMを効率的に管理できます。現在、この機能はAzureおよびVMware環境に適用可能です。
現在、更新できるプロパティは次のとおりです。
  • CustomProperties
  • ServiceOffering (VMwareには適用されません)
  • MachineProfile
  • CpuCount
  • Memory
この機能を使用すると、次のことができます。
VMのプロパティを更新する前に：
  1. PowerShellウィンドウを開きます。
  2. Citrix固有のPowerShellモジュールをロードするには、asnp citrix*を実行します。
  3. 既存のマシンカタログの構成を確認します。例：
    Get-ProvScheme -ProvisioningSchemeName <catalog name>
  4. 更新を適用するVMの構成を確認します。例：
    Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1

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

VMのプロパティを更新するには、次の手順を実行します。
  1. 更新を適用するVMの電源を切ります。
  2. VMのプロパティを更新します。例えば、VMのストレージタイプ (StorageType) カスタムプロパティを更新したい場合は、以下を実行します。
    Set-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."
    マシンカタログ内の2つのVMのプロパティを同時に更新できます。例:
    Set-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1 -CustomProperties "...<Property Name='StorageType' Value='Premium_LRS' />..."Set-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine2 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."
    注:
    更新はすぐに適用されません。
  3. 更新対象として指定されたプロパティのリストと構成バージョンを取得します。例:
    Get-ProvVMConfiguration -ProvisioningSchemeName <catalog name> -VMName machine1
    Version のプロパティ値と、更新対象のプロパティ (この場合は StorageType) を確認します。
  4. 構成バージョンを確認します。例:
    Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1
    ProvVMConfigurationVersion のプロパティ値を確認します。更新はまだ適用されていません。VMはまだ古い構成のままです。
  5. スケジュールされた更新を要求します。例:
    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <catalog name> -StartsNow -DurationInMinutes -1
    スケジュールされた更新の詳細については、プロビジョニングされたマシンを現在のプロビジョニングスキームの状態に更新する を参照してください。
    注:
    保留中のプロビジョニングスキームの更新も適用されます。
  6. VMを再起動します。例:
    New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
  7. 構成バージョンを確認します。例:
    Get-ProvVM -ProvisioningSchemeName AzureCatalog -VMName machine1
    ProvVMConfigurationVersion のプロパティ値を確認します。更新が適用されました。VMは新しい構成になりました。
  8. VMにさらに構成アップデートを適用するには、VMをオフにして、手順を繰り返します。

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

VMで更新されたプロパティを保持するには、以下を実行します。
  1. アップデートを適用したいVMをオフにします。
  2. マシンカタログを更新します。たとえば、VMサイズ (ServiceOffering) とストレージタイプ (StorageType) を変更したい場合は、以下を実行します。
    Set-ProvScheme -ProvisioningSchemeName <catalog name> -ServiceOffering Standard_E4_v3 -CustomProperties "...<Property Name='StorageType' Value='StandardSSD_LRS' />..."
  3. マシンカタログの構成詳細を取得します。例:
    Get-ProvScheme -ProvisioningSchemeName <catalog name>
    ProvisioningSchemeVersion が1つ増えました。VMサイズとストレージタイプも更新されます。
  4. 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"
    注:
    マシンプロファイルの入力には、タグと異なるVMサイズ (ServiceOffering) が指定されています。
  5. VM上の構成アップデートとマシンカタログのアップデートをマージした後にVMが持つプロパティのリストを取得します。例:
    Get-ProvVMConfigurationResultantSet -ProvisioningSchemeName <catalog name> -VMName machine1
    注:
    VMに対するすべてのアップデートは、マシンカタログで行われたアップデートを上書きします。
  6. VMのスケジュールされたアップデートを要求します。例:
    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <catalog name> -VMName machine1 -StartsNow -DurationInMinutes -1
  7. VMを再起動します。例:
    New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
    VMは、マシンプロファイルから派生した更新済みのVMサイズを保持します。マシンプロファイルで指定されたタグ値もVMに適用されます。ただし、ストレージタイプは最新のプロビジョニングスキームから派生します。
  8. VMの構成バージョンを取得します。例:
    Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1
    ProvisioningSchemeVersion と ProvVMConfigurationVersion に最新バージョンが表示されます。

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

  1. VMに更新を適用した後、VMをシャットダウンします。
  2. 次のコマンドを実行して、VMに適用された更新を削除します。例:
    Set-ProvVM -RevertToProvSchemeConfiguration -ProvisioningSchemeName <catalog name> -VMName machine1
  3. VMのスケジュールされた更新を要求します。例:
    Set-ProvVMUpdateTimeWindow -ProvisioningSchemeName <catalog name> -VMName machine1 -StartsNow -DurationInMinutes -1
  4. VMを再起動します。例:
    New-BrokerHostingPowerAction -MachineName machine1 -Action TurnOn
  5. VMの構成バージョンを確認します。例:
    Get-ProvVM -ProvisioningSchemeName <catalog name> -VMName machine1
    ProvVMConfigurationVersion の値が、マシンカタログの構成バージョンになります。

VMのストレージ移行

VMwareおよびXenServer環境では、既存のVMのディスクストレージを古いストレージから新しいストレージに移動できます。移行中、MCSは電源管理、OSディスクのリセットなどのVM機能を保持します。新しいディスクストレージを使用して、新しいVMをマシンカタログに追加することもできます。これを行うには、PowerShellコマンド Move-ProvVMDisk を使用します。
フルクローン永続VMと非永続VMを移行できます。
  • 永続的なフルクローンVMの場合: OSディスク、IDディスク、および非MCSプロビジョニングディスク。
  • 非永続VMの場合: OSディスク、IDディスク、およびライトバックキャッシュ (WBC) ディスク。
新しいストレージは、次の条件を満たす必要があります。
  • 古いストレージと同じクラスター内にある必要があります。
  • VMが実行されているホストは、古いデータストアと新しいデータストアの両方にアクセスできる必要があります。

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

ディスクストレージを移行するには：
  1. 既存のホスティングユニットに宛先ストレージを追加します。宛先ストレージを追加するには、PowerShellコマンド Add-Hyphostingunitstorage を実行します。
    古いストレージに新しいVMを追加したくない場合は、古いストレージをSupersededに変更します。これはStudioまたはPowerShellコマンドを使用して実行できます。Studioについては、ストレージの編集 を参照してください。または、Set-Hyphostingunitstorage を実行し、Superseded を true に設定して、古いストレージでの新しいVM作成を無効にします。
    注：
    非永続VMの場合：
    • WBCを使用する場合は、ホスティングユニットでWBC宛先ストレージを構成します。
    • OS宛先ストレージが構成されている場合、WBC（使用されている場合）はOS宛先ストレージと互換性がある必要があります。
    • OS宛先ストレージが構成されていない場合、WBC（使用されている場合）は現在のOSストレージと互換性がある必要があります。
  2. VMをシャットダウンし、メンテナンスモードをオンにします。
  3. プロビジョニングスキーム、ホスティングユニット、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 *
  4. OSディスク、IDディスク、およびWBCディスク (非永続VMに適用) をMove-ProvVMDisk PowerShellコマンドを使用して宛先ストレージに移行します。
    注：
    • 常にOSディスクとIDディスクをDiskTypeおよびDestinationStorageIdパラメーターで指定します。
    • 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ディスクがある場合は、WBCディスクをDiskTypeパラメーターに追加し、必要な情報をDestinationStorageIdパラメーターに追加します。

トラブルシューティング

いずれかのディスクの移行に失敗した場合、どのディスクも宛先ストレージに移行されません。以下のコマンドを使用して失敗レポートを取得できます。
(Get-ProvTask -TaskID xxxxxxxxx).DiskMoveFailedVirtualMachines

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

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

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

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

制限事項

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

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

移行するには、次の手順を実行します。
  1. StudioまたはPowerShellコマンドを使用して、イメージ定義とイメージバージョンを作成します。イメージ定義とイメージバージョンを作成する手順については、以下を参照してください。
    • アジュール:
      • スタジオ
      • PowerShell
    • ヴイエムウェア：
      • スタジオ
      • PowerShell
  2. プロビジョニングスキームのUIDを取得するには、Get-ProvSchemeコマンドを実行します。例:
    Get-ProvScheme -ProvisioningSchemeName <name> | select ProvisioningSchemeName, ProvisioningSchemeUid
  3. イメージ定義名、イメージバージョン仕様のUIDを取得するには、Get-ProvImageVersionSpecコマンドを実行します。例:
    Get-ProvImageVersionSpec -ImageDifinitionName <name> -Filter {IsPrepared -eq $true} | select ImageDefinitionName ImageVersionSpecUId
  4. 既存のMCSプロビジョニング済みマシンカタログを準備済みイメージマシンカタログに移行するには、Set-ProvSchemeImageコマンドを実行します。例:
    Set-ProvSchemeImage -ProvisioningSchemeName [ProvisioningSchemeName] -ImageVersionSpecUid [ImageVersionSpecUid]
  5. カタログが移行されたことを確認するには、Get-ProvSchemeコマンドを実行します。例:
    Get-ProvScheme -ProvisioningSchemeName <name> | select ProvisioningSchemeName, ProvisioningSchemeUid, ImageVersionSpecUid

トラブルシューティング

  • Power State Unknownステータスのマシンについては、ガイダンスとしてCTX131267を参照してください。
  • 不明な電源状態を継続的に表示するVMを修正するには、How to fix VMs that continuously show an unknown power stateを参照してください。
  • Cloud Connectorが正常に動作していない場合、MCSプロビジョニング操作（カタログの更新など）に通常よりも時間がかかり、管理コンソールのパフォーマンスが著しく低下します。

次のステップ

特定のハイパーバイザーカタログの管理については、以下を参照してください。
  • AWSカタログの管理
  • Google Cloud Platformカタログの管理
  • Microsoft Azureカタログを管理する(/ja-jp/citrix-daas/install-configure/machine-catalogs-manage/manage-machine-catalog-azure.html)
  • Microsoft System Center Virtual Machine Managerカタログを管理する(/ja-jp/citrix-daas/install-configure/machine-catalogs-manage/manage-machine-catalog-mscvmm.html)
  • VMwareカタログを管理する(/ja-jp/citrix-daas/install-configure/machine-catalogs-manage/manage-machine-catalog-vmware.html)
  • XenServerカタログを管理する(/ja-jp/citrix-daas/install-configure/machine-catalogs-manage/manage-machine-catalog-xenserver.html)