製品ドキュメント
シトリックスクラウド™
PDFを表示

クラウドコネクタのインストール

August 3, 2026
寄稿者: 
C C

Cloud Connector ソフトウェアは、対話形式またはコマンドラインを使用してインストールできます。

インストールは、インストールを開始したユーザーの権限で実行されます。Cloud Connector がクラウドにアクセスする必要があるのは、次の目的のためです。

  • インストールを実行するユーザーを認証するため
  • インストーラーの権限を検証するため
  • Cloud Connector サービスをダウンロードして構成するため

インストール前に確認する情報

インストール前にシステム要件を確認してください。

展開後のガイダンス

インストール後、Citrix Cloud への常時接続を確保するため、すべての Cloud Connector の電源を継続的にオンにしておいてください。

アップグレード

アップグレードは通常、Citrix Cloud によって自動的に管理されます。手動でアップグレードするには、新しいバージョンをインストールする前に、古い Cloud Connector をアンインストールしてください。以前にインストールした Cloud Connector を新しいバージョンでアップグレードしないでください。Cloud Connector の個々のコンポーネントを個別にアップグレードしないでください。

マシンの名前変更

インストール後、Cloud Connector をホストしているマシンの名前を変更しないでください。後でサーバー名を変更する必要がある場合は、次のタスクを実行してください。

  1. リソースの場所からマシンを削除する:
    1. Citrix Cloudメニューから、リソースの場所を選択します。
    2. 管理するリソースの場所を見つけて、Cloud Connectorsタイルを選択します。
    3. 管理するマシンを見つけて、省略記号メニューをクリックします。コネクタの削除を選択します。
  2. Cloud Connectorソフトウェアをアンインストールします。
  3. マシンの名前を変更します。
  4. この記事で説明されているように、Cloud Connectorソフトウェアの最新バージョンをインストールします。

マシンを別のドメインに移動する

インストール後、Cloud Connectorをホストしているマシンを別のドメインに移動しないでください。後でマシンを別のドメインに参加させる必要がある場合は、次のタスクを実行します。

  1. リソースの場所からマシンを削除します。
  2. Cloud Connectorソフトウェアをアンインストールします。
  3. マシンを現在のドメインから切断し、新しいドメインに再参加させます。
  4. この記事で説明されているように、Cloud Connectorソフトウェアの最新バージョンをインストールします。

クローンされたマシンに関する考慮事項

Citrix Cloudがリソースの場所にあるマシンと確実に通信できるように、Cloud Connectorをホストする各マシンには一意のSIDとコネクタIDが必要です。リソースの場所にある複数のマシンでCloud Connectorをホストし、クローンされたマシンを使用する場合は、次の手順を実行します。

  1. 環境の要件に従ってマシンのテンプレートを準備します。
  2. Cloud Connectorとして使用する予定のマシン数をプロビジョニングします。
  3. 各マシンに、手動で、またはサイレントインストールモードを使用してCloud Connectorをインストールします。

マシンテンプレートにCloud Connectorをインストールすること（クローン作成前）はサポートされていません。Cloud Connectorがインストールされたマシンをクローンした場合、Cloud Connectorサービスは実行されず、マシンはCitrix Cloudに接続できません。

サービスに関する考慮事項

この記事のインストール手順では、使用されるサービスに関係なく、Cloud Connectorを展開するプロセスについて説明します。

Citrix DaaS向けにCloud Connectorを展開する場合、コネクタが存在するADドメインがアクティブであり、Citrix Cloudコンソールで「未使用」と表示されていないことを確認してください。Citrix DaaSでマシンカタログのセットアップ中に未使用のドメインを指定すると、エラーが発生する可能性があります。詳細については、Citrix DaaS製品ドキュメントのCitrix Cloudでリソースの種類を追加するか、未使用のドメインをアクティブ化するを参照してください。

他のサービスに関する追加の考慮事項については、そのサービスのドキュメントを参照してください。

デフォルトのリソースの場所

Citrix Cloudアカウントにリソースの場所がなく、ドメインにCloud Connectorをインストールすると、Citrix Cloudが作成するリソースの場所がデフォルトのリソースの場所になります。アカウントにはデフォルトのリソースの場所を1つしか設定できません。必要に応じて、Citrix Cloudで追加のリソースの場所を作成し、他のドメインにCloud Connectorをインストールするときに目的の場所を選択できます。

または、ドメインにCloud Connectorをインストールする前に、コンソールで必要なリソースの場所を最初に作成することもできます。Cloud Connectorインストーラーは、インストール中に目的のリソースの場所を選択するように求めます。

対話型インストール

グラフィカルインストーラーインターフェイスを使用してCloud Connectorをダウンロードしてインストールできます。これを行う前に、Cloud Connectorを展開するために、Citrix Cloud管理コンソールで1つ以上のリソースの場所を作成する必要があります。リソースの場所の詳細については、リソースの場所を参照してください。

Citrix Cloud Connector™ソフトウェアをダウンロードする

  1. Citrix Cloud Connectorをインストールする予定のマシンにWindows管理者としてサインインします。

  2. https://citrix.cloud.comにアクセスし、管理者アカウントにサインインします。

  3. Citrix Cloudコンソールで、メインメニューからリソースの場所に移動します。

  4. リソースの場所がまだない場合は、プラスアイコン（+）をクリックするか、リソースの場所の追加を選択します。詳細については、リソースの場所を作成するを参照してください。

  5. 管理したいリソースの場所を見つけて、+ Cloud Connectorsを選択します。

    コネクタのない新しいリソースの場所

  6. 開いたウィンドウでダウンロードを選択します。cwcconnector.exeファイルをコネクタマシンのローカルファイル場所に保存します。

    クラウドコネクタを追加するウィンドウ

Citrix Cloud Connectorソフトウェアをインストールする

前提条件

  1. cwcconnector.exeインストーラーファイルを右クリックし、管理者として実行を選択します。インストーラーは、Cloud Connectorをインストールする前にCitrix Cloudに接続できることを確認するための初期接続チェックを実行します。

  2. 管理をクリックしてプロキシサーバーを更新します。

クラウドコネクタをインストール

注：

Microsoft WinHTTPの制限により、サポートされるプロキシサーバーは1つだけです。詳細については、WinHTTPのAutoProxyに関する問題を参照してください。

  1. 詳細接続チェックをクリックして詳細なチェックを実行し、コネクタのインストールに必要な基本的な接続要件がマシンで満たされていることを確認します。

    詳細接続チェック

初回アップグレードとテスト

  1. プロキシサーバーを更新し、高度な接続チェックを確認した後、Cloud Connectorのインストールをクリックします。

  2. サインインページで、サインインしてインストールをクリックします。

    クラウドコネクタのログイン(/ja-jp/citrix-cloud/media/cloud-connector-login.png)

  3. Citrix Cloud接続テストウィンドウが表示され、初回アップグレードとテストのステータスがイベントログとともに表示されます。

    進行中の初期テスト(/ja-jp/citrix-cloud/media/initial-tests-in-progress.png)

  4. ログの表示をクリックして、すべての接続チェックデバッグログを含むディレクトリ(C:\ProgramData\Citrix\WorkspaceCloud\InstallLogs)を開きます。

  5. 初回アップグレードとテストが完了すると、次の画像に示すように、Citrix Cloud接続テストが成功したことが表示されます。接続チェックの結果は、最初のアップグレード後にイベントログボックスに表示されます。

    初期テスト完了(/ja-jp/citrix-cloud/media/initial-tests-complete.png)

未使用のドメインをアクティブ化する

リソースの場所を作成し、Citrix DaaS™ 用にCloud Connectorを展開する場合は、Citrix DaaSで使用しているADドメインがアクティブであり、未使用と見なされていないことを確認してください。Citrix DaaSでマシンカタログを設定する際に未使用のドメインを指定すると、エラーが発生する可能性があります。

詳細については、Citrix DaaS製品ドキュメントのCitrix Cloudでリソースタイプを追加するか、未使用のドメインをアクティブ化するを参照してください。

追加のリソースの場所を作成する

  1. Citrix Cloud管理コンソールから、メニューボタンをクリックし、リソースの場所を選択します。
  2. + リソースの場所をクリックし、意味のある名前を入力します。
  3. 「保存」をクリックします。Citrix Cloudに新しいリソースロケーションのタイルが表示されます。
  4. 「Cloud Connectors」をクリックし、次に「ダウンロード」をクリックしてCloud Connectorソフトウェアを入手します。
  5. 準備された各マシンに、インストールウィザードまたはコマンドラインインストールを使用してCloud Connectorソフトウェアをインストールします。Citrix Cloudは、Cloud Connectorに関連付けるリソースロケーションを選択するよう求めます。

複数の顧客と既存のリソースロケーションでのインストール

複数の顧客アカウントの管理者である場合、Citrix Cloudは、Cloud Connectorに関連付ける顧客アカウントを選択するよう求めます。

顧客アカウントにすでに複数のリソースロケーションがある場合、Citrix Cloudは、Cloud Connectorに関連付けるリソースロケーションを選択するよう求めます。

コマンドラインインストール

サイレントインストールまたは自動インストールがサポートされています。ただし、コネクタインストーラーは定期的に更新されるため、インストールごとに最新のインストーラーをダウンロードすることをお勧めします。Citrix Cloudコンソールの「リソースロケーション」ページから新しいCloud Connectorインストーラーをダウンロードします。

必要条件

Citrix Cloudでコマンドラインインストールを使用するには、以下の情報を提供する必要があります。

  • クラウドコネクタをインストールするシトリックスクラウドアカウントの顧客ID。このIDは、IDおよびアクセス管理のAPIアクセスタブの最上部に表示されます。
  • Cloud Connectorのインストールに使用するセキュアプリンシパルのIDとシークレット。これらの値を取得するには、まずセキュアプリンシパルを作成する必要があります。セキュアプリンシパルは「Full Access」で作成する必要があります。サービスプリンシパルの作成の詳細については、サービスプリンシパルの作成を参照してください。セキュアプリンシパルのIDとシークレットを取得したら、Cloud Connectorのインストールを続行できます。
  • Cloud Connectorに関連付けるリソースロケーションのリソースロケーションID。この値を取得するには、リソースロケーションページの「リソースロケーション名」の下にあるIDボタンを選択します。この値を指定しない場合、Citrix CloudはデフォルトのリソースロケーションのIDを使用します。

サポートされているパラメーター

セキュアプリンシパルのIDとシークレットのセキュリティを確保するため、JSON構成ファイルをインストーラーに提供する必要があります。このファイルは、インストールが完了した後に削除する必要があります。構成ファイルのサポートされている値は次のとおりです。

  • customerName 必須。Citrix Cloud コンソール（[ID およびアクセス管理] 内）の [API アクセス] ページに表示される顧客 ID。
  • clientId 必須。管理者が作成できるセキュアプリンシパル ID で、[API アクセス] ページにあります。
  • clientSecret 必須。セキュアプリンシパル作成後にダウンロードできるセキュアプリンシパルシークレット。[API アクセス] ページにあります。
  • resourceLocationId 推奨。既存のリソースロケーションの一意の識別子。Citrix Cloud コンソールの [リソースロケーション] ページで [ID] ボタンを選択して、リソースロケーション ID を取得します。値が指定されていない場合、Citrix Cloud はアカウント内の最初のリソースロケーションの ID を使用します。
  • acceptTermsOfService は必須です。trueに設定する必要があります。

構成ファイルの例 

{
"customerName": "CustomerID",
"clientId": "SecurePrincipalID",
"clientSecret": "ClientSecret",
"resourceLocationId": "ResourceLocationId",
"acceptTermsOfService": "true"
}
<!--NeedCopy-->

コマンドの例

次のコマンドは、JSON 構成ファイルを使用して Cloud Connector ソフトウェアをサイレントインストールします。

CWCConnector.exe /q /ParametersFilePath:c:\cwcconnector_install_params.json
<!--NeedCopy-->

サイレントインストールを指定するには、/q を使用します。

失敗した場合に潜在的なエラーコードを調べるには、Start /Wait CWCConnector.exe /ParametersFilePath:value を使用します。インストール完了後に echo %ErrorLevel% を実行する標準的なメカニズムを使用できます。

HTTPS Configuration

StoreFront™ および NetScaler Gateway アプライアンスが Cloud Connector に安全に接続し、すべてのデータを暗号化できるようにするには、HTTPS を有効にすることを強くお勧めします。これには SSL 証明書が必要です。

  • 証明書には、コネクタに到達するために使用される FQDN を共通名またはサブジェクトの別名として含める必要があります。コネクタの前にロードバランサーをデプロイしている場合は、ロードバランサーの FQDN を使用します。
  • 証明書は、エンタープライズ CA またはパブリック CA によって署名できます。
  • Cloud Connector に接続するすべての StoreFront およびゲートウェイサーバーは、証明書を信頼する必要があります。

HTTPSを有効にするには：

  1. 証明書MMCスナップインを開きます。

  2. 個人証明書ストアに適切な証明書を作成またはインポートします。証明書の管理の詳細については、証明書の管理を参照してください。

  3. 証明書を開き、詳細タブに移動して、スペースを無視して拇印をメモします。

    証明書の詳細のスクリーンショット

  4. 証明書をバインドするIPアドレスを決定します。通常、すべてのIPv4アドレスに適用するには0.0.0.0のIPアドレスを使用できます。IPv6が有効な場合は、すべてのIPv6アドレスに適用するには[::]を使用します。特定のネットワークアダプターにのみ変更を適用したい場合は、そのネットワークアダプターのIPアドレスをメモしてください。

  5. 管理者として実行したコマンドプロンプトで、以下を実行します

    netsh http add sslcert ipport=<IP address>:<Port number> certhash=<Certificate Hash Number> appid={Any GUID}
<!--NeedCopy-->

    AppIdには任意の有効なGUIDを使用できます。その目的は、どのアプリケーションがバインディングを追加したかを記録することです。ただし、バインディングはそのポートを使用するすべてのアプリケーションに適用されます。

    例えば、次のようになります。

    C:\> netsh http add sslcert ipport=0.0.0.0:443 certhash=BC96F958848639FD101A793B87915D5F2829B0B6 appid={6DE9BEFD-F4CB-4D63-8681-E88012D6F5F1}

SSL Certificate successfully added
<!--NeedCopy-->

  6. HTTPを無効にするには、レジストリでHKEY_LOCAL_MACHINE\SOFTWARE\Citrix\DesktopServerに移動し、名前がXMLServicesEnableNonSSLで値が0のDWORDを作成します。

次のステップ

  1. Citrix Cloud Connectorの更新スケジュールを設定します。Citrix Cloud Connectorの更新と更新スケジュールの管理については、コネクタの更新を参照してください。
  2. StoreFrontを使用している場合は、コネクタを使用してDaaSにアクセスし、リソースを列挙して起動できるようにStoreFrontを構成します。これが新しいDaaS展開における最初のコネクタである場合は、新しいリソースフィードを作成します。追加のコネクタである場合は、回復性を高めるために、既存のDaaSリソースフィードのサーバーリストにすべてのCloud Connectorを追加することをお勧めします。詳細については、ストアで利用可能になったリソースの管理を参照してください。
  3. NetScaler Gateway と組み合わせて StoreFront を利用している場合、コネクタを使用して Citrix Cloud Secure Ticket Authority (STA) に接続できます。詳細については、Citrix Gateway の構成を参照してください。
  4. 特定のActive Directoryドメインでこれが最初のコネクタである場合は、そのドメインをCitrix Cloudに接続できます。詳細については、Active DirectoryをCitrix Cloudに接続するにはを参照してください。

インストールに関する問題のトラブルシューティング

このセクションでは、インストール中に発生する可能性のある問題を診断し、修正する方法について詳しく説明します。インストールに関する問題のトラブルシューティングの詳細については、「Citrix Cloud Connectorトラブルシューティングガイド」を参照してください。

インストールログ

インストール中に発生した問題は、まず利用可能なログファイルを参照することでトラブルシューティングできます。

インストール中に発生したイベントは、Windows イベントビューアーで確認できます。クラウドコネクタのインストールログも確認でき、ログは%LOCALAPPDATA%\Temp\CitrixLogs\CloudServicesSetup にあります。 インストール後、ログは%ProgramData%\Citrix\WorkspaceCloud\InstallLogs にも追加されます。

終了コード

インストールプロセスの成功または失敗に応じて、次の終了コードが返される場合があります。

  • 1603 - 予期しないエラーが発生しました
  • 2 - 前提条件チェックに失敗しました
  • 0 - インストールが正常に完了しました

インストールエラー

Citrix Cloud Connectorソフトウェアをインストーラーをダブルクリックしてインストールすると、次のエラーメッセージが表示されることがあります。

Can't reach this page.

このエラーは、Citrix Cloud Connectorをインストールするために管理者としてマシンにログインしている場合でも発生する可能性があります。このエラーを回避するには、インストーラーを右クリックして「管理者として実行」を選択し、Citrix Cloud Connectorソフトウェアを管理者として実行します。

接続に関する問題

Cloud Connector が Citrix Cloud と通信できることを確認するには、次の Citrix サービスが 開始済み 状態であることを確認してください。

  • シトリックスクラウド AD プロバイダー
  • シトリックスクラウド エージェント ロガー
  • シトリックスクラウド エージェント システム
  • シトリックスクラウド エージェント ウォッチドッグ
  • シトリックスクラウド クレデンシャル プロバイダー
  • シトリックス コンフィグ シンクロナイザー サービス
  • シトリックス ハイアベイラビリティ サービス
  • シトリックス ネットスケーラー® クラウドゲートウェイ
  • シトリックス リモート ブローカー プロバイダー
  • シトリックス リモート HCL サーバー
  • シトリックス セッションマネージャー プロキシ

これらのサービスの詳細については、「インストールされているサービス」を参照してください。

クラウドコネクタ高度接続チェックツールは、クラウドコネクタが Citrix Cloud およびその関連サービスに到達できることを確認するのに役立ちます。

詳細については、クラウドコネクタ アドバンスト コネクティビティ チェック ツールを参照してください。

接続チェックの失敗を解決する方法の詳細については、CTX224133: Cloud Connector Connectivity Check Failedを参照してください。

クラウドコネクタのインストール
August 3, 2026
寄稿者: 
C C
August 3, 2026
寄稿者: 
C C

この記事の概要

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