コマンドラインからCloud Connectorをインストールする
Citrix Cloud Connector™ソフトウェアは、対話形式でインストールすることも、サイレントインストールまたは自動インストールを使用することもできます。
インストール中、Cloud Connectorは、ユーザーを認証し、権限を検証し、サービスをダウンロードして構成するために、クラウドアクセスを必要とします。インストールは、それを開始したユーザーの権限で実行されます。
重要:
繰り返しインストールするために同じインストーラーを使用することは避けてください。代わりに、Citrix Cloud Japanコンソールのリソースの場所ページから新しいCloud Connectorを入手してください。
要件
Citrix Cloud Japanでコマンドラインインストールを使用するには、以下の情報を提供する必要があります。
- Cloud ConnectorをインストールするCitrix Cloud Japanアカウントの顧客ID。このIDは、IDおよびアクセス管理のAPIアクセスタブの上部に表示されます。
-
Cloud Connectorのインストールに使用するセキュアAPIクライアントのクライアントIDとシークレット。これらの値を取得するには、まずセキュアクライアントを作成する必要があります。クライアントIDとシークレットは、Citrix Cloud APIへのアクセスが適切に保護されていることを保証します。セキュアクライアントを作成すると、お客様が持つ管理者権限と同じ権限で動作します。Cloud Connectorをインストールするには、フルアクセス管理者によって作成されたセキュアクライアントを使用してください。これにより、フルアクセス権限が保証されます。
- Cloud Connectorに関連付けるリソースの場所のリソースの場所ID。この値を取得するには、リソースの場所ページのリソースの場所名のすぐ下にあるIDボタンを選択します。この値を指定しない場合、Citrix Cloud Japanはデフォルトのリソースの場所のIDを使用します。
セキュアクライアントを作成する
セキュアクライアントを作成すると、Citrix Cloud Japanは一意のクライアントIDとシークレットを生成します。コマンドラインを通じてAPIを呼び出す際には、これらの値を指定する必要があります。
- Citrix Cloud Japanメニューから、IDおよびアクセス管理を選択し、次にAPIアクセスを選択します。
- セキュアクライアントタブから、クライアントの名前を入力し、クライアントの作成を選択します。Citrix Cloud Japanは、セキュアクライアントのクライアントIDとシークレットを生成して表示します。
- ダウンロードを選択して、クライアントIDとシークレットをCSVファイルとしてダウンロードし、安全な場所に保存します。または、コピーを選択して、各値を手動で取得します。完了したら、閉じるを選択してコンソールに戻ります。
サポートされているパラメーター
セキュアクライアントのセキュリティ詳細については、インストーラーはJSON構成ファイルを必要とします。インストール完了後、このファイルを削除してください。サポートされている構成ファイルの値は次のとおりです。
- customerName 必須。Citrix Cloud JapanコンソールのAPIアクセスページに表示される顧客ID。
- clientId 必須。管理者によって作成されたセキュアクライアントIDは、APIアクセスページにあります。
- clientSecret 必須。セキュアクライアントの作成後にダウンロードでき、APIアクセスページにあるセキュアクライアントシークレット。
- resourceLocationId 推奨。既存のリソースロケーションの一意の識別子。Citrix CloudコンソールのリソースロケーションページでIDボタンを選択し、リソースロケーションIDを取得します。値が指定されていない場合、Citrix Cloudはアカウント内の最初のリソースロケーションのIDを使用します。
- acceptTermsOfService 必須。trueに設定する必要があります。
構成ファイルの例：
{
"customerName": "CustomerID",
"clientId": "ClientID",
"clientSecret": "ClientSecret",
"resourceLocationId": "ResourceLocationId"
"acceptTermsOfService": "true",
}
<!--NeedCopy-->
パラメーターファイルを使用してインストールするコマンドラインの例：
CWCConnector.exe /q /ParametersFilePath:c:\cwcconnector_install_params.json
<!--NeedCopy-->
失敗した場合に潜在的なエラーコードを調べるには、Start /Wait CWCConnector.exe /ParametersFilePath:valueを使用します。インストール完了後、echo %ErrorLevel%を実行する標準的なメカニズムを使用できます。
トラブルシューティング
インストールログ
インストールログは%LOCALAPPDATA%\Temp\CitrixLogs\CloudServicesSetupで利用できます。
また、インストール後、ログは%ProgramData%\Citrix\WorkspaceCloud\InstallLogsに追加されます。
終了コード
- 1603 - 予期せぬエラーが発生しました。
- 2 - 前提条件のチェックに失敗しました。
- 0 - インストールが正常に完了しました。