インストールとアンインストール

Citrix Workspaceアプリは、Citrixの［ダウンロード］ページ または所属する組織の［ダウンロード］ページ（存在する場合）からダウンロードできます。

パッケージは次の方法でインストールできます：

• Windowsベースのインタラクティブなインストールウィザードを実行する。

  または

• コマンドラインインターフェイスを使用して、インストーラーのファイル名、インストールコマンド、インストールプロパティを入力する。コマンドラインインターフェイスを使用したCitrix Workspaceアプリのインストールについて詳しくは、「コマンドラインパラメーターの使用」を参照してください。

注：

システム要件に関するセクションに記載されているように、必要なシステム要件をすべてインストールしたことを確認します。

管理者権限と非管理者権限によるインストール：

ユーザーと管理者の両方がCitrix Workspaceアプリをインストールできます。Windows向けCitrix Workspaceアプリでパススルー認証、シングルサインオン、App Protection、Microsoft Teams VDIプラグイン、およびCitrix Readyワークスペースハブを使用する場合にだけ、管理者権限が必要です。

次の表では、Citrix Workspaceアプリを管理者またはユーザーとしてインストールした場合の違いについて説明します：

注：

Citrix Workspaceアプリのユーザーがインストールしたインスタンスを管理者が上書きし、インストールを正常に続行できます。

Citrix Workspaceアプリをクリーンアップしてインストールするコマンド

/CleanInstallコマンドを使用して、以前のアンインストールで残ったファイルやレジストリ値などのトレースをクリーンアップし、新しいバージョンのCitrix Workspaceアプリを新たにインストールします。

例：

CitrixWorkspaceApp.exe /CleanInstall
<!--NeedCopy-->

ユーザーインターフェイスベースのインストール

CitrixWorkspaceApp.exeインストーラーパッケージを手動で実行することで、Windows向けCitrix Workspaceアプリをインストールできます。

1. CitrixWorkspaceApp.exeファイルを起動します。

   システムはCitrix Workspaceアプリに必要な前提条件を検証し、必要な場合は自動的にインストールします。

   

   前提条件をインストールすると、［Citrix Workspaceインストーラーへようこそ］ 画面が表示されます。

2. ［続行］ をクリックします。［Citrixライセンス契約］ ページが開きます。
3. Citrixライセンス契約を読んで同意してから、インストールを続行します。Citrix Workspaceアプリのインストールは続行され、正常に完了します。
4. 管理者権限でインストールする場合、アプリ保護機能を有効にする必要があるときは、［インストール後にApp Protectionを開始する］チェック ボックスをオンにします。Citrix Workspaceアプリのインストールは続行され、正常に完了します。

重要：

TrolleyExpressはCWAInstaller-<date and timestamp>に置き換えられます。たとえば、ログはC:\Program Files (x86)\Citrix\Logs\CTXWorkspaceInstallLogs-20231225-093441に記録されます。

Windowsストアの使用

1. Microsoft Storeに移動します。
2. Citrix Workspaceを検索します。

1. ［Get］をクリックします。Citrix Workspaceアプリがインストールされます。

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

さまざまなコマンドラインオプションを指定して、Citrix Workspaceアプリのインストーラーをカスタマイズできます。インストーラーパッケージは自己展開型であり、セットアッププログラムが起動する前にシステムの一時フォルダーに展開されます。領域要件には、プログラムファイル、ユーザーデータ、およびいくつかのアプリケーションを起動した後の一時ディレクトリが含まれます。

Windowsコマンドラインを使用してCitrix Workspaceアプリをインストールするには、コマンドプロンプトを起動し、次の項目を1行で入力します：

• インストーラーのファイル名
• インストールコマンド
• インストールプロパティ

以下は、使用可能なインストールコマンドとプロパティです：

CitrixWorkspaceApp.exe [commands] [properties]

コマンドラインパラメーター一覧

パラメーターは大まかに次のように分類されます：

• 一般的なパラメーター
• アップデートのパラメーター
• インストールパラメーター
• HDX機能のパラメーター
• 基本設定とユーザーインターフェイスのパラメーター
• 認証パラメーター

一般的なパラメーター

注：

forceinstallスイッチは、rcuスイッチに置き換わります。rcuスイッチは、バージョン1909で廃止されます。詳しくは、「廃止」を参照してください。

自動更新パラメーター

利用可能な更新プログラムを検出する

• コマンド：AutoUpdateCheck
• 説明：このコマンドは、Citrix Workspaceアプリが利用可能な更新プログラムを検出することを示します。

設定可能な値は、次のとおりです：

注：

AutoUpdateCheckは、AutoUpdateStream、DeferUpdateCount、AURolloutPriorityなどのほかのパラメーターを構成するために設定する必要がある必須パラメーターです。

更新プログラムのバージョンの選択

• コマンドAutoUpdateStream
• 説明 - 自動更新を有効にすると、更新するバージョンを選択できます。詳しくは、「ライフサイクルマイルストーン」 を参照してください。

設定可能な値は、次のとおりです：

更新プログラムの通知の延期

• コマンド：DeferUpdateCount
• 説明：更新プログラムが利用可能になった場合の通知を延期できる回数を示します。詳しくは、「Citrix Workspace更新プログラム」を参照してください。

設定可能な値は、次のとおりです：

注：

Windows向けCitrix Workspaceアプリバージョン2207以降から、自動更新機能が改善されて、 DeferUpdatCountパラメーターが適用されなくなりました。

ロールアウトの優先度の設定

• コマンド：AURolloutPriority
• 説明：新しいバージョンのアプリが利用可能になると、特定の配信期間に更新プログラムがCitrixからロールアウトされます。このパラメーターを使用すると、配信期間中に更新プログラムを受信するタイミングを制御できます。

設定可能な値は、次のとおりです：

ストア構成パラメーター

ストアの構成

• コマンド： ALLOWADDSTORE
• 指定されたパラメーターを基にしてストア（HTTPまたはhttps）の構成を許可します。

設定可能な値は、次のとおりです：

ローカルへのストア認証情報の保存

• コマンド：ALLOWSAVEPWD
• 説明：ストア認証情報をローカルに保存できます。このパラメーターは、Citrix Workspaceアプリプロトコルを使用するストアにのみ適用されます。

設定可能な値は、次のとおりです：

コマンドラインインストールを使用したストア構成の例

StoreFrontのストアURLを指定するには：

CitrixWorkspaceApp.exe /silent
STORE0="AppStore;https://testserver.net/Citrix/MyStore/discovery;on;HR App Store"

<!--NeedCopy-->

Citrix GatewayのストアURLを指定するには：

CitrixWorkspaceApp.exe STORE0=HRStore;https://ag.mycompany.com#Storename;On;Store
<!--NeedCopy-->

ここでStorenameは、構成する必要があるストアの名前です。

注：

• 複数ストア環境でCitrix GatewayのストアURLは1つだけ構成でき、そのURLを一覧の先頭に指定する必要があります（パラメーターはSTORE0）。
• Citrix GatewayのストアURLを上記の方法で構成した場合、Citrix Gatewayを使用しているPNAサービスサイトはサポートされません。
• Citrix GatewayのストアURLを指定する場合、「Discovery」パラメーターは必要ありません。

複数ストアを構成するには：

CitrixWorkspaceApp.exe  STORE0= NetScaler Store;https://ag.mycompany.com#Storename;On;NetScaler Store
STORE1="StoreFront Store;https://testserver.net/Citrix/MyBackupStore/discovery;on; StoreFrontStore
<!--NeedCopy-->

注：

• パススルー認証を成功させるには、ストアURLにdiscoveryを含める必要があります。
• Citrix GatewayのストアURLは、構成済みのストアURL一覧で最初のエントリにする必要があります。

インストールパラメーター

アプリ保護の開始

• コマンド：startAppProtection
• 説明：アプリ保護コンポーネントを開始し、セキュリティを強化して、キーロギングや画面キャプチャマルウェアによってクライアントが侵害される可能性を抑えます。
• 例： CitrixWorkspaceApp.exe startAppProtection

詳しくは、「App Protection」を参照してください。

注：

startAppProtectionスイッチは、includeAppProtectionスイッチに置き換わります。includeAppProtectionは廃止済みです。詳しくは、「廃止」を参照してください。

Citrix Enterprise Browserバイナリの除外

• コマンド：InstallEmbeddedBrowser
• 説明：Citrix Enterprise Browserバイナリを除外します。
• 例：InstallEmbeddedBrowser=Nスイッチを実行することで、Citrix組み込みブラウザー機能を除外します。

Citrix Enterprise Browserバイナリを除外できるのは、次の場合のみです：

• 新規インストール
• Citrix Enterprise Browserバイナリが含まれていないバージョンからのアップグレード。

Citrix WorkspaceアプリのバージョンにCitrix Enterprise Browserバイナリが含まれていて、バージョン2002にアップグレードする場合には、Citrix Enterprise Browserバイナリはアップグレード中に自動的に更新されます。

カスタムインストールディレクトリの指定

• コマンド： INSTALLDIR
• 説明：Citrix Workspaceアプリをインストールするためのカスタムインストールディレクトリを指定します。デフォルトのパスはC:\Program Files\Citrixです。
• 例：CitrixWorkspaceApp.exe INSTALLDIR=C:\custom path\Citrix。

注：

Program Filesフォルダーはオペレーティングシステムによって保護されています。Program Files以外のカスタムフォルダーを使用する場合は、そのフォルダーが保護されていると同時に、ユーザーがそのフォルダーへの必要な権限を持っていることを確認してください。

1つまたは複数の特定コンポーネントのインストール

• コマンド：ADDLOCAL
• 説明：ADDLOCALキーを使用して、Citrix Workspaceアプリの特定コンポーネントを1つまたは複数インストールします。このキーを使用して特定のコンポーネントをインストールすると、Citrix Workspaceアプリにより、デフォルトですべての必須コンポーネントがインストールされます。

注：

ADDLOCAL キーは、Citrix Workspaceアプリの特定のコンポーネントをインストールする場合にのみ使用することをお勧めします。デフォルトでは、ADDLOCALパラメーターが指定されていない場合、Citrix Workspaceアプリのインストール中に、サポートされているすべてのコンポーネントがインストールされます。

次の表に、ADDLOCALキーがサポートするコンポーネントを示します：

たとえば、次のコマンドを使用して、コマンドに記載されているコンポーネントをインストールできます：

CitrixWorkspaceapp.exe ADDLOCAL=ReceiverInside,ICA_Client,BCR_Client,USB,DesktopViewer,AM,SSON,SelfService,WebHelper,CitrixEnterpriseBrowser
<!--NeedCopy-->

注：

App Protection機能がデフォルトでインストールされます。その結果、AppProtectionはADDLOCALの有効なオプションではなくなりました。

Citrix Castingのインストール

重要：

Citrix WorkspaceアプリLTSRバージョン2402以降では、IncludeCitrixCastingコマンドを使用してもCitrix Castingをインストールできません。この機能を使用するには、Citrix Workspaceアプリの古いバージョンを使用する必要があります。詳しくは、「廃止」ページを参照してください。

• コマンド：IncludeCitrixCasting
• 説明：コンポーネントのインストール中にCitrix Castingをインストールします。

Citrix Castingについて詳しくは、Citrix Castingに関するセクションを参照してください。

HDX機能のパラメーター

コンテンツの双方向へのリダイレクトの設定

• コマンド：ALLOW_BIDIRCONTENTREDIRECTION
• 説明：コンテンツの、クライアントとホスト間での双方向のリダイレクトを有効化するかどうかを示します。詳しくは、Citrix Virtual Apps and Desktopsのドキュメントで「双方向のコンテンツリダイレクトのポリシー設定」を参照してください。

設定可能な値は、次のとおりです：

ローカルアプリアクセスの設定

• コマンド：FORCE_LAA
• 説明：Citrix Workspaceアプリはクライアント側ローカルアプリアクセスのコンポーネントとともにインストールされます。このコンポーネントを動作させるには、管理者権限でWorkspaceアプリをインストールします。詳しくは、「製品ドキュメント」の「Citrix Virtual Apps and Desktops」の項にある「ローカルアプリアクセスとURLリダイレクト」を参照してください。

設定可能な値は、次のとおりです：

ユーザーデバイスのURLリダイレクト機能の設定

• コマンド：ALLOW_CLIENTHOSTEDAPPSURL
• ユーザーデバイスのURLリダイレクト機能を有効にします。詳しくは、「製品ドキュメント」の「Citrix Virtual Apps and Desktops」の項にある「ローカルアプリアクセスとURLリダイレクト」を参照してください。

設定可能な値は、次のとおりです：

ドキュメントまたはファイルのアイコンの表示

• コマンド：LEGACYFTAICONS
• 説明：サブスクライブするアプリケーションに関連付けられているファイルタイプのドキュメントまたはファイルに、そのアプリケーションのアイコンを表示するかどうかを指定します。

設定可能な値は、次のとおりです：

基本設定とユーザーインターフェイスのパラメーター

［スタート］メニューとデスクトップの上にあるショートカットのディレクトリの指定

注：

DESKTOPDIRオプションを使用するときは、PutShortcutsOnDesktopキーをTrueに設定します。

セルフサービスへのアクセスの制御

• コマンド：SELFSERVICEMODE
• 説明：セルフサービスのCitrix Workspaceアプリのユーザーインターフェイスに対するアクセスを制御します。

設定可能な値は、次のとおりです：

セッションの事前起動の制御

• コマンド：ENABLEPRELAUNCH
• 説明: セッションの事前起動を制御します。詳しくは、「Application launch time」を参照してください。

設定可能な値は、次のとおりです：

［ショートカット］および［再接続］オプションの非表示

• コマンド：DisableSetting
• 説明：［高度な設定］ シートに ［ショートカット］および［再接続］オプションが表示されないようにします。詳しくは、「［高度な設定］シートから特定の設定を非表示にする」を参照してください。

設定可能な値は、次のとおりです：

カスタマーエクスペリエンス向上プログラムの有効化

• コマンド：EnableCEIP
• 説明：カスタマーエクスペリエンス向上プログラム（CEIP）に参加することを示します。詳しくは、「カスタマーエクスペリエンス向上プログラム（CEIP）について」を参照してください。

設定可能な値は、次のとおりです：

常時トレースの有効化

• コマンド：EnableTracing
• 説明：常時トレース機能を制御します。

設定可能な値は、次のとおりです：

ユーザーデバイスを識別するための名前の指定

• コマンド：CLIENT_NAME
• 説明：サーバーでユーザーデバイスを識別するために使用される名前を指定します。
• <ClientName> - サーバーでユーザーデバイスを識別するために使用される名前です。デフォルト名は%COMPUTERNAME%です。
• 例：CitrixReceiver.exe CLIENT_NAME=%COMPUTERNAME%。

クライアント名へのコンピューター名と同じ名前の設定

• コマンド：ENABLE_DYNAMIC_CLIENT_NAME
• 説明：クライアント名をコンピューター名と同じ名前にすることができます。この場合、ユーザーがコンピューター名を変更すると、クライアント名もそれに応じて変更されます。

設定可能な値は、次のとおりです：

認証パラメーター

シングルサインオンの追加

• コマンド：/includeSSON
• 説明: 管理者としてインストールする必要があります。Citrix Workspaceアプリはシングルサインオンコンポーネントとともにインストールされます。詳しくは、「[ドメインパススルー認証]」(/en-us/citrix-workspace-app-for-windows/authentication#domain-pass-through-authentication)を参照してください。
• 例：CitrixWorkspaceApp.exe /includeSSON

注：

includeSSONコマンドでは、Citrix Workspaceアプリの新規インストールだけがサポートされています。

シングルサインオンの有効化

• コマンド： ENABLE_SSON
• Citrix Workspaceアプリが/includeSSONコマンドでインストールされた場合、シングルサインオンを有効にします。詳しくは、「ドメインパススルー認証」を参照してください。

設定可能な値は、次のとおりです：

Citrix Workspaceアプリのアンインストール

Windowsベースのアンインストーラーを使用したアンインストール

コントロールパネルからWindows向けCitrix Workspaceアプリをアンインストールできます。詳しくは、「Windows向けCitrix Workspaceアプリのアンインストール」 セクションを参照してください。

注：

Citrix Workspaceアプリのインストール中、Citrix HDX RTMEパッケージのアンインストールを求めるメッセージが表示されます。［OK］をクリックしてアンインストールを続行します。

コマンドラインインターフェイスを使用したアンインストール

ユーザーは、コマンドラインから以下のコマンドを実行してCitrix Workspaceアプリをアンインストールすることもできます：

CitrixWorkspaceApp.exe /uninstall
<!--NeedCopy-->

Citrix Workspaceアプリをサイレントアンインストールするには、次のスイッチを実行します：

CitrixWorkspaceApp.exe /silent /uninstall
<!--NeedCopy-->

注：

Citrix WorkspaceアプリインストーラーはGPO関連のレジストリキーを制御していないため、アンインストール後も保持されます。エントリが見つかった場合は、gpeditを使用して更新するか、手動で削除してください。

トラブルシューティング

エラーコード

• インストーラー関連のエラーコードについては、 「MsiExec.exeおよびInstMsi.exeのエラーメッセージ」を参照してください。
• システム関連のエラーコードについては、「System Error Codes (0-499)」を参照してください。

インストーラーログの場所

デフォルトでは、インストーラーログは次の場所にあります：

注：

TrolleyExpressはCWAInstaller-<date and timestamp>に置き換えられます。たとえば、ログはC:\Program Files (x86)\Citrix\Logs\CTXWorkspaceInstallLogs-20231225-093441に記録されます。

トラブルシューティング

エラーコード

• インストーラー関連のエラーコードについては、 「MsiExec.exeおよびInstMsi.exeのエラーメッセージ」を参照してください。
• システム関連のエラーコードについては、「System Error Codes (0-499)」を参照してください。

インストーラーログの場所

デフォルトでは、インストーラーログは次の場所にあります：

Citrix Workspaceアプリのリセット

Citrix Workspaceアプリをリセットすると、デフォルト設定が復元されます。

Citrix Workspaceアプリのリセットにより、次のアイテムがリセットされます。

• 構成されたすべてのアカウントとストア。
• Self-service Plug-inによって配信されたアプリ、それらのアイコンとレジストリキー。
• Self-service Plug-inによって作成されたファイルタイプの関連付け。
• キャッシュされたファイルと保存されたパスワード。
• ユーザーごとのレジストリ設定。
• マシンごとのインストール、およびそれらのレジストリ設定。
• Citrix WorkspaceアプリのCitrix Gatewayレジストリ設定。

コマンドラインインターフェイスから次のコマンドを実行して、Citrix　Workspaceアプリをリセットします：

"C:\Program Files (x86)\Citrix\ICA Client\SelfServicePlugin\CleanUp.exe" -cleanUser
<!--NeedCopy-->

サイレントリセットには、次のコマンドを使用します：

"C:\Program Files (x86)\Citrix\ICA Client\SelfServicePlugin\CleanUp.exe" /silent -cleanUser
<!--NeedCopy-->

注：

パラメーターに大文字のUを使用します。

Citrix Workspaceアプリをリセットしても、以下には影響しません：

• Citrix Workspaceアプリまたはプラグインのインストール。
• マシンごとのICAのロックダウン設定。
• Citrix Workspaceアプリのグループポリシーオブジェクト（GPO）管理用テンプレートの構成。