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

重要:

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

自動構成ツールのエラー

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

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

オンエラーアクション パラメーター

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

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

移行コマンドレット

次の移行コマンドに OnErrorAction パラメーターを適用できます。

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

例: Merge-CvadAcToSite -OnErrorAction StopImmediately

再開パラメーター

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

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

• Pause
• StopCompEnd
• StopImmediately

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

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

CustomerInfo.ymlファイルでのエラー時の動作の設定

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

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

ログ

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

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

サポートのためにCitrixに送信するログを収集するには、New-CvadAcZipInfoForSupportコマンドレットを使用することもできます。このコマンドレットは、すべてのログファイルと.ymlファイルを1つの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 サブフォルダーを使用してクラウドサイトを構成できます。自動構成は、既存のエクスポートサブフォルダーを削除または変更しません。

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

Import、Merge、およびCompareの各操作は、常にルートフォルダーにあるファイルから取得されます。各操作によりサブフォルダーが作成され、ルートフォルダー内のファイルがそこにコピーされるため、クラウドサイトのソースファイルの変更履歴が提供されます。

復元

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

バックアップ

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

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

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

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

注:

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

デフォルトのルートフォルダーを変更する

Export、Import、Merge、Sync、およびCompareの各操作は、–AlternateFolderパラメーターを使用してデフォルトのルートフォルダーを変更できます。操作ごとのサブフォルダーの作成と管理は、以前に説明したとおりです。

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

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

• 顧客情報.yml
• ゾーンマッピング.yml
• CvadAcSecurity.yml

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

現在のクラウドサイト構成のバックアップは、構成を変更する操作を実行する前に作成されます。これには、Import、Merge、Sync、およびRestoreパラメーターが含まれます。バックアップは常に、操作サブフォルダーの下のサブフォルダーに保存されます。

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

自動化

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

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

-Confirm $false

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

-DisplayLog $false

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

-Quiet

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

Confirm: False

DisplayLog: False

Delivery Controller™以外のコンピューターからのエクスポート

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

注：

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

Citrix Cloud™ ガバメントおよびJapan コントロールプレーンへの移行

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

1. In the %HOMEPATH%\Documents\Citrix\AutoConfig folder, edit CustomerInfo.yml.

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

   Environment: 'ProductionGov'

   または

   Environment: 'ProductionJP'

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

シトリックスクラウド データ収集

シトリックスクラウドが収集する情報の詳細については、シトリックスクラウドサービスのお客様のコンテンツおよびログの取り扱い を参照してください。

その他のリソース

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

Citrix 自動構成に関するディスカッションフォーラム にアクセスしてください。

ビデオ

ユーチューブでシトリックス バーチャル アプリケーションズ アンド デスクトップ用自動構成ツールの詳細 をご覧ください。

トレーニング

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