インストールとアンインストール
-
Windows向けCitrix Workspaceアプリ1912 LTSRのインストール前の管理者向け注意事項
- Windows向けCitrix Workspaceアプリ1912 LTSRには、.NET Frameworkバージョン4.6.2以降が必要です。Citrix Workspaceアプリのインストーラーは、システムに.NET Frameworkが存在しない場合、これをダウンロードしてインストールします。ただし、Citrix Workspaceアプリをインストールまたは更新する前に、必要な.NET Frameworkを手動でインストールすることをお勧めします。
- サイレントインストールを試みる場合は、Knowledge Centerの記事CTX257546を参照してください。
Citrix Workspaceアプリは、ダウンロードページまたは会社のダウンロードページ（利用可能な場合）からCitrixWorkspaceApp.exeインストールパッケージをダウンロードしてインストールできます。パッケージは次の方法でインストールできます。
- 対話型のWindowsベースのインストールウィザードを実行する
- コマンドラインインターフェイスを使用して、インストーラーファイル名、インストールコマンド、およびインストールプロパティを入力する。コマンドラインインターフェイスを使用したCitrix Workspaceアプリのインストールについては、「コマンドラインパラメーターの使用」を参照してください。
管理者権限および非管理者権限でのインストール:
ユーザーと管理者の両方がCitrix Workspaceアプリをインストールできます。管理者権限は、Windows向けCitrix Workspaceアプリでパススルー認証およびCitrix Readyワークスペースハブを使用する場合にのみ必要です。
次の表は、Citrix Workspaceアプリが管理者またはユーザーとしてインストールされた場合の相違点を示しています。
| インストールフォルダー | インストールタイプ | |
|---|---|---|
| 管理者 | C:\Program Files (x86)\Citrix\ICA Client | システムごとのインストール |
| ユーザー | %USERPROFILE%\AppData\Local\Citrix\ICA Client | ユーザーごとのインストール |
注：
ユーザーがインストールしたWindows向けCitrix Workspaceアプリのインスタンスがシステムに存在し、管理者が同じシステムにWindows向けCitrix Workspaceアプリをインストールすると、競合が発生します。Citrixでは、管理者としてWindows向けCitrix Workspaceアプリをインストールする前に、ユーザーがインストールしたすべてのWindows向けCitrix Workspaceアプリのインスタンスをアンインストールすることをお勧めします。
Windowsベースのインストーラーの使用
Windows向けCitrix Workspaceアプリは、インストールメディア、ネットワーク共有、Windowsエクスプローラー、またはコマンドラインを使用して、CitrixWorkspaceApp.exeインストーラーパッケージを手動で実行することでインストールできます。
-
デフォルトでは、インストーラーログは
%temp%\CTXReceiverInstallLogs*.logsにあります。 -
-
CitrixWorkspaceApp.exeファイルを起動し、［開始］をクリックします。
-
-
- エンドユーザーライセンス契約を読み、同意して、インストールを続行します。
- 管理者権限を持つドメイン参加済みマシンにインストールを試みる場合、シングルサインオンを有効または無効にするための追加のダイアログが表示されます。詳細については、「ドメインパススルー認証」を参照してください。
-
- Windowsベースのインストーラーに従ってインストールを完了します。
-
コマンドラインパラメーターの使用
- Citrix Workspaceアプリは、コマンドラインインターフェイスからインストーラーファイル名、インストールコマンド、およびインストールプロパティを入力してインストールできます。コマンドラインオプションを指定することで、Citrix Workspaceアプリのインストーラーをカスタマイズできます。インストーラーパッケージは、セットアップを起動する前にシステムの一時フォルダーに自己解凍されます。必要なディスク容量には、複数のアプリケーションを起動した後のプログラムファイル、ユーザーデータ、および一時フォルダーが含まれます。
Windowsコマンドラインを使用してCitrix Workspaceアプリをインストールするには、コマンドプロンプトを起動し、インストーラーファイル名、インストールコマンド、およびインストールプロパティを1行で入力します。利用可能なインストールコマンドとプロパティは次のとおりです。
CitrixWorkspaceApp.exe [commands] [properties]
コマンドラインパラメーターの一覧
パラメーターは、大まかに次のように分類されます。
- 共通パラメーター
- インストールパラメーター
-
共通パラメーター
-
/?または/help- すべてのインストールコマンドとプロパティを一覧表示します。 -
/silent- インストール中にインストールダイアログとプロンプトを無効にします。 -
/noreboot- インストール中に再起動プロンプトダイアログを抑制します。再起動プロンプトを抑制すると、ユーザーデバイスが再起動されるまで、中断状態のUSBデバイスはCitrix Workspaceアプリによって認識されません。 -
/includeSSON- 管理者としてインストールする必要があります。Citrix Workspaceアプリがシングルサインオンコンポーネントとともにインストールされることを示します。詳細については、「ドメインパススルー認証」を参照してください。 -
/rcu- このスイッチは、サポートされていないバージョンのソフトウェアからアップグレードする場合にのみ有効です。Citrix Workspaceアプリが既存のバージョンをアンインストールしてインストールまたはアップグレードされることを示します。これにより、既存の設定もクリーンアップされます。注：
-
-
/rcuスイッチはバージョン1909以降非推奨です。詳細については、「非推奨」を参照してください。 -
/forceinstall- このスイッチは、次のシナリオでシステム上のCitrix Workspaceアプリの既存の構成またはエントリをクリーンアップする場合に有効です。- サポートされていないバージョンのCitrix Workspaceアプリからアップグレードしている場合。
- インストールまたはアップグレードが失敗した場合。
インストールパラメーター
/AutoUpdateCheck
Citrix Workspaceアプリが更新の利用可能性を検出することを示します。
- Auto（デフォルト） - 更新が利用可能になると通知されます。例：
CitrixWorkspaceApp.exe /AutoUpdateCheck=auto。 - Manual - 更新が利用可能になっても通知されません。手動で更新を確認します。例：
CitrixWorkspaceApp.exe /AutoUpdateCheck=manual。 - Disabled - 自動更新を無効にします。例：
CitrixWorkspaceApp.exe /AutoUpdateCheck=disabled。
/AutoUpdateStream
-
自動更新を有効にしている場合、更新するリリースストリームを選択できます。詳細については、「ライフサイクルマイルストーン」を参照してください。
- LTSR - 長期サービスリリース (LTSR) の累積更新プログラムのみに自動更新します。例:
CitrixWorkspaceApp.exe /AutoUpdateStream=LTSR。 - Current - Citrix Workspaceアプリの最新バージョンに自動更新します。例:
CitrixWorkspaceApp.exe /AutoUpdateStream=Current。
/DeferUpdateCount
-
更新プログラムが利用可能な場合に、更新通知を延期できる回数を示します。詳細については、「Citrix Workspaceの更新」を参照してください。
- -1（デフォルト） - 通知を任意の回数延期できます。例:
CitrixWorkspaceApp.exe /DeferUpdateCount=-1。 - 0 - 利用可能な更新プログラムごとに1回（のみ）通知を受け取ります。更新プログラムについて再度通知されることはありません。例:
CitrixWorkspaceApp.exe /DeferUpdateCount=0。 -
その他の数値「n」 - 更新通知を「n」回延期できます。「後で通知する」オプションが「n」回表示されます。例:
CitrixWorkspaceApp.exe /DeferUpdateCount=<n>。 -
/AURolloutPriority
アプリの新しいバージョンがリリースされると、Citrix®は特定の配信期間にわたって更新プログラムを展開します。このパラメーターを使用すると、配信期間中のどのタイミングで更新プログラムを受け取るかを制御できます。
- Auto（デフォルト） - Citrixによって構成された配信期間中に更新プログラムを受け取ります。例:
CitrixWorkspaceApp.exe /AURolloutPriority=Auto。 - Fast - 配信期間の開始時に更新プログラムを受け取ります。例:
CitrixWorkspaceApp.exe /AURolloutPriority=Fast。 - Medium - 配信期間の中頃に更新プログラムを受け取ります。例:
CitrixWorkspaceApp.exe /AURolloutPriority=Medium。 -
Slow - 配信期間の終わりに更新プログラムを受け取ります。例:
CitrixWorkspaceApp.exe /AURolloutPriority=Slow。 -
/includeappprotection
Citrix Virtual Apps and Desktops™およびCitrix DaaS（旧称Citrix Virtual Apps and Desktopsサービス）を使用する際に、クライアントがキーロギングや画面キャプチャマルウェアによって侵害される可能性を制限することで、セキュリティを強化します。
-
CitrixWorkspaceApp.exe /includeappprotection -
詳細については、「アプリ保護」を参照してください。
INSTALLDIR
- Citrix Workspaceアプリのカスタムインストールディレクトリを指定します。デフォルトのパスは
C:\Program Files\Citrixです。例:CitrixWorkspaceApp.exe INSTALLDIR=C:\Program Files\Citrix。
ADDLOCAL
- 指定されたコンポーネントを1つ以上インストールします。例:
CitrixWorkspaceapp.exe ADDLOCAL=ReceiverInside,ICA_Client,AM,SELFSERVICE,DesktopViewer,Flash,Vd3d,WebHelper,BrowserEngine,WorkspaceHub,USB。
HDX™機能のパラメーター
-
ALLOW_BIDIRCONTENTREDIRECTION -
クライアントからホストへ、およびホストからクライアントへの双方向コンテンツリダイレクトが有効になっていることを示します。詳細については、Citrix Virtual Apps and Desktopsドキュメントの「双方向コンテンツリダイレクトポリシー設定」セクションを参照してください。
- 0（デフォルト） - 双方向コンテンツリダイレクトが無効になっていることを示します。例:
CitrixWorkspaceApp.exe ALLOW_BIDIRCONTENTREDIRECTION=0。 - 1 - 双方向コンテンツリダイレクトが有効になっていることを示します。例:
CitrixWorkspaceApp.exe ALLOW_BIDIRCONTENTREDIRECTION=1。
FORCE_LAA
-
Citrix Workspaceアプリがクライアント側のローカルアプリアクセスコンポーネントとともにインストールされていることを示します。このコンポーネントが機能するには、管理者権限でCitrix Workspaceアプリをインストールする必要があります。詳細については、Citrix Virtual Apps and Desktopsドキュメントの「ローカルアプリアクセス」セクションを参照してください。
- 0（デフォルト） - ローカルアプリアクセスコンポーネントがインストールされていないことを示します。例:
CitrixWorkspaceApp.exe FORCE_LAA=0。 - 1 - クライアント側のローカルアプリアクセスコンポーネントがインストールされていることを示します。例:
CitrixWorkspaceApp.exe FORCE_LAA=1。
LEGACYFTAICONS
-
サブスクライブされたアプリケーションとファイルタイプ関連付けを持つドキュメントまたはファイルに、アプリケーションアイコンが表示されるかどうかを指定します。
- False（デフォルト） - サブスクライブされたアプリケーションとファイルタイプ関連付けを持つドキュメントまたはファイルに、アプリケーションアイコンが表示されることを示します。Falseに設定すると、オペレーティングシステムは特定のアイコンが割り当てられていないドキュメントのアイコンを生成します。オペレーティングシステムによって生成されるアイコンは、アプリケーションアイコンの小さいバージョンが重ねられた汎用アイコンです。例:
CitrixWorkspaceApp.exe LEGACYFTAICONS=False。 -
True - サブスクライブされたアプリケーションとファイルタイプ関連付けを持つドキュメントまたはファイルに、アプリケーションアイコンが表示されないことを示します。例:
CitrixWorkspaceApp.exe LEGACYFTAICONS=True。 -
ALLOW_CLIENTHOSTEDAPPSURL
ユーザーデバイスでURLリダイレクト機能を有効にします。詳細については、Citrix Virtual Apps and Desktopsドキュメントの「ローカルアプリアクセス」セクションを参照してください。
- 0（デフォルト） - ユーザーデバイスでURLリダイレクト機能を無効にします。例:
CitrixWorkspaceApp.exe ALLOW_CLIENTHOSTEDAPPSURL=0。 - 1 - ユーザーデバイスでURLリダイレクト機能を有効にします。例:
CitrixWorkspaceApp.exe ALLOW_CLIENTHOSTEDAPPSURL=1。
設定とユーザーインターフェイスのパラメーター
-
ALLOWADDSTORE -
指定されたパラメーターに基づいて、ストア（httpまたはhttps）を構成できます。
- S (デフォルト) - セキュアストア（HTTPSで構成）のみを追加または削除できます。例:
CitrixWorkspaceApp.exe ALLOWADDSTORE=S - A – セキュアストア（HTTPS）と非セキュアストア（HTTP）の両方を追加または削除できます。Citrix Workspaceアプリがユーザーごとにインストールされている場合は適用されません。例:
CitrixWorkspaceApp.exe ALLOWADDSTORE=A - N – ユーザーが自身のストアを追加または削除することを許可しません。例:
CitrixWorkspaceApp.exe ALLOWADDSTORE=N
ALLOWSAVEPWD
ストアの資格情報をローカルに保存できます。このパラメーターは、PNAgentプロトコルを使用するストアにのみ適用されます。
- S (デフォルト) - セキュアストア（HTTPSで構成）の場合にのみパスワードを保存できます。例:
CitrixWorkspaceApp.exe ALLOWSAVEPWD=S - N - パスワードの保存を許可しません。例:
CitrixWorkspaceApp.exe ALLOWSAVEPWD=N - A - セキュアストア（HTTPS）と非セキュアストア（HTTP）の両方でパスワードを保存できます。例:
CitrixWorkspaceApp.exe ALLOWSAVEPWD=A
STARTMENUDIR
スタートメニューのショートカットのフォルダーを指定します。
-
<ディレクトリ名>- デフォルトでは、アプリケーションは [スタート] > [すべてのプログラム] の下に表示されます。ショートカットの相対パスを\Programsフォルダーに指定できます。たとえば、ショートカットを [スタート] > [すべてのプログラム] > [Workspace] の下に配置するには、STARTMENUDIR=\Workspaceと指定します。
DESKTOPDIR
デスクトップ上のショートカットのフォルダーを指定します。
注:
DESKTOPDIRオプションを使用する場合は、
PutShortcutsOnDesktopキーをTrueに設定します。
-
<ディレクトリ名>- ショートカットの相対パスを指定できます。たとえば、ショートカットを [スタート] > [すべてのプログラム] > [Workspace] の下に配置するには、DESKTOPDIR=\Workspaceと指定します。
SELFSERVICEMODE
セルフサービスCitrix Workspaceアプリのユーザーインターフェイスへのアクセスを制御します。
- True - ユーザーがセルフサービスユーザーインターフェイスにアクセスできることを示します。例:
CitrixWorkspaceApp.exe SELFSERVICEMODE=True - False - ユーザーがセルフサービスユーザーインターフェイスにアクセスできないことを示します。例:
CitrixWorkspaceApp.exe SELFSERVICEMODE=False
ENABLEPRELAUNCH
セッションの事前起動を制御します。詳細については、アプリケーション起動時間を参照してください。
- True - セッションの事前起動が有効になっていることを示します。例:
CitrixWorkspaceApp.exe ENABLEPRELAUNCH=True - False - セッションの事前起動が無効になっていることを示します。例:
CitrixWorkspaceApp.exe ENABLEPRELAUNCH=False
DisableSetting
[詳細設定] シートに [ショートカットと再接続] オプションが表示されないようにします。詳細については、詳細設定シートから特定のオプションを非表示にするを参照してください。
- 0 (デフォルト) – [詳細設定] シートに [ショートカット] オプションと [再接続] オプションの両方を表示します。例:
CitrixWorkspaceApp.exe DisableSetting=0 - 1 – [詳細設定] シートに [再接続] オプションのみを表示します。例:
CitrixWorkspaceApp.exe DisableSetting=1 - 2 – [詳細設定] シートに [ショートカット] オプションのみを表示します。例:
CitrixWorkspaceApp.exe DisableSetting=2 - 3 – [詳細設定] シートから [ショートカット] オプションと [再接続] オプションの両方を非表示にします。例:
CitrixWorkspaceApp.exe DisableSetting=3
EnableCEIP
カスタマーエクスペリエンス向上プログラム（CEIP）への参加を示します。詳細については、CEIPを参照してください。
- True (デフォルト) - CEIPに参加します。例:
CitrixWorkspaceApp.exe EnableCEIP=True - False - CEIPからオプトアウトします。例:
CitrixWorkspaceApp.exe EnableCEIP=False
EnableTracing
Always-on tracing機能を制御します。
- True (デフォルト) - Always-on tracing機能を有効にします。例:
CitrixWorkspaceApp.exe EnableTracing=true - False - Always-on tracing機能を無効にします。例:
CitrixWorkspaceApp.exe EnableTracing=false
CLIENT_NAME
サーバーにユーザーデバイスを識別するために使用される名前を指定します。
-
<クライアント名>- サーバー上でユーザーデバイスを識別するために使用される名前を指定します。デフォルト名は%COMPUTERNAME%です。例:CitrixReceiver.exe CLIENT_NAME=%COMPUTERNAME%
ENABLE_DYNAMIC_CLIENT_NAME
クライアント名をコンピューター名と同じにすることを許可します。コンピューター名を変更すると、クライアント名も変更されます。
- はい (デフォルト) – クライアント名をコンピューター名と同じにすることを許可します。例:
CitrixWorkspaceApp.exe ENABLE_DYNAMIC_CLIENT_NAME=Yes。 - いいえ - クライアント名をコンピューター名と同じにすることを許可しません。
CLIENT_NAMEプロパティの値を指定する必要があります。例:CitrixWorkspaceApp.exe ENABLE_DYNAMIC_CLIENT_NAME=No。
認証パラメーター
ENABLE_SSON
Citrix Workspaceアプリが/includeSSONコマンドでインストールされている場合に、シングルサインオンを有効にします。詳しくは、ドメインパススルー認証を参照してください。
- はい (デフォルト) - シングルサインオンが有効であることを示します。例:
CitrixWorkspaceApp.exe /ENABLE_SSON=Yes。 - いいえ - シングルサインオンが無効であることを示します。例:
CitrixWorkspaceApp.exe /ENABLE_SSON=No。
ENABLE_KERBEROS
HDXエンジンがKerberos認証を使用する必要があるかどうかを指定します。これは、シングルサインオン認証が有効な場合にのみ適用されます。詳しくは、Kerberosを使用したドメインパススルー認証を参照してください。
- はい - HDXエンジンがKerberos認証を使用することを示します。例:
CitrixWorkspaceApp.exe ENABLE_KERBEROS=Yes。 - いいえ - HDXエンジンがKerberos認証を使用しないことを示します。例:
CitrixWorkspaceApp.exe ENABLE_KERBEROS=No。
上記のプロパティに加えて、Citrix Workspaceアプリで使用されるストアURLも指定できます。最大10個のストアを追加できます。そのためには、次のプロパティを使用します。
STOREx="storename;http[s]://servername.domain/IISLocation/discovery;[On, Off]; [storedescription]"
値:
- x - ストアを識別するために使用される0から9までの整数
- storename - ストアの名前。この値は、StoreFrontサーバーで構成されている名前と一致する必要があります
- servername.domain - ストアをホストするサーバーの完全修飾ドメイン名
- IISLocation - IIS内のストアへのパス。ストアURLは、StoreFrontプロビジョニングファイルのURLと一致する必要があります。ストアURLは
/Citrix/store/discoveryの形式です。URLを取得するには、StoreFrontからプロビジョニングファイルをエクスポートし、メモ帳で起動して、Address要素からURLをコピーします - [On, Off] - Offオプションを使用すると、無効なストアを配信し、ユーザーがそれらにアクセスするかどうかを選択できるようにします。ストアのステータスが指定されていない場合、デフォルト設定はOnです
- storedescription - ストアの説明。例:
HR App Store
コマンドラインインストール例
Citrix GatewayストアURLの指定:
CitrixWorkspaceApp.exe STORE0=HRStore;https://ag.mycompany.com#Storename;On;Store
ここで、Storenameは構成する必要があるストアの名前を示します。
注:
- この方法で構成されたCitrix GatewayストアURLは、Citrix Gatewayを使用しているPNA Servicesサイトをサポートしていません
- 複数のストアを構成する場合は、Citrix GatewayストアURLをリストの最初に配置します。Citrix GatewayストアURLの構成は1つのみ許可されます
すべてのコンポーネントをサイレントインストールし、2つのアプリケーションストアを指定する:
CitrixWorkspaceApp.exe /silent
STORE0="AppStore;https://testserver.net/Citrix/MyStore/discovery;on;HR App Store"
STORE1="BackUpAppStore;https://testserver.net/Citrix/MyBackupStore/discovery;on;Backup HR App Store"
注:
- パススルー認証を成功させるには、ストアURLに
/discoveryを含めることが必須です- Citrix GatewayストアURLは、構成されたストアURLのリストの最初の項目である必要があります
アンインストール
Windowsベースのアンインストーラーの使用:
Windowsのプログラムと機能ユーティリティ（プログラムの追加と削除）を使用して、Windows向けCitrix Workspaceアプリをアンインストールできます。
注:
Windows向けCitrix Workspaceアプリのインストールを続行する前に、Citrix HDX RTMEパッケージをアンインストールするよう求めるプロンプトが表示されます。[OK]をクリックしてアンインストールを続行します。
コマンドラインインターフェイスの使用:
コマンドラインからWindows向けCitrix Workspaceアプリをアンインストールするには、次のコマンドを入力します。
CitrixWorkspaceApp.exe /uninstall
Windows向けCitrix Workspaceアプリをサイレントアンインストールするには、次のスイッチを実行します。
CitrixWorkspaceApp.exe /silent /uninstall
注:
- receiver.adm/receiver.admlまたはreceiver.admxによって作成されたレジストリキーは、アンインストール後も残ります
- アンインストール後にレジストリエディターにエントリが見つかった場合は、手動で削除してください