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

Citrix Workspaceアプリは、Citrixのダウンロードページまたは会社のダウンロードページ（利用可能な場合）からダウンロードできます。

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

• 対話型のWindowsベースのインストールウィザードを実行

  または

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

注：

システム要件セクションに記載されているすべての必須システム要件がインストールされていることを確認してください。

管理者権限および非管理者権限でのインストール：

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

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

注：

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

Citrix Workspaceアプリのクリーンアップとインストールコマンド

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

例：

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

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

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

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

• システムはCitrix Workspaceアプリに必要な前提条件を確認し、必要に応じて自動的にインストールします。

  

  前提条件のインストール後、「Welcome to Citrix Workspace Installer」画面が表示されます。

• 1. 続行をクリックします。「Citrix License Agreement」ページが表示されます。
• 1. Citrixライセンス契約を読み、同意してインストールを続行します。Citrix Workspaceアプリのインストールが続行され、正常に完了します。
• 1. 管理者権限でインストールする場合、App Protection機能を有効にする必要がある場合は、インストール後にApp Protectionを開始するチェックボックスを選択します。Citrix Workspaceアプリのインストールが続行され、正常に完了します。
• 

重要：

TrolleyExpressはCWAInstaller-<日付とタイムスタンプ>に置き換えられます。たとえば、ログはC:\Program Files (x86)\Citrix\Logs\CTXWorkspaceInstallLogs-20231225-093441に記録されます。

Windowsストアの使用

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

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

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

Citrix Workspaceアプリのインストーラーは、さまざまなコマンドラインオプションを指定してカスタマイズできます。インストーラーパッケージは、セットアッププログラムを起動する前にシステムの一時ディレクトリに自己解凍されます。必要なディスク容量には、複数のアプリケーションを起動した後のプログラムファイル、ユーザーデータ、および一時ディレクトリが含まれます。

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

• インストーラーファイル名、
• インストールコマンド、および
• インストールプロパティ

利用可能なインストールコマンドとプロパティは次のとおりです。

• CitrixWorkspaceApp.exe [commands] [properties]

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

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

• 共通パラメーター
• 更新パラメーター
• インストールパラメーター
• HDX機能パラメーター
• 設定およびユーザーインターフェイスパラメーター
• 認証パラメーター

共通パラメーター

• noreboot

  インストール中の再起動プロンプトを抑制します。再起動プロンプトを抑制すると、中断状態のUSBデバイスは認識されません。USBデバイスは、デバイスが再起動された後にのみアクティブになります。

• /forceinstall

  このスイッチは、システム内のCitrix Workspaceアプリの既存の構成やエントリをクリーンアップする場合に有効です。サポートされていないバージョンのCitrix Workspaceアプリからアップグレードする場合、またはインストールやアップグレードが失敗した場合にこのスイッチを使用します。

注:

forceinstallスイッチは、rcuスイッチの代替です。rcuスイッチはバージョン1909以降非推奨です。詳しくは、「非推奨」を参照してください。

自動更新パラメーター

利用可能な更新の検出

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

指定できる値は次のとおりです。

• Disabled

  自動更新を無効にします。

  CitrixWorkspaceApp.exe AutoUpdateCheck=disabled

注:

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

更新バージョンの選択

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

指定できる値は次のとおりです。

更新通知の延期

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

指定できる値は次のとおりです。

注:

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

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

• コマンド: AURolloutPriority
• 説明: アプリの新しいバージョンが利用可能になると、Citrixは特定の配信期間にわたって更新をロールアウトします。このパラメーターを使用すると、配信期間のどの時点で更新を受け取るかを制御できます。

指定できる値は次のとおりです。

|AURolloutPriorityコマンド値|説明|例| |—|—|—|

• Auto (デフォルト)

  Citrixによって構成された配信期間中に更新を受け取ります。

  CitrixWorkspaceApp.exe AURolloutPriority=Auto

• Fast

  配信期間の開始時に更新を受け取ります。

  CitrixWorkspaceApp.exe AURolloutPriority=Fast

• Medium	配信期間の中頃に更新を受け取ります。	CitrixWorkspaceApp.exe AURolloutPriority=Medium
  Slow	配信期間の終わりに更新を受け取ります。	CitrixWorkspaceApp.exe AURolloutPriority=Slow

ストア構成パラメーター

ストアの構成

• コマンド: ALLOWADDSTORE

• 説明: 指定されたパラメーターに基づいてストア（HTTPまたはHTTPS）を構成できます。

• 指定できる値は次のとおりです。

|ALLOWADDSTOREコマンド値|説明|例| |—|—|—|

• S (デフォルト)

  セキュアストア（HTTPSで構成）のみを追加または削除できます。

  CitrixWorkspaceApp.exe ALLOWADDSTORE=S

• A

  セキュアストア（HTTPS）と非セキュアストア（HTTP）の両方を追加または削除できます。Citrix Workspaceアプリがユーザーごとにインストールされている場合は適用されません。

  CitrixWorkspaceApp.exe ALLOWADDSTORE=A

• N

  ユーザーが自身のストアを追加または削除することを許可しません。

  CitrixWorkspaceApp.exe ALLOWADDSTORE=N

ストア資格情報のローカル保存

• コマンド: 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つのみ許可され、リストの最初に配置する必要があります (パラメーター STORE0)。
• この方法で構成されたCitrix GatewayストアURLは、Citrix Gatewayを使用するPNA Servicesサイトをサポートしません。
• 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のリストの最初のエントリである必要があります。

• 次の表は、ストアURLのパラメーターの説明を示します。

• StoreFront™の例:

営業担当者向け: SalesStore;https://sales.mycompany.com/Citrix/Store/discovery;On;Store

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

アプリ保護の開始

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

詳細については、「アプリ保護」を参照してください。

注:

startAppProtection スイッチは、includeAppProtection スイッチの代替です。includeAppProtection スイッチは非推奨です。詳細については、「非推奨」を参照してください。

Citrix Enterprise Browserバイナリの除外

• コマンド: InstallEmbeddedBrowser
• 説明: Citrix Enterprise Browserバイナリを除外します。

• 例: 組み込みブラウザー機能を除外するには、InstallEmbeddedBrowser=N スイッチを実行します。

• 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アプリはすべての必須コンポーネントをデフォルトでインストールします。

注:

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

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

• DesktopViewer

  Desktop Viewer クライアント

  仮想デスクトップ用のUIフレームワーク。

• AM	AuthManager	認証マネージャー - ユーザーをCitrix Workspaceアプリに認証します。
  SSON	SSON	シングルサインオンコンポーネント – シングルサインオンをサポートします。
  SELFSERVICE	セルフサービス	Citrix Workspaceのネイティブ起動用プラグイン。
  WebHelper	Web Helper	ブラウザーをネイティブワークスペースアプリに接続するためのヘルパー。
  CitrixEnterpriseBrowser	ブラウザー	ユーザーがCitrix WorkspaceアプリからWebまたはSaaSアプリを安全に開くことを可能にするネイティブブラウザー。
  MTOPBootStrapperInstaller	Microsoft Teams VDI プラグイン	VDI 用 Microsoft Teams をサポートするプラグイン。
  EPAClient	EPA クライアント	エンドポイント分析スキャンを実行するプラグイン。

• ^^

  ^^

  注: EPA クライアントは、Citrix Workspace™ app for Windows 2402 LTSR CU2 以降でサポートされています。

• たとえば、次のコマンドを使用して、コマンドで指定されたコンポーネントをインストールできます。

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

注:

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

Citrix Casting™ のインストール

• 重要:

• Citrix Workspace app LTSR バージョン 2402 以降では、IncludeCitrixCasting コマンドを使用しても Citrix Casting をインストールできません。この機能を使用するには、以前のバージョンの Citrix Workspace app を使用する必要があります。詳細については、非推奨ページを参照してください。

• コマンド: IncludeCitrixCasting

• 説明: インストール中に Citrix Casting をインストールします。

• Citrix Casting の詳細については、Citrix Casting を参照してください。

HDX 機能パラメーター

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

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

指定できる値は次のとおりです。

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

• コマンド: FORCE_LAA
• 説明: Citrix Workspaceアプリがクライアント側のローカルアプリアクセスコンポーネントとともにインストールされていることを示します。このコンポーネントが機能するには、管理者権限でワークスペースアプリをインストールしてください。詳細については、Citrix Virtual Apps and Desktops ドキュメントの「ローカルアプリアクセス」セクションを参照してください。

指定できる値は次のとおりです。

• 1

  クライアント側のローカルアプリアクセスコンポーネントがインストールされていることを示します。

  CitrixWorkspaceApp.exe FORCE_LAA =1

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

• コマンド: ALLOW_CLIENTHOSTEDAPPSURL
• 説明: ユーザーデバイスでURLリダイレクト機能を有効にします。詳細については、Citrix Virtual Apps and Desktops ドキュメントの「ローカルアプリアクセス」セクションを参照してください。

指定できる値は次のとおりです。

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

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

指定できる値は次のとおりです。

• True

  サブスクライブされたアプリケーションとファイルタイプ関連付けを持つドキュメントまたはファイルのアイコンを表示しません。

  CitrixWorkspaceApp.exe LEGACYFTAICONS=True

• 環境設定とユーザーインターフェイスのパラメーター

• スタートメニューとデスクトップのショートカットディレクトリの指定

• コマンド値	説明	ディレクトリ名	例
  CitrixWorkspaceApp.exe STARTMENUDIR	スタートメニューのショートカットのディレクトリを指定します。	デフォルトでは、アプリケーションは [スタート] > [すべてのプログラム] の下に表示されます。Programs フォルダー内のショートカットの相対パスを指定できます。	ショートカットを [スタート] > [すべてのプログラム] > [Workspace] の下に配置するには、STARTMENUDIR=Workspace を指定します。
  CitrixWorkspaceApp.exe DESKTOPDIR	デスクトップ上のショートカットのディレクトリを指定します。	ショートカットの相対パスを指定できます。	ショートカットを [スタート] > [すべてのプログラム] > [Workspace] の下に配置するには、DESKTOPDIR=Workspace を指定します。

注:

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

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

• コマンド: SELFSERVICEMODE

• 説明: セルフサービスの Citrix Workspace app ユーザーインターフェイスへのアクセスを制御します。

• 指定できる値は次のとおりです。

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

• コマンド: ENABLEPRELAUNCH
• 説明: セッションの事前起動を制御します。詳しくは、「アプリケーションの起動時間」を参照してください。

指定可能な値は次のとおりです。

ショートカットと再接続オプションの非表示

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

指定可能な値は次のとおりです。

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

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

指定可能な値は次のとおりです。

常時トレースの有効化

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

指定可能な値は次のとおりです。

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

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

クライアント名をコンピューター名と同じにする

• コマンド: ENABLE_DYNAMIC_CLIENT_NAME
• 説明: クライアント名をコンピューター名と同じにすることを許可します。コンピューター名を変更すると、クライアント名も変更されます。

指定可能な値は次のとおりです。

認証パラメーター

シングルサインオンの組み込み

• コマンド: /includeSSON
• 説明: 管理者としてインストールする必要があります。Citrix Workspaceアプリがシングルサインオンコンポーネントとともにインストールされていることを示します。詳しくは、「ドメインパススルー認証」を参照してください。
• 例: 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のエラーメッセージ」を参照してください。
• システム関連のエラーコードについては、「システムエラーコード」を参照してください。

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

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

注:

TrolleyExpressはCWAInstaller-<日付とタイムスタンプ>に置き換えられます。たとえば、ログはC:\Program Files (x86)\Citrix\Logs\CTXWorkspaceInstallLogs-20231225-093441に記録されます。

トラブルシューティング

エラーコード

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

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

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

Citrix Workspaceアプリのリセット

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

Citrix Workspaceアプリをリセットすると、次の項目がリセットされます。

• 設定されているすべてのアカウントとストア。
• セルフサービスプラグインによって配信されたアプリ、そのアイコン、およびレジストリキー。
• セルフサービスプラグインによって作成されたファイルタイプの関連付け。
• キャッシュされたファイルと保存されたパスワード。
• ユーザーごとのレジストリ設定。
• マシンごとのインストールとそのレジストリ設定。
• 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）管理用テンプレート構成。