Citrix Virtual Apps and Desktops

マシンカタログの管理

注:

Web Studio(Webベース)とCitrix Studio(Windowsベース)の2つの管理コンソールを使用して、Citrix Virtual Apps and Desktopsの展開を管理できます。この記事ではWeb Studioのみを扱います。Citrix Studioについて詳しくは、Citrix Virtual Apps and Desktops 7 2212以前の同様の記事を参照してください。

はじめに

マシンカタログにマシンを追加したり、カタログからマシンを削除したり、マシンカタログの名前や説明を変更したりすることができます。また、カタログのActive Directoryコンピューターアカウントを管理できます。

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

  • Machine Creation Services(MCS)を使用して作成されたプール(ランダム)マシンが含まれるカタログは、カタログで使用されるマスターイメージを更新してからマシンを更新することにより、マシンを管理できます。この方法により、多数のユーザーマシンを効率的に更新することができます。
  • 静的で恒久的に割り当てられたマシンが含まれるカタログと、リモートPCアクセスマシンカタログの場合は、ユーザーのマシンに対する更新をWeb Studioの外で管理します。サードパーティ製のソフトウェア配信ツールを使用して、個々のデスクトップまたはデスクトップのグループを管理します。

ホストハイパーバイザーへの接続の作成と管理については、「接続とリソース」を参照してください。

注:

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

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

永続インスタンスまたは専用インスタンスを使用して作成されたMCSカタログを更新する場合、カタログで作成された新しいマシンは更新されたイメージを使用します。既存のインスタンスは引き続き元のインスタンスを使用します。他の種類のカタログでも、イメージの更新プロセスは同様です。以下に注意してください:

  • 永続ディスクカタログでは、既存のマシンは新しいイメージに更新されませんが、追加されたマシンは新しいイメージを使用します。
  • 永続ディスクカタログではない場合、次回のマシンのリセット後にマシンイメージが更新されます。
  • 永続マシンカタログでは、イメージを更新するとそのイメージを使用するカタログインスタンスも更新されます。
  • 永続的ではないカタログの場合、マシンごとに異なるイメージを使用するには、個別のカタログ内にイメージが存在する必要があります。

マシンカタログの管理

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

Web Studioを使用する

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

カタログの詳細の表示

  1. 検索機能を使用して、特定のマシンカタログを見つけます。手順については、「インスタンスの検索」を参照してください。
  2. 検索結果から必要に応じてカタログを選択します。
  3. カタログ列の説明については、次の表を参照してください。
  4. このカタログの詳細については、下部の詳細ペインのタブをクリックしてください。
説明
マシンカタログ

カタログ名と割り当ての種類。以下は割り当ての種類です:
  • ランダム:カタログ内のマシンはユーザーにランダムに割り当てられます。
  • 無期限:カタログ内のマシンはユーザーに無期限で割り当てられます。
  • マシンの種類




    カタログ内のマシンでサポートされているセッションの種類。設定可能な値は次のとおりです:
  • OSの種類:マルチセッションOS(仮想)。ユーザーデータ:破棄。
  • OSの種類:マルチセッションOS(仮想)。ユーザーデータ:ローカルディスク上
  • OSの種類:シングルセッションOS(リモートPCアクセス)
  • OSの種類:シングルセッションOS(仮想)。ユーザーデータ:破棄
  • OSの種類:シングルセッションOS(仮想)。ユーザーデータ:ローカルディスク上
  • マシンの数 カタログ内のマシン数とプロビジョニング方法。使用可能なプロビジョニング方法には、Machine Creation Services(MCSマシン)、手動、およびCitrix Provisioning Servicesが含まれます。
    割り当て済み(個) デリバリーグループに割り当てられたカタログ内のマシンの数。
    フォルダー マシンカタログツリー内のカタログの場所。カタログが含まれているフォルダーの名前(末尾のバックスラッシュを含む)、またはカタログがルートレベルにある場合は-が表示されます。
    VDAのアップグレード VDAのアップグレードの状態。設定可能な値には、未構成、スケジュール設定済み、使用可能、および、最新です、が含まれます。
    イメージの状態 カタログのイメージの更新状態。非永続マシンカタログにのみ適用されます。設定可能な値は次のとおりです:完全に更新されました、一部更新されました、更新保留中、準備中

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

    以下の点に注意してください:

    • 追加するマシンの数に応じて十分なプロセッサ、メモリ、ストレージが仮想化ホスト上にあることを確認してください。
    • 十分な数のActive Directoryコンピューターアカウントが使用可能であることを確認してください。既存のアカウントを使用している場合、使用可能なアカウントの数により、追加できるマシンの数が制限されることに注意してください。
    • 追加するマシン用にWeb StudioでActive Directoryコンピューターアカウントを作成する場合は、適切なドメイン管理者権限も必要です。

    マシンカタログにマシンを追加するには、以下の手順に従います:

    1. Web Studioにサインインします。
    2. 左側のペインで [マシンカタログ] を選択します。
    3. マシンカタログを選択し、操作バーの [マシンの追加] を選択します。
    4. 追加する仮想マシンの数を選択します。
    5. 追加する仮想マシンの数に対し、既存のActive Directoryアカウントの数が不足している場合は、作成するアカウントのドメインと場所を選択します。アカウント名前付けスキームを指定します。番号記号(#)により、名前に追加される連番または文字とその位置が定義されます。組織単位名にはスラッシュ(/)を使用しないでください。名前の先頭に番号記号を配置することはできません。たとえば、名前付けスキームとして「PC-Sales-##」を指定して[0~9]を選択すると、PC-Sales-01、PC-Sales-02、PC-Sales-03などのコンピューターアカウント名が作成されます。
    6. 既存のActive Directoryアカウントを使用する場合、アカウントを参照するか、[インポート] をクリックしてアカウント名の一覧のCSVファイルを指定します。追加するマシンに十分な数のアカウントをインポートする必要があります。Web Studioはこれらのアカウントを管理します。すべてのアカウントのパスワードのリセットをWeb Studioに許可するか、アカウントのパスワードを指定します(すべてのアカウントで同じパスワードを使用する必要があります)。

    マシンの作成はバックグラウンドプロセスとして実行され、多くのマシンを追加する場合には時間がかかることがあります。Web Studioを終了してもマシンの作成処理は続行されます。

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

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

    • マシン上に重要なユーザーデータがなく、データがある場合はバックアップ済みであること。
    • すべてのユーザーがログオフしていること。メンテナンスモードをオンにすると、マシンに新たに接続できなくなります。
    • マシンの電源がオフになっていること。

    カタログからマシンを削除するには、以下の手順に従います:

    1. Web Studioにサインインします。
    2. 左側のペインで [マシンカタログ] を選択します。
    3. マシンカタログを選択し、操作バーの [マシンの表示] を選択します。
    4. 1台または複数のマシンを選択し、操作バーの [削除] を選択します。

    マシンを削除するかどうかを選択します。マシンを削除する場合は、マシンのActive Directoryアカウントを残すか、無効にするか、削除するかを指定します。

    カタログの編集

    1. [説明] ページでは、カタログの説明を変更します。
    2. 左側のペインで [マシンカタログ] を選択します。
    3. マシンカタログを選択し、操作バーの [マシンカタログの編集] を選択します。
    4. [スコープ] ページで、スコープを変更します。
    5. カタログの種類によっては、他のページが表示される場合があります。

      Azure Resource Managerイメージを使用して作成されたカタログの場合、以下のページが表示されます。変更は、後でカタログに追加したマシンにのみ適用されることに注意してください。既存のマシンは変更されません。

      • [仮想マシン] ページで、マシンサイズと、マシンを作成するアベイラビリティゾーンを変更します。

        注:

        • カタログがサポートするマシンサイズのみが表示されます。
        • 必要に応じて、[ほかのマシンカタログで使用されるマシンサイズのみを表示する] を選択して、マシンサイズ一覧をフィルタリングします。
      • [マシンプロファイル] ページで、マシンプロファイルを使用するか変更するかを選択します。

      • (カタログが専用グループホストで構成されている場合のみ表示される)[専用ホストグループ] ページで、ホストグループを変更するかどうかを選択します。

      • [ストレージとライセンスの種類] ページで、ストレージの種類、ライセンスの種類、およびAzure Compute Gallery設定([準備されたイメージをAzure Compute Galleryに配置します] が使用中の場合のみ利用可能)を変更するかどうかを選択します。

      注:

      新しく選択した設定が現在のマシンサイズをサポートしていない場合、設定を変更するとマシンサイズ設定がリセットされることを通知する警告ダイアログボックスが表示されます。続行を選択すると、仮想マシンメニューの横に赤い点が表示され、新しいマシンサイズを選択するよう求められます。

      • [ライセンスの種類] ページで、WindowsライセンスまたはLinuxライセンス設定を変更するかどうかを選択します。

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

      • [電源管理] ページでは、電源管理設定の変更、および電源管理接続の選択を行います。
      • [組織単位] ページでは、Active Directory組織単位を追加または削除します。
    6. [適用] をクリックして変更を適用し、[保存] をクリックして終了します。

    カタログ名の変更

    1. Web Studioにサインインします。
    2. 左側のペインで [マシンカタログ] を選択します。
    3. マシンカタログを選択し、操作バーの [マシンカタログの名前を変更] を選択します。
    4. 新しい名前を入力します。

    別のゾーンへのカタログの移動

    展開に複数のゾーンがある場合、カタログをゾーン間で移動させることができます。

    カタログをそのカタログ内の仮想マシンが含まれるハイパーバイザー以外のゾーンに移動すると、パフォーマンスが低下する可能性があります。

    1. Web Studioにサインインします。
    2. 左側のペインで [マシンカタログ] を選択します。
    3. カタログを選択し、操作バーの [移動] を選択します。
    4. カタログの移動先ゾーンを選択します。

    カタログの削除

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

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

    カタログを削除するには、以下の手順に従います:

    1. Web Studioにサインインします。
    2. 左側のペインで [マシンカタログ] を選択します。
    3. マシンカタログを選択し、操作バーの [マシンカタログの削除] を選択します。
    4. カタログ内のマシンを削除するかを指定します。マシンを削除する場合は、マシンのActive Directoryコンピューターアカウントを残すか、無効にするか、削除するかを指定します。

    カタログにおけるActive Directoryコンピューターアカウントの管理

    マシンカタログのActive Directoryアカウントについて、次の操作を行えます:

    • シングルセッションOSカタログおよびマルチセッションOSカタログからActive Directoryコンピューターアカウントを削除して未使用のマシンアカウントを解放する。解放したアカウントは、ほかのマシンで使用可能になります。
    • カタログに追加するマシン用のコンピューターアカウントを追加しておく。組織単位名にはスラッシュ(/)を使用しないでください。

    Active Directoryアカウントを管理するには、以下の手順に従います:

    1. Web Studioにサインインします。
    2. 左側のペインで [マシンカタログ] を選択します。
    3. カタログを選択し、操作バーの [Active Directoryアカウント管理] を選択します。
    4. 必要に応じてコンピューターアカウントを追加または削除します。アカウントを追加する場合は、すべてのアカウントのパスワードをリセットするか、すべてのアカウントに適用されるパスワードを入力するかを選択します。

      アカウントの現在のパスワードがわからない場合は、すべてのアカウントのパスワードをリセットするオプションを選択します。パスワードをリセットするための権限が必要です。パスワードを指定する場合は、アカウントのインポート時にパスワードが変更されます。アカウントを削除する場合は、そのアカウントをActive Directory内で保持するか、無効にするか、または削除するかを選択します。

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

    カタログの更新

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

    マシンは、更新後に自動的に再起動されます。

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

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

    1. ハイパーバイザー上で、現在の仮想マシンのスナップショットを作成してわかりやすい名前を付けます。このスナップショットを使用して、カタログ内のマシンを元に戻す(ロールバックする)ことができます。
    2. 必要に応じて、マスターイメージをオンにしてログオンします。
    3. 更新をインストールするか、マスターイメージに対して必要な変更を加えます。
    4. 仮想マシンの電源を切ります。
    5. 仮想マシンのスナップショットを作成します。仮想マシンにわかりやすい名前を付けます。この名前は、Web Studioでのカタログの更新時に使用されます。Web Studioでスナップショットを作成することもできますが、ハイパーバイザー側の管理コンソールでスナップショットを作成します。このスナップショットをWeb Studioで選択します。これにより、スナップショットに自動生成される名前を付けるのではなく、わかりやすい名前と説明を指定できます。GPUマスターイメージの場合は、XenServerコンソールを使用してマスターイメージのみを変更できます。

    マスターイメージの変更

    更新を準備し、カタログ内のすべてのマシンにロールアウトするには、以下の手順に従います:

    1. Web Studioにサインインします。
    2. 左側のペインで [マシンカタログ] を選択します。
    3. カタログを選択し、操作バーの [マスターイメージの変更] を選択します。
    4. [イメージ] ページで、ホストおよびロールアウトするイメージを選択します。

      ヒント:

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

    5. [ロールアウト方法] ページで、マシンカタログ内のマシンを新しいマスターイメージによって更新するタイミング:次回シャットダウン時または即時を選択します。

      注:

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

    6. [概要] ページの情報を確認し、[完了] をクリックします。各マシンは、更新後に自動的に再起動されます。

    更新の進行状況を追跡するには、[マシンカタログ] でカタログを見つけて、インラインの進行状況バーと手順ごとの進行状況グラフを表示します。

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

    ロールアウト方法:

    次回のシャットダウン時にイメージを更新すると、現在使用されていないマシン、つまりアクティブなユーザーセッションのないマシンにも即座に反映されます。現在アクティブなセッションが終了すると、使用中のシステムも更新を受け取ります。以下に注意してください:

    • 新しいセッションは、該当するマシンで更新が完了するまで起動できません。
    • シングルセッションOSマシンでは、マシンが使用されていないとき、またはユーザーがログインしていないときに、即座にマシンが更新されます。
    • 子マシンがあるマルチセッションOSの場合、再起動は自動的に行われません。手動でシャットダウンし、再起動する必要があります。

    ヒント:

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

    PowerShellを使用して1回限りの再起動スケジュールを有効にするには、「 1回限りの再起動スケジュールを有効にする」を参照してください。

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

    更新後または新規のマスターイメージは、ロールアウトした後にロールバックすることができます。このプロセスは、新たに更新されたマシンで問題が発生した場合に必要になることがあります。ロールバックした場合、カタログ内のマシンは前回の動作イメージまでロールバックされます。より新しいイメージを必要とする新機能は、利用できなくなりました。ロールアウトと同様に、ロールバックでもマシンは再起動されます。

    1. Web Studioにサインインします。
    2. 左側のペインで [マシンカタログ] を選択します。
    3. カタログを選択し、操作バーの [マスターイメージのロールバック] を選択します。
    4. ロールアウト処理について前述したとおり、古いマスターイメージをマシンに適用するタイミングを指定します。

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

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

    機能レベルを変更するか変更を元に戻す

    マシン上のVDAを新しいバージョンにアップグレードした場合は、マシンカタログの機能レベルを変更する必要があります。すべてのVDAを最新バージョンにアップグレードして、最新の機能をすべて使用できるようにすることをCitrixではお勧めします。

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

    • アップグレードしたマシンを起動します。これにより、マシンがControllerに登録されます。このときに、そのマシンカタログ内のマシンについてアップグレードが必要かどうかがWeb Studioによりチェックされます。

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

    1. Web Studioにサインインします。
    2. 左側のペインで [マシンカタログ] を選択します。
    3. カタログを選択します。下ペインの [詳細] タブにバージョン情報が表示されます。
    4. [機能レベルの変更] を選択します。Web Studioによりアップグレードが必要なことが検出されると、メッセージが表示されます。画面の指示に従って操作します。アップグレードできないマシンがある場合は、その理由を説明するメッセージが示されます。すべてのマシンを適切に動作させるため、[変更] をクリックする前にマシンの問題を解決しておくことをCitrixではお勧めします。

    カタログを変更した後でマシンを以前のVDAバージョンに戻すには、カタログを選択し、操作バーで [機能レベルの変更を元に戻す] を選択します。

    カタログの複製

    カタログを複製する前に、次の考慮事項に注意してください:

    • オペレーティングシステムマシンの管理に関連する設定は変更できません。複製されたカタログは、元のカタログからこれらの設定を継承します。
    • カタログの複製は、完了するまでに時間がかかることがあります。必要に応じて [進行状況を隠す] を選択して、バックグラウンドで複製を実行します。
    • 複製されたカタログは元のカタログの名前を継承し、サフィックスとして「Copy」が付きます。この名前は変更できます。「カタログ名の変更」を参照してください。
    • 複製が完了したら、複製したカタログを必ずデリバリーグループに割り当ててください。
    1. Web Studioにサインインし、左側のペインで [マシンカタログ] をクリックします。
    2. カタログを選択し、操作バーの [複製] を選択します。
    3. [選択したマシンカタログの複製] ウィンドウで、複製されたカタログの設定を表示し、必要に応じて設定を構成します。[次へ] を選択して、次のページに進みます。
    4. [概要] ページで、設定の概要を表示し、[完了]を選択して複製を開始します。
    5. 必要に応じて [進行状況を隠す] を選択して、バックグラウンドで複製を実行します。

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

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

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

    始める前に、まずカタログを整理する方法を計画します。以下に注意してください:

    • 最大で5レベルまでの階層構造でフォルダーをネストできます(デフォルトのルートフォルダーを除く)。
    • カタログフォルダーには、カタログとサブフォルダーを含めることができます。
    • バックエンドのフォルダーツリーは、Web Studioのすべてのノード([マシンカタログ][アプリケーション] ノードなど)で共有されます。フォルダーの名前変更や移動時に他のノードと名前が競合しないように、異なるノードの第1レベルのフォルダーには異なる名前を付けることをお勧めします。

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

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

    ヒント:

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

    カタログの移動

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

    1. 左側のペインで [マシンカタログ] を選択します。
    2. フォルダーごとにカタログを表示します。フォルダー階層の上にある [すべて表示] をオンにして、一度にすべてのカタログを表示することもできます。
    3. カタログを右クリックし、[マシンカタログの移動]を選択します。
    4. カタログの移動先のフォルダーを選択し、[完了]をクリックします。

    ヒント:

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

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

    カタログフォルダーの削除、名前変更、および移動を行うことができます。

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

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

    1. 左側のペインで [マシンカタログ] を選択します。
    2. フォルダー階層でフォルダーを選択し、必要に応じて [アクション] バーでアクションを選択します:

      • フォルダーの名前を変更するには、[フォルダーの名前変更]を選択します。
      • フォルダーを削除するには、[フォルダーの削除]を選択します。
      • フォルダーを移動するには、[フォルダーの移動]を選択します。
    3. 画面の指示に従って、残りの手順を完了します。

    PowerShellの使用

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

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

    MCSカタログの問題を把握して修正するために、エラーと警告の履歴を取得することができます。

    PowerShellコマンドを使用すると、次のことができます:

    • エラーまたは警告の一覧を取得する
    • 警告ステータスをNew(新規) からAcknowledged(確認済み) に変更する
    • エラーまたは警告を削除する

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

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

    エラーと警告の一覧を取得するには:

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

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

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

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

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

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

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

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

    詳しくは、「Citrix PowerShell SDK」を参照してください。

    1回限りの再起動スケジュールを有効にする

    PowerShellを使用して1回限りの再起動スケジュールを有効にする場合は、以下のBrokerCatalogRebootScheduleのPowerShellコマンドを使用して、再起動スケジュールを作成、変更、および削除します:

    • Get-BrokerCatalogRebootSchedule
    • New-BrokerCatalogRebootSchedule
    • Set-BrokerCatalogRebootSchedule
    • Remove-BrokerCatalogRebootSchedule
    • Rename-BrokerCatalogRebootSchedule

    例:

    • BankTellersという名前のカタログ内のVMの再起動スケジュールを作成して、2022年2月3日の午前2時から午前4時の間に開始します。

       C:\PS> New-BrokerCatalogRebootSchedule -Name BankTellers -CatalogName BankTellers  -StartDate "2022-02-03" -StartTime "02:00" -Enabled $true -RebootDuration 120
       <!--NeedCopy-->
      
    • UID 17を持つカタログ内のVMの再起動スケジュールを作成して、2022年2月3日の午前1時から午前5時の間に開始します。再起動の10分前に、各VMは、すべてのユーザーセッションで「WARNING: Reboot pending(警告:再起動保留中)」というタイトルのメッセージボックスと、「Save your work(作業を保存してください)」というメッセージを表示するように設定されています。

       C:\PS> New-BrokerCatalogRebootSchedule -Name 'Update reboot' -CatalogUid 17 -StartDate "2022-02-03" -StartTime "01:00" -Enabled $true -RebootDuration 240 -WarningTitle "WARNING: Reboot pending" -WarningMessage "Save your work" -WarningDuration 10
       <!--NeedCopy-->
      
    • Old Nameという名前のカタログ再起動スケジュールをNew Nameという名前に変更します。

      C:\PS> Rename-BrokerCatalogRebootSchedule -Name "Old Name" -NewName "New Name"
      <!--NeedCopy-->
      
    • UID 1のすべてのカタログ再起動スケジュールを表示し、UID 1のカタログ再起動スケジュールの名前をNew Nameに変更します。

      C:\PS> Get-BrokerCatalogRebootSchedule -Uid 1 | Rename-BrokerCatalogRebootSchedule -NewName "New Name" -PassThru
      <!--NeedCopy-->
      
    • Accountingという名前のカタログ再起動スケジュールを設定して、各仮想マシンの再起動の10分前に「WARNING: Reboot pending(警告:再起動保留中)」というタイトルのメッセージと、「Save your work(作業を保存してください)」というメッセージを表示します。このメッセージは、そのVMのすべてのユーザーセッションに表示されます。

      ``` C:\PS> Set-BrokerCatalogRebootSchedule -Name Accounting -WarningMessage “Save your work” -WarningDuration 10 -WarningTitle “WARNING: Reboot pending”

    • 無効になっているすべての再起動スケジュールを表示し、有効にします。

       C:\PS> Get-BrokerCatalogRebootSchedule -Enabled $false | Set-BrokerCatalogRebootSchedule -Enabled $true
       <!--NeedCopy-->
      
    • UID 17でカタログ再起動スケジュールを設定して、「Rebooting in %m% minutes(あと%m%分で再起動)」というメッセージを表示します(各VMの再起動の15分、10分、5分前)。

       C:\PS> Set-BrokerCatalogRebootSchedule 17 -WarningMessage "Rebooting in %m% minutes." -WarningDuration 15 -WarningRepeatInterval 5
       <!--NeedCopy-->
      
    • MyCatalogという名前のカタログのタイムゾーンを構成します。

       C:\PS> Set-BrokerCatalog -Name "MyCatalog" -TimeZone <TimeZone>
       <!--NeedCopy-->
      

    イメージへの説明の追加

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

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

       C:\PS>New-ProvScheme -ProvisioningSchemeName <name> -HostingUnitName <name> -IdentityPoolName <name> -MasterImageVM
       XDHyp:\HostingUnits<hosting unit name><vm name>.vm\Base.snapshot -MasterImageNote "Note"
       <!--NeedCopy-->
      
    • マシンカタログに関連付けられているマスターイメージを更新するには、Publish-ProvMasterVMImageコマンドでMasterImageNoteパラメーターを使用します。例:

       C:\PS>Publish-ProvMasterVMImage -ProvisioningSchemeName <name> -MasterImageVM XDHyp:\HostingUnits<hosting unit name><vm name>.vm\base.snapshot -MasterImageNote "Note"
       <!--NeedCopy-->
      
    • 各イメージの情報を表示するには、Get-ProvSchemeMasterVMImageHistoryコマンドを使用します。例:

       C:\PS>Get-ProvSchemeMasterVMImageHistory -ProvisioningSchemeName MyScheme -Showall
       <!--NeedCopy-->
      

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

    次のような場合、ロールバックできません([マスターイメージのロール バック] オプションは表示されません)。

    • ロールバックする権限がない。
    • カタログがMCSを使用して作成されていない。
    • カタログが、OSディスクのイメージを使用して作成されている。
    • カタログの作成に使用されたスナップショットが破損した。
    • カタログ内のマシンに対してユーザーが行った変更が保持されない。
    • カタログ内のマシンが実行中である。

    OSディスクのリセット

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

    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
         <!--NeedCopy-->
        
      • Get-ProvVMコマンドからの出力としてVMの一覧を指定し、各VMでリセットを実行します:

         (Get-ProvVM -ProvisioningSchemeName "xxx") | Reset-ProvVMDisk "abc" -OS
         <!--NeedCopy-->
        
      • 単一のVMを名前で指定します:

         Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
         <!--NeedCopy-->
        
      • Get-ProvVMコマンドによって返されるVMごとに個別のリセットタスクを作成します。これは、VMごとのハイパーバイザー機能チェック、接続チェックなど、各タスクが同じ冗長チェックを実行するため、効率が低下します。

         Get-ProvVM -ProvisioningSchemeName "xxx" | Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -OS
         <!--NeedCopy-->
        
    4. リセットするVMを一覧表示する確認プロンプトと、回復不能な操作であるという警告メッセージが表示されます。回答を入力せずにEnterキーを押すと、それ以上のアクションは実行されません。

      注:

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

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

      次のいずれかの方法を使用して、確認プロンプトを回避することもできます:

      • -Forceパラメーターを指定します:

         Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Force
         <!--NeedCopy-->
        
      • -Confirm:$falseパラメーターを指定します:

         Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS -Confirm:$false
         <!--NeedCopy-->
        
      • Reset-ProvVMDiskを実行する前に、$ConfirmPreferenceNoneに変更します:

         PS C:\Windows\system32> $ConfirmPreference='None'
         PS C:\Windows\system32> $ConfirmPreference
         None
         PS C:\Windows\system32> Reset-ProvVMDisk -ProvisioningSchemeName "xxx" -VMName "abc" -OS
         <!--NeedCopy-->
        
    5. Reset-ProvVMDiskコマンドで返されたタスクのステータスを取得するには、Get-ProvTaskを実行します。

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

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

    注:

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

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

    1. PowerShellウィンドウで、コマンドasnp citrix*を実行してPowerShellモジュールをロードします。
    2. (Get-Provscheme -ProvisioningSchemeName "name").NetworkMapsを実行して、変更するネットワークパスにアクセスします。
    3. 新しいネットワーク設定に変数を割り当てます。例:

      $NewNetworkMap = @{"0"= "XDHYP:\HostingUnits\MyNetworks\Network 0.network"}
      <!--NeedCopy-->
      
    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
       <!--NeedCopy-->
      
    • マシンカタログの特定のバージョンの構成の詳細を表示する場合:

       Get-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 2
       <!--NeedCopy-->
      
    • マシンカタログに関連付けられているバージョンの合計数を確認する場合:

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

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

       Set-ProvScheme -ProvisioningSchemeName AzureCatalog -Version 2
       <!--NeedCopy-->
      
    • そのマシンカタログのVMで使用されていないバージョンを手動で削除する場合:

       Remove-ProvSchemeVersion -ProvisioningSchemeName AzureCatalog -Version 3
       <!--NeedCopy-->
      
    • マシンカタログで保持されるバージョンの最大数を設定する場合(デフォルトは99)。この設定はすべてのカタログに適用されます。たとえば、この場合、MCSでプロビジョニングされたすべてのカタログに対して最大15のバージョンが保持されます。

       Set-ProvServiceConfigurationData -Name "MaxProvSchemeVersions" -Value 15
       <!--NeedCopy-->
      

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

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

    非マシンプロファイルベースのマシンカタログをマシンプロファイルベースのマシンカタログに変換する

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

    注:

    既存のマシンプロファイルベースのマシンカタログを、非マシンプロファイルベースのマシンカタログに変更することはできません。

    これを行うには、以下の手順に従います:

    1. VMを使用し、マシンプロファイルを使用せずに、永続的または非永続的なマシンカタログを作成します。
    2. PowerShellウィンドウを開きます。
    3. Set-ProvSchemeコマンドを実行して、マシンプロファイルのプロパティ値をマシンカタログに追加された新しいVMに適用します。例:

      • Azureの場合:

         Set-ProvScheme = Set-ProvScheme -ProvisioningSchemeName xxxx -MachineProfile XDHyp:\HostingUnits<HostingUnitName>\machineprofile.folder<ResourceGroupName><TemplateSpecName><VersionName>
         <!--NeedCopy-->
        
      • AWSの場合:

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

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

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

    注:

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

    条件

    IDディスクを正常にリセットするには、次のことを確認してください:

    • VMをオフにしてメンテナンスモードに設定する
    • PowerShellコマンドにパラメーター「-OS」を含めない

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

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

    1. PowerShellウィンドウを開きます。
    2. asnp citrix*を実行し、Citrix固有のPowerShellモジュールをロードします。
    3. ID情報をリセットします。

      • マシンのパスワードと信頼キーのみをリセットするには、次のコマンドを次の順序で実行します:

         Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
         <!--NeedCopy-->
        

        コマンドで使用されるパラメーターの説明は次のとおりです:

        • IdentityAccountName:修復が必要なIDアカウントの名前。
        • PrivilegedUserName:IDプロバイダー(ADまたはAzureAD)に対する書き込み権限を持つユーザーアカウント。
        • PrivilegedUserPassword:PrivilegedUserNameのパスワード。
        • Target:修復作業のターゲット。これには、アカウントのパスワード/信頼キーを修復するためのIdentityInfo、およびHybrid AzureADに参加しているマシンのIDのユーザー証明書属性を修復するためのUserCertificateがあります。
         Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMname <name> -Identity -ResetIdentityInfo
         <!--NeedCopy-->
        

        ResetIdentityInfoパラメーターは以下をリセットします:

        • パスワードと信頼キー:VMがADドメインに参加している場合(DaaSドキュメントのみ)
        • 信頼キーのみ:VMがADドメインに参加していない場合(DaaSドキュメントのみ)
        • パスワードのみ:VMがADドメインに参加している場合(CVADオンプレミスドキュメントのみ)
      • IDディスクのすべての構成をリセットするには、次のコマンドを次の順序で実行します:

         Repair-AcctIdentity -IdentityAccountName TEST\VM1 -PrivilegedUserName TEST\admin1 -PrivilegedUserPassword $password -Target IdentityInfo
         <!--NeedCopy-->
        
         Reset-ProvVMDisk ProvisioningSchemeName <name> -VMName <name>  -Identity
         <!--NeedCopy-->
        
    4. y」と入力してアクションを確認します。-Forceパラメーターを使用して確認プロンプトをスキップすることもできます。例:

      Reset-ProvVMDisk -ProvisioningSchemeName <name> -VMName <name> -Identity -Force
      <!--NeedCopy-->
      
    5. Get-ProvVM -ProvisioningSchemeName <name -VMName <name>を実行して、更新されたIDディスク設定を確認します。IDディスクの属性(IdentityDiskIdなど)を更新する必要があります。StorageIdIdentityDiskIndexは変更しないでください。

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

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

    • WriteBackCacheMemorySize
    • WriteBackCacheDiskSize

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

    • GCPおよびMicrosoft Azure環境、および
    • MCSIOが有効になっている非永続カタログ

    要件

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

    • VDAの最新バージョン(2308以降)に更新します。
    • 既存のマシンカタログのパラメーターUseWriteBackCacheを有効にします。UseWriteBackCacheを有効にしてマシンカタログを作成するには、New-ProvSchemeを使用します。例:

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

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

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

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

    注:

    • 少なくとも1GBのキャッシュディスクストレージが必要であるため、WriteBackCacheDiskSizeの値は0より大きい必要があります。
    • WriteBackCacheMemorySizeの値は、マシンカタログのメモリサイズより小さくなければなりません。
    • これらの変更は、変更後にカタログに追加された新しいVMにのみ影響します。既存のVMはこれらの変更の影響を受けません。

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

    PowerShellコマンドレットを使用してVDAインストーラーの場所を指定すると、各VDAがCitrix Managed Azure CDNから新しいVDAインストーラーを取得できるようにするためのネットワーク規則を提供する手間が軽減されます。

    PowerShellコマンドレット

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

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

    前提条件

    • VDA 2311に含まれるVUSエージェントインストーラー
    • VDA Upgrade Agentをバージョン7.40.0.35以降にアップグレードします(VDAインストーラーバージョン2311以降を使用)
    • Virtual Apps and Desktops Remote PowerShell SDKバージョン7.40以降(2024年1月10日以降にリリース)

    ファイル共有権限を設定する方法

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

    • ドメイン参加ファイルの共有権限

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

      ドメインコンピューターに読み取りアクセスを許可することで、最小限の権限を設定できます。

      1. ネットワーク上でファイルを共有するユーザーを選択します。
      2. [共有の詳細設定] をクリックして、[ファイルとプリンターの共有] をオンにします。
    • ドメイン非参加ファイルの共有権限

      VDAマシンがドメイン非参加の場合、ローカルシステムアカウント(VUAはローカルシステムとして実行されます)は、ネットワーク共有にアクセスするときにANONYMOUS LOGONを使用します。

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

      注:

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

    ローカルファイル共有からVDAを更新する

    1. VDAインストーラーをダウンロードし、共有ファイルに格納します。

      注:

      仮想アップグレードサービスでは、現在のリリーストラックまたはLTSRトラックのいずれかを選択できます。

      例: マシンカタログが現在のリリース(2311)に設定されており、VDAバージョンが2305の場合、VDAをバージョン2311にアップグレードする必要があります。

      1. 当社Webサイトダウンロードページに移動します。
      2. 製品でCitrix Virtual Apps and Desktopsを選択します。
      3. Citrix Virtual Apps and Desktops 7 2311, All Editionsを選択します。
      4. 製品ISOに含まれており、個別に展開可能なパッケージも用意されているコンポーネントからVDAインストーラーを選択します。
    2. カタログの種類に基づいて、関連するVDAインストーラーを選択します。

      • カタログの種類がマルチセッションの場合は、マルチセッションOS VDAインストーラーをダウンロードします
      • カタログの種類がシングルセッションの場合は、シングルセッションOS VDAインストーラーをダウンロードします
      • カタログの種類がリモートPCアクセスの場合は、シングルセッションOSコアサービスVDAインストーラーをダウンロードします

    注:

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

    トラブルシューティング

    次の手順

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

    マシンカタログの管理