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

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

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

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

  または

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

注：

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

• Citrix Workspaceアプリの新しいバージョンにアップグレードする場合は、CitrixWorkspaceApp.exe /CleanInstallコマンドを使用してください。

• ダウングレードの場合、Citrixは既存のバージョンをアンインストールしてから、目的のバージョンをインストールすることを推奨します。

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

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

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

注：

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

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

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

例：

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

注：

forceinstallコマンドとcleaninstallコマンドの違いは、forceinstallがサポートされていないバージョンアップグレードまたは何らかの障害の場合に実行されるのに対し、cleaninstallはインストールまたはアップグレードのいずれであっても、必要なアクションを実行する前に常にクリーンアップすることです。

App Protectionを使用したCitrix Workspace™アプリの強化されたインストールプロセス

以前は、App Protectionが有効になっている場合、/cleanInstallスイッチはサポートされておらず、ユーザーは手動でアンインストールしてマシンを再起動してからインストールを再試行する必要がありました。バージョン2503以降、App Protectionが有効で/CleanInstallコマンドが実行されると、Citrix Workspaceアプリは自動的にアンインストールされ、ユーザーの選択に基づいてマシンが再起動され、再起動中にアプリが再インストールされます。このプロセス中に次のメッセージが表示されます。

  -  ![Installation successful](/en-us/citrix-workspace-app-for-windows/media/installation-successful.png)

• ユーザーが [再起動] をクリックすると、再起動中にCitrix Workspaceアプリが再インストールされます。

• ユーザーが [キャンセル] をクリックすると、次回の再起動時にCitrix Workspaceアプリがインストールされます。その結果、システムでアプリを検索してもCitrix Workspaceアプリは利用できません。

  • 注：

      -  サイレントインストールの場合、Citrix Workspaceアプリは次回のユーザーによる再起動後にのみ利用可能になります。
      -  ユーザーが再起動前にインストールを再試行すると、システムを再起動するための次のプロンプトが表示されます。
    

    

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

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

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

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

   

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

    -  1.  **[続行]** をクリックします。**Citrixライセンス契約**ページが表示されます。   -  1.  Citrixライセンス契約を読んで同意し、インストールを続行します。Citrix Workspaceアプリのインストールが続行され、正常に完了します。
   

2. 管理者権限でインストールする場合、[アドオン] ページから以下を選択できます。

    -  インストール後にApp Protectionを開始する   -  シングルサインオンを有効にする   -  Microsoft Teams VDIプラグインをインストールする
    -  Windows向けCitrix Workspaceアプリバージョン2508以降、このオプションはデフォルトで選択されています。ユーザーはこのオプションをクリアして、Microsoft Teams VDIプラグインのインストールを防止できます。   -  Zoom VDIプラグインをインストールする
    -  Windows向けCitrix Workspaceアプリバージョン2511以降、このオプションはデフォルトで選択されています。ユーザーはこのオプションをクリアして、Zoom VDIプラグインのインストールを防止できます。   -  Cisco WebEx VDIプラグインをインストールする
   

Citrix Workspaceアプリのインストールが続行され、正常に完了します。

重要:

Citrix Workspaceアプリ for Windows 2311.1バージョン以降、TrolleyExpress は CWAInstaller-<日付とタイムスタンプ> に置き換えられました。たとえば、ログは C:\Program Files (x86)\Citrix\Logs\CTXWorkspaceInstallLogs-20231225-093441 に記録されます。

Windowsストアの使用

1. Microsoft Storeに移動します

• 1. Citrix Workspaceを検索します

  

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

注:

Microsoft Teams VDIプラグインやZoomプラグイン管理などのサードパーティ製プラグインおよびプラグイン管理コンポーネントは、Windowsストアを介してCitrix Workspaceアプリをインストールする場合、サポートされません。

コマンドラインによるインストール

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

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

• インストーラーファイル名、
• インストールコマンド、および

• インストールプロパティ

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

CitrixWorkspaceApp.exe [commands] [properties]

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

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

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

共通パラメーター

• 注:

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

  forceinstall コマンドと cleaninstall コマンドの違いは、forceinstall がサポートされていないバージョンのアップグレードまたは何らかの障害が発生した場合に実行されるのに対し、cleaninstall は、インストールであろうとアップグレードであろうと、必要なアクションを実行する前に常にクリーンアップを行う点です。

自動更新パラメーター

利用可能な更新の検出

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

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

注:

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

更新バージョンの選択

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

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

更新通知の延期

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

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

注：

• Citrix Workspaceアプリ for Windowsバージョン2207以降、自動更新機能が改善され、DeferUpdatCountパラメーターは適用されません。

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

• コマンド：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）を構成できます。

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

• |—|—|—|

• 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は、Citrix Gatewayを使用しているPNA Servicesサイトをサポートしていません。
• Citrix GatewayストアURLを指定する場合、「Discovery」パラメーターは不要です。

複数のストアを構成する場合：

-  CitrixWorkspaceApp.exe  STORE0="StoreFront Store;https://testserver.net/Citrix/MyBackupStore/discovery;on; StoreFrontStore"

STORE1="NetScaler Store;https://ag.mycompany.com#Storename;On;NetScaler Store"
<!--NeedCopy-->

注：

パススルー認証を成功させるには、ストアURLにdiscoveryを含めることが必須です。

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

• |—|—|

• ストア名	ユーザーに表示されるストアの名前。
  ストアURL	ストアのURL。

• ストアの有効状態

  状態はオンまたはオフにできます。

• ストアの説明

  ユーザーに表示されるストアの説明。

StoreFront™の例：

SalesStore;https://sales.mycompany.com/Citrix/Store/discovery;On;Store for Sales staff.

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

アプリ保護の開始

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

詳細については、アプリ保護のドキュメントを参照してください。

注：

startAppProtection スイッチは、includeAppProtection スイッチの代替です。includeAppProtection スイッチはバージョン 2212 以降で非推奨になりました。詳細については、「非推奨」を参照してください。

Citrix Enterprise Browserバイナリの除外

• コマンド: Citrix Enterprise Browser™を除外するには、次のコマンドを実行します。

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

• 説明: Citrix Enterprise Browserバイナリを除外します。

Citrix Enterprise Browserバイナリは、次の場合にのみ除外できます。

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

注：

• バージョン 2511 以降、Citrix Enterprise BrowserはWindows向けCitrix Workspaceアプリではサポートされなくなりました。必要に応じて、ユーザーと管理者は、CitrixダウンロードページのCitrix Enterprise Browserセクションから直接ダウンロードして、Citrix Enterprise Browserを個別にインストールできます。

EPAクライアントの自動インストールからの除外

• コマンド: CitrixWorkspaceApp.exe InstallEPAClient=N
• 説明: EPAクライアントの自動インストールを停止します。
• 例: 次のコマンドを使用します。

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

EPAは、次の場合に除外できます。

• 新規インストール
• EPAを含まないバージョンからのアップグレード

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

• コマンド: 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アプリをアップグレードする場合、インストーラーは、ベースバージョンにすでに存在するコンポーネントの除外コマンド（BCR_Clientなど）を認識しません。アップグレードプロセス中にコンポーネントを削除するには、必要な除外パラメーターを指定して新しいバージョンをインストールする前に、既存のCitrix Workspaceアプリを完全にアンインストールしてください。

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

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

• USB

  USBクライアント

  USBリダイレクトを処理するプラグイン。

• DesktopViewer	Desktop Viewerクライアント	仮想デスクトップ用のUIフレームワーク。
  AM	AuthManager	認証マネージャー - ユーザーをCitrix Workspaceアプリに認証します。
  SSON	SSON	シングルサインオンコンポーネント – シングルサインオンをサポートします。
  SELFSERVICE	セルフサービス	ネイティブ起動用のCitrix Workspace用プラグイン。
  WebHelper	Web Helper	ブラウザーをネイティブワークスペースアプリに接続するためのヘルパー。
  CitrixEnterpriseBrowser	Browser	ユーザーがCitrix WorkspaceアプリからWebまたはSaaSアプリを安全に開くことを可能にするネイティブブラウザー。

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

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

注：

バージョン 2212 以降、アプリ保護機能はデフォルトでインストールされます。その結果、AppProtectionはADDLOCALコマンドの有効なオプションではなくなりました。

• 制限事項:

ADDLOCALパラメーターを使用してCitrix Workspaceアプリをインストールすると、接続センターからデバイスおよび設定ウィンドウが応答しない場合があります。この問題は、DesktopViewerパラメーターなしでCitrix Workspaceアプリをインストールした場合にのみ発生します。回避策として、DesktopViewerパラメーターも追加してください。[HDX-67173]

サードパーティ製プラグインのインストール

Citrix Workspaceアプリは、次のサードパーティ製プラグインおよびプラグイン管理コンポーネントをサポートしています。

• Microsoft Teams VDIプラグイン

Windows向けCitrix Workspaceアプリバージョン2508以降、このコンポーネントはデフォルトでインストールされます。

新規インストールと手動更新

• インストールオプションはデフォルトで選択
• ユーザーは好みに応じてこのオプションを解除可能

自動アップデート

• コンポーネントは、存在しない場合、デフォルトでインストール
• 既存のインストールは、新しいバージョンが利用可能になるとアップグレード

Microsoft Teams VDIプラグインのインストールを防止するには、管理者は次のコマンドラインを使用します。

CitrixWorkspaceapp.exe /InstallMSTeamsPlugin=N

• Citrix Workspaceアプリ for Windowsバージョン2508以降では、アップグレード中にアプリケーションが以前の選択を記憶します。アップグレード中にMicrosoft Teams VDIプラグインをインストールするには（以前に選択解除されていた場合）、管理者は次のコマンドラインを使用します。

CitrixWorkspaceapp.exe /InstallMSTeamsPlugin=Y

Zoom VDIプラグインの管理

Citrix Workspaceアプリ for Windowsバージョン2511以降、このコンポーネントはデフォルトでインストールされます。

• 新規インストールと手動アップデート

• インストールオプションはデフォルトで選択
• ユーザーは好みに応じてこのオプションを解除可能

自動アップデート

• コンポーネントは、存在しない場合、デフォルトでインストール

• 既存のインストールは、新しいバージョンが利用可能になるとアップグレード

• Zoom VDIプラグインのインストールを防止するには、管理者は次のコマンドラインを使用します。

• CitrixWorkspaceapp.exe Installzoomplugin=N

WebEx VDIプラグインインストーラーエンジン

WebEx VDIプラグインインストーラーエンジンをインストールするには：

新規インストールと手動アップデート

• インストールオプションはデフォルトで解除

• ユーザーは好みに応じてこのオプションを選択可能

• 自動アップデート

• コンポーネントはデフォルトではインストールされない
• 既存のインストールは、以前のバージョンのCitrix Workspaceアプリでインストールされており、新しいコンポーネントバージョンが利用可能な場合にアップグレード

WebEx VDIプラグインインストーラーエンジンをインストールするには、管理者は次のコマンドラインを使用します。

CitrixWorkspaceapp.exe ADDONS=WebexVDIPlugin

• 注：

  • サードパーティコンポーネントは、Citrix Workspaceアプリにパッケージ化されるのではなく、それぞれのサードパーティCDNから取得します。顧客は、オンラインおよびオフラインのCitrix Workspaceアプリパッケージの両方でコンポーネントのインストールを成功させるために、エンドポイントからの必要なネットワークアクセスを確保する必要があります

  • サードパーティコンポーネントのインストール失敗は、Citrix Workspaceアプリのインストールには影響しません

  • 失敗したコンポーネントは、インストーラーを再実行するか、アップグレード中に再インストール可能

  • Citrix Workspaceアプリは、Citrix Workspaceアプリのアンインストール時にサードパーティプラグインのアンインストールを管理しません

  • Citrix Workspaceアプリは、アップデート間でコンポーネントの選択を保持します。たとえば、インストール中にMicrosoft Teamsプラグインが選択解除された場合、以降のバージョンでは自動的にインストールされません

  • Citrixは、サードパーティコンポーネントの最新バージョンが利用可能になったときにそれらを受け取るために、Citrix Workspaceアプリの自動アップデートを有効にすることを推奨します

  • これらのプラグインはサードパーティ製ソフトウェアであり、Cloud Software Groupによって作成、開発、または管理されたものではありません。Cloud Software Groupは、いかなるサードパーティサービスまたはソフトウェアに対しても義務または責任を負いません。かかるソフトウェアをダウンロードおよび/または利用することにより、お客様は、かかるソフトウェアがCloud Software Groupによって「現状有姿」で、いかなる種類の保証もなく、利用可能な状態で提供されること、およびお客様のソフトウェアまたは関連資産へのアクセスおよび/または使用は、お客様自身の単独のリスクで行われることをここに認め、同意します。お客様は、かかるソフトウェアのそれぞれのサードパーティライセンスに準拠することを確認します

Citrix Casting™のインストール

重要：

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

• コマンド：IncludeCitrixCasting

• 説明：インストール中にCitrix Castingをインストール

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

UberAgentパラメーター

• コマンド：InstallUberAgent
• 説明：UberAgentアドオンは、Citrix Workspaceアプリの高度な監視と診断を提供し、ユーザーエクスペリエンスとアプリケーションパフォーマンスに関する詳細なインサイトを提供します。この統合は管理対象デバイスでのみ利用可能であり、展開を合理化し、管理オーバーヘッドを削減します。

次のコマンドラインインストールを使用します。

/InstallUberAgentコマンドを使用して、UberAgentプラグインをインストールまたはアップグレードします。 UberAgentが既に存在する場合に、アップグレードせずにプラグインをインストールするには、/InstallUberAgent /SkipUberAgentUpgradeコマンドを使用します。このオプションは、UberAgentの展開がCitrix Workspaceアプリとは別に管理されているVDAまたはデバイスに最適です。

注記:

• このコンポーネントはコマンドラインからのみインストールできます。

• Session Recordingエージェントのパラメーター

• コマンド: InstallSRAgent
• 説明: Session Recordingアドオンは、セッション監視機能をエンドポイントデバイスに直接拡張し、さまざまなアプリケーションおよびエンドポイント環境におけるユーザーアクティビティの包括的な監視を提供します。この統合により、展開が合理化され、管理オーバーヘッドの削減に役立ちます。

以下のコマンドラインインストールを使用します。

/InstallSRAgentコマンドを使用して、エンドポイントデバイス用のSession Recordingエージェントをインストールまたはアップグレードします。 Session Recordingエージェントがすでに存在する場合に、アップグレードせずにプラグインをインストールするには、/InstallSRAgent /SkipSRAgentUpgradeコマンドを使用します。このオプションは、Session Recordingエージェントの展開がCitrix Workspaceアプリとは別に管理されているデバイスに最適です。

注記:

このコンポーネントはコマンドラインからのみインストールできます。

Citrix Workspaceアプリx86インストーラーを使用している場合、インストールを完了するには、このマシンに.NET Desktop Runtime 8.0.15以降（8.xまで）のx64バージョンが必要です。

HDX機能のパラメーター

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

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

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

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

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

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

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

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

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

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

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

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

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

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

注記:

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

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

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

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

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

• コマンド: 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

Citrix Workspaceアプリ for Windowsバージョン2503以降、システムはデフォルトでSSONを休止モードでインストールします。インストール後にグループポリシーオブジェクト（GPO）ポリシーを使用してSSONを有効にできます。有効にするには、ユーザー認証 > ローカルユーザー名とパスワードに移動し、パススルー認証を有効にするチェックボックスを選択します。

注:

SSON設定を有効にするには、GPOポリシーを更新した後、システムを再起動する必要があります。

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のエラーメッセージ」を参照してください。
• システム関連のエラーコードについては、「システムエラーコード」を参照してください。

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

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

注：

Windows版Citrix Workspaceアプリ2311.1バージョン以降、TrolleyExpressはCWAInstaller-<日付とタイムスタンプ>に置き換えられます。たとえば、ログはC:\Program Files (x86)\Citrix\Logs\CTXWorkspaceInstallLogs-20231225-093441に記録されます。

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）管理用テンプレート構成。