トラブルシューティング

体系的なアプローチ

1. 症状の特定: 問題を明確に定義します（例：プリンターが表示されない、ジョブが停止する、出力が間違っている、印刷が遅い）。
2. 範囲の特定: 影響を受けているユーザー（1人のユーザー、複数のユーザー、特定のアプリケーション）、関連するプリンター、および問題が発生しているVDAまたはクライアントデバイスを特定します。
3. 基本の確認: ネットワーク接続（VDAからプリントサーバー、クライアントからVDA）を確認し、プリンターがオンラインでCitrix®外で機能していることを確認し、クライアントからのローカル印刷をチェックします（リダイレクトの問題の場合）。
4. ポリシーの確認: Citrix Group Policy Modelingウィザードなどのツールを使用するか、VDAで適用されているポリシー設定を確認して、影響を受けるユーザー/セッションに適用されている関連するCitrixポリシー設定を調べます。ポリシー設定が意図どおりに構成されており、明らかな競合がないことを確認します。
5. ログの確認: VDA、クライアントデバイス、およびプリントサーバー（該当する場合）でWindowsイベントログ（アプリケーションログ、システムログ、PrintServiceログ）を確認します。有効になっている場合は、Citrix固有のログを確認します。3
6. コンポーネントのテスト: 問題を特定のコンポーネントに分離することを試みます。別のアプリケーションから印刷を試みたり、別のプリンターを試したり、汎用ドライバー（UPDやMicrosoft XPS Document Writerなど）でテストしたり、Print SpoolerおよびCitrix Print Managerサービスのステータスを確認したりします。
7. リソースの参照: 既知の問題と解決策については、製品ドキュメント、サポート記事、およびコミュニティフォーラムを活用します。

一般的な問題と解決策

• プリンターの自動作成の失敗 / セッションにプリンターが表示されない:
  • 考えられる原因: クライアントプリンターリダイレクトポリシーが無効になっている。クライアントプリンターの自動作成ポリシーが「なし」に設定されているか、誤ってフィルターされている。クライアントデバイスのプリントスプーラーの問題。Workspaceアプリの問題。クライアントとVDA間のネットワーク接続の問題。Citrix Print Manager Service (CpSvc.exe)がVDAで実行されていないかクラッシュしている。VDAに必要なプリンタードライバーがない（ネイティブドライバーが必要な場合）。Citrixポリシーがセッションに正しく適用されていない。
  • トラブルシューティングの手順:
    1. クライアントプリンターリダイレクトポリシーが「許可」されており、クライアントプリンターの自動作成がユーザー/セッションに対して正しく構成されていることを確認します。
    2. VDA で CpSvc.exe サービスの状態を確認します。必要に応じて再起動します。
    3. VDA とクライアントの両方で Windows Print Spooler サービスの状態を確認します。必要に応じて再起動します。
    4. 基本的なネットワーク接続を確認します。
    5. クライアントデバイスでローカル印刷をテストします。
    6. 互換性のある Workspace アプリのバージョンがインストールされていることを確認します。
    7. VDA のイベントログで、CpSvc またはプリンター作成に関連するエラーを確認します。
    8. VDA でポリシーの更新を強制します (gpupdate /force)。
    9. VDA に適用されているポリシーを確認し、期待される設定が存在することを確認します。
    10. ネイティブドライバーが必要な場合は、VDA にインストールされていることを確認します。
    11. VDA のローカル/グループポリシーで、RDS/ターミナルサーバーのプリンターリダイレクト設定を確認します。
    12. VDA レジストリ内の孤立したプリンターエントリを検索してクリーンアップします。
• Print Spooler のクラッシュ / サービス応答なし (VDA またはプリントサーバー上):
  • 考えられる原因: 欠陥のある、または互換性のないプリンタードライバー (多くの場合サードパーティ製); キュー内の破損した印刷ジョブ; ドライバーの競合; システムリソースの不足。
  • トラブルシューティングの手順:
    1. Windows イベントログ (アプリケーションログにスプーラーのクラッシュがよく表示されます) を使用して、障害のあるプロセス/モジュールを特定します。
    2. Print Spoolerサービス」の再起動を試行します。
    3. 再起動に失敗した場合、または問題が再発する場合は、手動で印刷キューをクリアしてみてください（Spoolerサービスを停止し、C:\Windows\System32\spool\PRINTERS内のファイルを削除し、Spoolerサービスを開始します）。
    4. 問題のあるプリンタードライバーを特定して削除します。完全に削除するには、レジストリの編集が必要になる場合があります。
    5. Citrix UPDまたは汎用Microsoftドライバーでテストします。
    6. レジストリ内の孤立したプリントプロセッサを確認し、クリーンアップします。
• ポリシーの競合 / 設定の無視:
  • 考えられる原因: GPO設定がCitrixポリシーを上書きしている。Citrixポリシーの優先順位またはフィルターが競合している。ポリシー処理中にエラーが発生している。
  • トラブルシューティングの手順:
    1. Citrixグループポリシーモデリングウィザードを使用して、影響を受けるユーザー/VDAに対するポリシー適用をシミュレートします。
    2. ポリシーフィルター（ユーザーグループ、クライアントIPなど）が正しいことを確認します。
    3. Studio/Web Studioでポリシーの優先順位を確認します。
    4. Citrixポリシーの問題を特定するために、VDAのOUでGPOの継承を一時的にブロックします。
    5. VDA上のポリシー処理結果を調べます（例: gpresult /h report.htmlを使用）。
    6. ユーザー/VDAに適用されるポリシーセットを簡素化し、競合を見つけるためにポリシーを段階的に追加し直します。
• ドライバーの問題（全般 - 互換性、破損、マッピング）:
  • 考えられる原因: ドライバーがVDA OSまたはCitrixバージョンと互換性がない。ドライバーのインストールが破損している。ポリシーで必要なドライバーがVDAにない。複数のドライバー間の競合。プリンタードライバーマッピングポリシーの設定が正しくない。
  • トラブルシューティングの手順:
    1. Citrix UPDを使用して印刷を試す（ユニバーサルプリントドライバー使用ポリシーを設定する）。
    2. 適用されているポリシーに基づいて、正しいドライバー（ネイティブまたはUPD）が選択されていることを確認する。
    3. 必要なネイティブドライバーがVDAに正しくインストールされていることを確認する（使用する場合）。
    4. CVADおよびVDA OSバージョンとのドライバーの互換性について、ベンダーのドキュメントを確認する。
    5. 問題のあるドライバーをクリーン再インストールする（アンインストール、再起動、インストール）。
    6. プリンタードライバーマッピングポリシーのルールを慎重に確認し、テストする。
    7. VDAにインストールされているドライバーの数を最小限に抑える。
• 印刷速度の低下 / パフォーマンスの問題:
  • 考えられる原因: ネットワークの混雑または高遅延（特にWAN）。大規模で複雑な印刷ジョブ（例：高解像度グラフィック）。非効率なプリンタードライバー。印刷最適化（圧縮、キャッシュ）が無効になっているか、誤って設定されている。非効率なルーティング（例：低速WAN経由の直接接続）。
  • トラブルシューティングの手順:
    1. VDA、クライアント、プリントサーバー間のネットワークパスとパフォーマンスを分析する。
    2. 印刷用のCitrix帯域幅制限ポリシーを設定する。
    3. ユニバーサル印刷ポリシーを介して、UPD最適化（画像圧縮、フォント/画像キャッシュ）を有効にして設定する。
    4. WANリンクの場合、「印刷サーバーへの直接接続」ポリシーを無効にして、圧縮されたICA®チャネル経由でトラフィックを強制します。
    5. UPSを使用している場合は、ネットワーク用に最適に構成されていることを確認してください。
    6. 印刷ジョブ自体を分析し、可能であれば解像度または複雑さを軽減します。
    7. 別のドライバー（例：UPDとネイティブ）でテストします。
• 出力の誤り（文字の欠落、書式設定エラー、向きの誤り）：
  • 考えられる原因： ドキュメント/アプリケーションに必要なVDA上のフォントの欠落。不適切なフォント置換。プリンタードライバーの非互換性。特定のUPD形式（例：EMFとXPS）に関する問題。アプリケーションのバグ。ローカルクライアントプリンターで有効になっている高度な印刷機能との競合。
  • トラブルシューティングの手順:
    1. 必要なすべてのフォントがVDAにインストールされていることを確認します。
    2. ユニバーサルドライバーの優先ポリシーの順序を変更してみてください（例：EMFの前にXPSを試す）。
    3. 別のアプリケーションから同じドキュメントを印刷してテストします。
    4. 別の物理プリンターまたは仮想プリンター（例：Microsoft XPS Document Writer）に印刷してテストします。
    5. 別のプリンタードライバー（UPDとネイティブ、または異なるネイティブバージョン）を使用してみてください。
    6. アプリケーションの印刷設定とページ設定を確認します。
    7. クライアントデバイスのローカルプリンターのプロパティで「詳細な印刷機能」を無効にします。
    8. ユーザー設定とポリシーで印刷の向きの設定を確認します。
• シトリックス プリントマネージャーサービス (CpSvc.exe) のクラッシュ/ハング:
  • 考えられる原因: 応答しないプリンタードライバーがレジストリに孤立したオブジェクトを残している。印刷に関連するCitrixポリシーデータが破損している。システムリソースの競合。
  • トラブルシューティングの手順:
    1. VDAレジストリから孤立したプリンターおよび印刷プロセッサーのエントリをクリーンアップする手順に従ってください。まず、Print SpoolerサービスとCpSvcサービスを停止する必要があります。
    2. 問題のあるプリンタードライバーを特定して削除します。
    3. VDA上のCitrixポリシーキャッシュフォルダー/レジストリキーをクリーンアップし、ポリシーの強制更新を検討してください。
    4. VDAのリソース使用量 (CPU、メモリ) を監視します。
    5. CpSvcサービスとPrint Spoolerサービスを再起動します。
• PDFプリンターの問題:
  • 考えられる原因: PDFユニバーサルプリンターの自動作成ポリシーが無効になっている。互換性のないVDAまたはWorkspaceアプリのバージョン。クライアントエンドポイントにPDFビューアーがインストールされていない。サポートされていないブラウザーが使用されている (例: Edge)、またはHTML5構成エラー (CSPヘッダー、config.js)。
  • トラブルシューティングの手順:
    1. PDFユニバーサルプリンターの自動作成ポリシーが有効になっており、適用されていることを確認します。
    2. VDAとWorkspaceアプリが最小バージョン要件を満たしていることを確認します。
    3. サポートされているPDFビューアー (例: Adobe Reader、Chrome) がクライアントにインストールされ、デフォルトとして設定されていることを確認します。
    4. HTML5 Workspaceアプリを使用している場合は、ブラウザーの互換性を確認し、configuration.jsおよびCSPヘッダーの設定を確認します。
    5. ポリシー変更後にCitrixセッションを再起動します。

基本的なエンドユーザーのトラブルシューティング

• HDX™セッションから完全にログオフし、再度ログインします。
• エンドポイントデバイス上のローカルプリンターのステータスを確認します（オンラインであること、一時停止されていないこと、エラーがないことを確認します）。
• ローカルエンドポイントデバイスを再起動します。