コマンドラインから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",
}
パラメーターファイルを使用してインストールするコマンドラインの例：
CWCConnector.exe /q /ParametersFilePath:c:\cwcconnector_install_params.json
失敗した場合に潜在的なエラーコードを調べるには、Start /Wait CWCConnector.exe /ParametersFilePath:value を使用します。インストール完了後に echo %ErrorLevel% を実行する標準的なメカニズムを使用できます。
トラブルシューティング
インストールログ
インストールログは %LOCALAPPDATA%\\Temp\\CitrixLogs\\CloudServicesSetup で利用できます。
また、インストール後にログは %ProgramData%\\Citrix\\WorkspaceCloud\\InstallLogs に追加されます。
終了コード
-
1603 - 予期せぬエラーが発生しました。
-
2 - 前提条件の確認に失敗しました。
-
0 - インストールが正常に完了しました。