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

自動構成のトラブルシューティングと追加情報

April 6, 2026
寄稿者: 
C C

重要:

自動構成でよく発生するエラーメッセージとそれに対応する解決策については、Knowledge Centerの記事 CTX277730 にある トラブルシューティングFAQ を参照してください。

自動構成ツールのエラー

自動構成ツール操作では、エラーが発生する場合があります。この場合、マシンカタログ、デリバリーグループ、グループポリシーなどのコンポーネントの処理中に障害が発生する可能性があります。OnErrorAction および継続パラメーターを使用すると、処理中にエラーを捕捉し、解決して、中断した箇所から再開できます。

デフォルトの OnErrorAction 値は StopCompEnd です。エラーが発生すると、ツールは現在のコンポーネントの処理を完了します。追加のコンポーネントは処理されず、エラーは下流の依存コンポーネントに伝播しません。エラーを解決した後、継続パラメーターを適用してコマンドレットを再実行できます。

OnErrorActionパラメーター

移行コマンドで OnErrorAction パラメーター値を定義して、コンポーネントの処理中にツールが検出したエラーにどのように応答するかを制御できます。

この表は、パラメーター値とその説明を示しています。

  • 値 説明
  • | — | — |
  • Continue すべてのコンポーネントを可能な限り多く処理しようとします。
  • Pause 処理の最後に一時停止し、続行または停止を促します。
  • StopCompEnd コンポーネントを可能な限り多く処理しようとします。コンポーネントの完了後に停止します。(デフォルト)
    StopImmediately エラーが検出されると処理が停止します。

移行コマンドレット

  • OnErrorAction パラメーターは、以下の移行コマンドに適用できます。

  • Compare-CvadAcToSite
  • Import-CvadAcToSite
  • Merge-CvadAcToSite
  • New-CvadAcToSite
  • Restore-CvadAcToSite

例: Merge-CvadAcToSite -OnErrorAction StopImmediately

再開パラメーター

これらのパラメーターは、エラーが原因で操作が一時停止または停止した後に、ツールがどのように再開するかを定義します。

  • 以下の OnErrorAction パラメーター値のいずれかを含む移行コマンドレットに、再開パラメーターを適用できます。

  • Pause
  • StopCompEnd

  • StopImmediately

  • この表は、パラメーター値とその説明を示しています。

  • 値 説明
  • | – | – |
  • -AllRemaining 開始コンポーネントが必要です。処理は開始コンポーネントから始まり、残りのすべてのコンポーネントを処理します。複数のコンポーネントが処理されます。
  • -Resume CurrentComponent.txt のコンポーネントを開始点として使用します。残りのすべてが true に設定されます。複数のコンポーネントが処理されます。
  • -Repeat CurrentComponent.txt のコンポーネントを開始点として使用します。残りのすべてが false に設定されます。1つのコンポーネントのみが処理されます。

最後に処理されたコンポーネントは、AutoConfigフォルダー内の CurrentComponent.txt ファイルに保存されます。このファイルの編集は推奨されません。 -Resume または -Repeat を指定し、CurrentComponent.txt が見つからないか無効な場合、処理は停止し、コンポーネントを選択するように求められます。

CustomerInfo.ymlファイルでのOnErrorActionの設定

OnErrorAction の値は CustomerInfo.yml ファイルでも設定できます。以下のコマンドレットを使用して値を設定します。

  • 新規ファイルの場合: New-CvadAcCustomerInfoFile -OnErrorAction Continue | Pause | StopCompEnd | StopImmediately
  • 既存ファイルの場合: Set-CvadAcCustomerInfoFile -OnErrorAction Continue | Pause | StopCompEnd | StopImmediately

ログ

いずれかのコマンドレットを実行すると、ログファイルが作成され、メインの履歴ログファイルにエントリが追加されます。すべての操作ログファイルはバックアップフォルダーに配置されます。すべてのログファイル名は CitrixLog で始まり、その後に自動構成操作とコマンドレット実行の日付とタイムスタンプが続きます。ログは自動削除されません。

メインの履歴ログは `%HOMEPATH%\Documents\Citrix\AutoConfig にある History.Log というファイルに保存されます。各コマンドレットの実行により、実行の日付、操作、結果、バックアップ、およびログファイルの場所を含むメインログエントリが生成されます。

New-CvadAcZipInfoForSupport コマンドレットを使用して、Citrixサポートに送信するためのログを収集することもできます。このコマンドレットは、すべてのログファイルと.ymlファイルを単一のzipファイルに圧縮します。顧客の機密情報 (CustomerInfo.yml および CvadAcSecurity.yml) はzipに含まれません。Icon.ymlファイルもそのサイズのため除外されます。zipファイルは %HOMEPATH%\Documents\Citrix\AutoConfig に配置され、日付とタイムスタンプに基づいて CvadAcSupport_yyyy_mm_dd_hh_mm_ss.zip という名前が付けられます。このzipファイルはバックアップとしても機能します。

各ログファイルには以下が含まれます。

  • 操作の名前とチェックモードが有効になっているかどうか
  • 開始日時と終了日時
  • 各コンポーネントのアクションと成功/失敗通知の複数のエントリ
  • 作成されたオブジェクトのさまざまな数を含む実行されたアクションの概要
  • 該当する場合の推奨される修正
  • 該当する場合のバックアップフォルダーの場所
  • メインログの場所
  • 期間

診断ファイル

診断ファイルは、問題の特定と解決に役立ちます。以下のファイルは、操作が実行されるときに作成されます。これらは %HOMEPATH%\Documents\Citrix\AutoConfig の下のアクション固有のサブフォルダーにあります。問題解決のサポート情報を提供する際には、これらのファイルを含めてください。

エクスポート

PoshSdk_yyyy_mm_dd_hh_mm_ss.ps1

このファイルは、サイト構成をファイルにエクスポートするために行われたすべてのBroker PowerShell SDK呼び出しをカウントします。

インポート、マージ、復元、同期、バックアップ、比較

Transaction_yyyy_mm_dd_hh_mm_ss.txt

このファイルは、各Rest API呼び出しと関連情報を記録します。

RestApiContent_yyyy_mm_dd_hh_mm_ss.txt

このファイルには、すべての Add、Update、および Delete のRest APIコンテンツが含まれています。

依存関係に起因する問題

  • インポートとマージは、依存関係の欠落が原因で失敗する場合があります。一般的な問題は次のとおりです。
  1. グループポリシーにデリバリーグループフィルターがありません。通常の原因は、インポートされていないデリバリーグループです。
  2. アプリケーションのインポートまたはマージに失敗します。通常の原因は、インポートされていないデリバリーグループまたはアプリケーショングループです。
  3. アプリケーショングループにRestrictToTagがありません。通常の原因は、インポートされていないタグです。
  4. ホスト接続に失敗します。通常の原因は、CvadAcSecurity.ymlファイルにセキュリティ情報が不足していることです。
  5. マシンカタログに失敗します。通常の原因は、インポートされていないホスト接続です。
  6. マシンカタログとデリバリーグループからマシンが欠落しています。通常の原因は、Active Directoryで見つからなかったマシンです。
  7. デリバリーグループからユーザーが欠落しています。通常の原因は、Active Directoryで見つからなかったユーザーです。

推奨事項

  • 自動構成の複数のインスタンスを同時に実行しないでください。複数のインスタンスを同時に実行すると、クラウドサイトで予測できない結果が生じます。この場合、自動構成の1つのインスタンスを再実行して、サイトを期待される状態に戻してください。
  • 自動構成の実行中にStudioで作業したりデータを変更したりしないでください。
  • クラウドサイトが期待どおりであることを確認するために、Studioでマージ、インポート、または復元の結果を常に視覚的に確認してください。

フォルダー

デフォルトのフォルダーのルート場所

すべての自動構成ツール操作は、ルートフォルダー内またはそのサブフォルダー内で実行されます。ルートフォルダーは %HOMEPATH%\Documents\Citrix\AutoConfig にあります。

エクスポート

エクスポートされたすべてのファイルは、使いやすさとエクスポート履歴を提供するために、2つのフォルダーの場所に配置されます。エクスポートは常にルートフォルダーに配置されます。コピーは、エクスポートの日付と時刻とともに Export という名前のサブフォルダーに配置されます。

ルートフォルダーには、常に最新のエクスポートされたオンプレミスサイト構成が含まれています。各 Export サブフォルダーには、指定された日時に行われたエクスポートが含まれており、エクスポートの履歴が保持されます。任意の Export サブフォルダーを使用して、クラウドサイトを構成できます。自動構成は、既存のエクスポートサブフォルダーを削除または変更しません。

インポート/マージ/同期/比較

インポート、マージ、比較の各操作は、常にルートフォルダーにあるファイルから取得されます。各操作によりサブフォルダーが作成され、ルートフォルダー内のファイルがコピーされるため、クラウドサイトの変更元ファイルの履歴が提供されます。

リストア

リストア操作は、既存のサブフォルダーを使用してクラウドサイトを構成します。ソースフォルダーは必須の-RestoreFolderパラメーターで指定されます。他のコマンドとは異なり、リストア操作は既存のサブフォルダーを使用するため、新しいサブフォルダーは作成されません。リストアフォルダーはルートフォルダーにすることもできますが、それでも-RestoreFolderパラメーターで指定する必要があります。

バックアップ

自動構成は、クラウドサイトの構成を初期化、更新、およびバックアップします。長期間使用すると、クラウドサイトでさまざまな構成が変更される可能性があります。長期的な使用を容易にし、履歴の変更を保持するために、自動構成は保存スキームを使用してこの変更履歴を保存し、以前の状態をリストアする方法を提供します。

クラウドサイトの構成バックアップは、常にバックアップの日付と時刻とともにBackupという名前のサブフォルダーに作成されます。自動構成は、既存のエクスポートサブフォルダーを削除または変更しません。

バックアップを使用して、特定のコンポーネントまたは構成全体をリストアできます。デリバリーグループとマシンカタログのコンポーネント全体をリストアするには、次のコマンドレットを使用します。

Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -DeliveryGroups -MachineCatalogs

注:

前述のコマンドレットのバックアップファイル情報は、独自のバックアップに基づいています。

クラウドサイトの構成全体をリストアするには、次のコマンドレットを使用します。

Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss

注:

前述のコマンドレットのバックアップファイル情報は、独自のバックアップに基づいています。

デフォルトのルートフォルダーの変更

エクスポート、インポート、マージ、同期、比較の各操作は、–AlternateFolderパラメーターを使用してデフォルトのルートフォルダーを変更できます。操作ごとのサブフォルダーの作成と管理は、前述のとおりです。

サブフォルダーにコピーされるファイル

以下のファイルを除き、”.yml”拡張子を持つすべてのファイルは操作サブフォルダーにコピーされます。

  • CustomerInfo.yml
  • ZoneMapping.yml
  • CvadAcSecurity.yml

自動フェールセーフクラウドサイトバックアップ

構成を変更する操作を実行する前に、現在のクラウドサイト構成のバックアップが作成されます。これには、インポート、マージ、同期、リストアの各パラメーターが含まれます。バックアップは常に、操作サブフォルダーの下のサブフォルダーにあります。

リストアの場合、バックアップフォルダーは-RestoreFolderパラメーターで指定されたフォルダーのサブフォルダーです。

自動化

自動構成ツールのコマンドレットは、プロンプトとコマンドレット完了時のログ結果の表示を抑制することで、管理者による介入なしに自動化スクリプトで実行できます。CustomerInfo.ymlファイルを使用して、同様のパラメーターを設定することもできます。

クラウドを変更するコマンドレットに次のパラメーターを追加して、プロンプトの表示を抑制します。

-Confirm $false

コマンドレットの完了時にログの表示を抑制するには、コマンドレットに次のパラメーターを追加します。

-DisplayLog $false

PowerShellコマンドウィンドウへのログ記録を抑制するには、コマンドレットに次のパラメーターを追加します。

-Quiet

別の方法として、次のパラメーターをCustomerInfo.ymlファイルに配置できます。

Confirm: False

DisplayLog: False

デリバリーコントローラー以外のPCからのエクスポート

自動構成ツールは、複数のCitrix PowerShell SDKを使用してオンプレミスサイト構成をファイルにエクスポートします。これらのSDKはデリバリーコントローラーに自動的にインストールされるため、追加のアクションなしでデリバリーコントローラーでツールを実行できます。デリバリーコントローラー以外のマシンで実行する場合は、ツールに必要なCitrix PowerShell SDKのセットをインストールする必要があります。このSDKセットはCitrix Studioの一部であり、Citrix Virtual Apps and Desktops™インストールメディアからインストールできます。

注:

自動構成はCloud Connectorでは実行できません。

Citrix Cloud™ GovernmentおよびJapan Control Planeへの移行

Citrix Cloud GovernmentおよびJapan Control Plane環境では、異なるアクセスポイントを使用して認証し、アクセストークンを割り当てます。この固有の要件は、クラウドにアクセスするすべての自動構成ツールに適用されます。これらの環境で自動構成を使用するには、次の手順を実行します。

  1. %HOMEPATH%\Documents\Citrix\AutoConfigフォルダーでCustomerInfo.ymlを編集します

  2. 接続する環境に応じて、次のいずれかの行をCustomerInfo.ymlに追加します（または、既に存在する場合は変更します）

    Environment: 'ProductionGov'

    または

    Environment: 'ProductionJP'

これらの環境で自動構成を使用できるようになりました。

Citrix Cloudのデータ収集

Citrix Cloudが収集する情報については、Citrix Cloud Services Customer Content and Log Handlingを参照してください。

その他のリソース

ディスカッションフォーラム

Citrix Discussion forum for Automated Configurationにアクセスしてください。

ビデオ

YouTubeでUnder the Hood of the Automated Configuration Tool for Citrix Virtual Apps and Desktopsをご覧ください。

トレーニング

Cloud Learning Centerには、この記事で説明されているタスクを含む、サービス展開を構築するためのステップバイステップのビデオガイドが含まれています。Migrating Citrix Virtual Apps and Desktops to Citrix Cloud Learning Pathを参照してください。

自動構成のトラブルシューティングと追加情報
April 6, 2026
寄稿者: 
C C
April 6, 2026
寄稿者: 
C C

この記事の概要

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