コマンドラインから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:必須。顧客IDは、Citrix Cloud Japanコンソールの[APIアクセス]ページに表示されます。
- 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 - インストールが正常に完了しました。