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

• Citrix Workspaceアプリは、次のいずれかの方法でインストールできます。

• ダウンロードページからCitrixWorkspaceApp.exeインストールパッケージをダウンロードする
• 会社のダウンロードページから（利用可能な場合）。

次の手順でパッケージをインストールできます。

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

管理者権限と非管理者権限でのインストール:

ユーザーと管理者の両方がCitrix Workspaceアプリをインストールできます。管理者権限は、Windows向けCitrix Workspaceアプリでパススルー認証とCitrix Ready Workspace Hubを使用する場合にのみ必要です。

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

• | — |–| –|

• 管理者

  C:\Program Files (x86)\Citrix\ICA Client

  システムごとのインストール

• ユーザー

  %USERPROFILE%\AppData\Local\Citrix\ICA Client

  ユーザーごとのインストール

注：

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

Windowsベースのインストーラーの使用

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

• インストールメディア
• ネットワーク共有
• Windowsエクスプローラー
• コマンドラインインターフェイス

デフォルトでは、インストーラーログは%temp%\CTXReceiverInstallLogs*.logsにあります。

1. CitrixWorkspaceApp.exeファイルを起動し、［開始］をクリックします。

• 1. EULAを読んで同意し、インストールを続行します。
• 1. 管理者権限を持つドメイン参加済みマシンにインストールする場合、シングルサインオンダイアログが表示されます。詳細については、「ドメインパススルー認証」を参照してください。
• 1. Windowsベースのインストーラーに従ってインストールを完了します。

• インストールが完了すると、Citrix Workspaceアプリはアカウントの追加を要求します。アカウントの追加方法については、「アカウントの追加またはサーバーの切り替え」を参照してください。

• コマンドラインパラメーターの使用

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

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

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

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

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

CitrixWorkspaceApp.exe [commands] [properties]

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

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

-  [共通パラメーター](/ja-jp/citrix-workspace-app-for-windows/install.html#common-parameters)

• インストールパラメーター
• HDX機能パラメーター
• 設定とユーザーインターフェイスパラメーター
• 認証パラメーター

共通パラメーター

• /?または/help - すべてのインストールコマンドとプロパティを一覧表示します。
• /silent - インストール中のダイアログとプロンプトを無効にします。
• /noreboot - インストール中の再起動プロンプトを抑制します。再起動プロンプトを抑制すると、中断状態のUSBデバイスは認識されません。USBデバイスは、デバイスが再起動された後にのみアクティブになります。
• /includeSSON - 管理者としてインストールする必要があります。Citrix Workspaceアプリがシングルサインオンコンポーネントとともにインストールされることを示します。詳細については、「ドメインパススルー認証」を参照してください。
• /rcu - /rcuスイッチは、サポートされていないバージョンのソフトウェアからアップグレードする場合にのみ有効です。Citrix Workspaceアプリのインストールまたはアップグレードが、既存のバージョンをアンインストールすることによって行われることを示します。/rcuスイッチは、既存または古い設定もクリーンアップします。

• 注：

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

• /forceinstall - このスイッチは、システム内のCitrix Workspaceアプリの既存の構成またはエントリをクリーンアップする場合に有効です。このスイッチは、次のシナリオで使用します。

  • サポートされていないバージョンのCitrix Workspaceアプリバージョンからアップグレードする場合。
  • インストールまたはアップグレードが失敗した場合。

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

「/AutoUpdateCheck」

Citrix Workspaceアプリが更新の利用可能性を検出することを示します。

注：

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

• Auto（デフォルト） - 更新が利用可能になると通知されます。例：CitrixWorkspaceApp.exe /AutoUpdateCheck=auto。
• Manual - 更新が利用可能になっても通知されません。手動で更新を確認します。例：CitrixWorkspaceApp.exe /AutoUpdateCheck=manual。

• Disabled - 自動更新を無効にします。例：CitrixWorkspaceApp.exe /AutoUpdateCheck=disabled。

• 「/AutoUpdateStream」

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

• LTSR - Long Term Service Releaseの累積更新プログラムにのみ自動更新します。例：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

キーロギングや画面キャプチャマルウェアによるクライアントの侵害を制限することで、セキュリティを強化します。

• CitrixWorkspaceApp.exe /includeappprotection

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

• /InstallEmbeddedBrowser

• Citrix Enterprise Browserのバイナリを除外します。Citrix Enterprise Browser機能を無効にするには、/InstallEmbeddedBrowser=Nスイッチを実行します。

INSTALLDIR

Citrix Workspaceアプリのカスタムインストールディレクトリを指定します。デフォルトのパスはC:\Program Files\Citrixです。例: CitrixWorkspaceApp.exe INSTALLDIR=C:\Program Files\Citrix

ADDLOCAL

指定されたコンポーネントを1つ以上インストールします。例: CitrixWorkspaceapp.exe ADDLOCAL=ReceiverInside,ICA_Client,AM,SSON,SELFSERVICE,DesktopViewer,WebHelper,WorkspaceHub,USB,AppProtection

注:

• デフォルトでは、Citrix Workspaceアプリのインストール時にReceiverInside、ICA_Client、およびAMがインストールされます。

ADDLOCALは、指定されたコンポーネントを1つ以上インストールします。

• ReceiverInside、ICA_Client、およびAMは前提条件であり、Citrix Workspaceアプリのインストール時にデフォルトでインストールされます。

• ReceiverInside – Citrix Workspaceアプリのエクスペリエンス（必須）、システムトレイおよび自動更新の機能をインストールします。
• ICA_Client – HDX™コンポーネントをインストールします。

• AM – Authentication Managerコンポーネントをインストールします。

• 要件と環境に応じて、次のモジュールもインストールできます。

• SSON – シングルサインオンに必要なコンポーネントをインストールします。
• SELFSERVICE – セルフサービスプラグインをインストールします。これにより、Citrix Workspaceアプリウィンドウまたはコマンドラインから仮想デスクトップおよびアプリケーションにアクセスできます。SELFSERVICEがインストールされていない場合、Web（Receiver for Web）経由でアプリケーションおよびデスクトップにアクセスできます。
• DesktopViewer – 仮想アプリおよびデスクトップを表示するためのDesktop Viewerをインストールします。
• WebHelper: WebHelperコンポーネントをインストールします。このコンポーネントは、StoreFrontからICAファイルを取得し、HDX Engineに渡します。また、環境パラメーターを検証し、StoreFrontと共有します。このコンポーネントは、ブラウザー経由でのセッション起動時に使用されます。
• WorkspaceHub: Citrix Castingを有効にするCitrix Readyワークスペースハブコンポーネント。
• USB – USBサポートをインストールします。
• AppProtection: App Protectionコンポーネントをインストールします。

HDX機能パラメーター

• ALLOW_BIDIRCONTENTREDIRECTION

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

• 0 (デフォルト) – 双方向コンテンツリダイレクトが無効になっていることを示します。例: CitrixWorkspaceApp.exe ALLOW_BIDIRCONTENTREDIRECTION=0
• 1 - 双方向コンテンツリダイレクトが有効になっていることを示します。例: CitrixWorkspaceApp.exe ALLOW_BIDIRCONTENTREDIRECTION=1

FORCE_LAA

• Citrix Workspaceアプリがクライアント側のローカルアプリアクセスコンポーネントとともにインストールされていることを示します。このコンポーネントが機能するには、管理者権限で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

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

ストアの資格情報をローカルに保存できます。このパラメーターは、Citrix Workspace アプリプロトコルを使用するストアにのみ適用されます。

• S (デフォルト) - セキュアなストア (HTTPS で構成) のみパスワードを保存できます。例: CitrixWorkspaceApp.exe ALLOWSAVEPWD=S
• N - パスワードの保存を許可しません。例: CitrixWorkspaceApp.exe ALLOWSAVEPWD=N

• A - セキュアなストア (HTTPS) と非セキュアなストア (HTTP) の両方でパスワードを保存できます。例: CitrixWorkspaceApp.exe ALLOWSAVEPWD=A

• STARTMENUDIR

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

スタートメニューのショートカットのディレクトリを指定します。

• <Directory Name> - デフォルトでは、アプリケーションは スタート > すべてのプログラム の下に表示されます。\Programs フォルダー内のショートカットの相対パスを指定できます。たとえば、ショートカットを スタート > すべてのプログラム > Workspace の下に配置するには、STARTMENUDIR=\Workspace と指定します。

DESKTOPDIR

デスクトップ上のショートカットのディレクトリ

• デスクトップ上のショートカットのディレクトリを指定します。

注：

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

• <Directory Name> - ショートカットの相対パスを指定できます。たとえば、ショートカットを スタート > すべてのプログラム > Workspace の下に配置するには、DESKTOPDIR=\Workspace と指定します。

SELFSERVICEMODE

セルフサービス Citrix Workspace アプリユーザーインターフェイスへのアクセス

セルフサービス 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」を参照してください。

• True (デフォルト) - Citrix カスタマーエクスペリエンス向上プログラム (CEIP) に参加します。例: CitrixWorkspaceApp.exe EnableCEIP=True
• False - Citrix カスタマーエクスペリエンス向上プログラム (CEIP) からオプトアウトします。例: CitrixWorkspaceApp.exe EnableCEIP=False

EnableTracing

常時トレース機能の制御

常時トレース機能を制御します。

• True (デフォルト) - 常時トレース機能を有効にします。例: CitrixWorkspaceApp.exe EnableTracing=true
• False - 常時トレース機能を無効にします。例: CitrixWorkspaceApp.exe EnableTracing=false

CLIENT_NAME

サーバーへのユーザーデバイスの識別名

サーバーにユーザーデバイスを識別するために使用される名前を指定します。

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

ENABLE_DYNAMIC_CLIENT_NAME

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

クライアント名をコンピューター名と同じにすることができます。コンピューター名を変更すると、クライアント名も変更されます。

• Yes (デフォルト) - クライアント名をコンピューター名と同じにすることを許可します。例: CitrixWorkspaceApp.exe ENABLE_DYNAMIC_CLIENT_NAME=Yes
• No - クライアント名をコンピューター名と同じにすることを許可しません。CLIENT_NAME プロパティの値を指定します。例: CitrixWorkspaceApp.exe ENABLE_DYNAMIC_CLIENT_NAME=No

認証パラメーター

ENABLE_SSON

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

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

• Yes (デフォルト) - シングルサインオンが有効になっていることを示します。例: CitrixWorkspaceApp.exe ENABLE_SSON=Yes
• No - シングルサインオンが無効になっていることを示します。例: 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
<!--NeedCopy-->

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

注：

• この方法で構成されたCitrix GatewayストアURLは、Citrix Gatewayを使用しているPNAサービスサイトをサポートしていません
• マルチストア設定では、Citrix GatewayストアURLがリストの最初に必要です。1つのCitrix GatewayストアURL構成のみが許可されます

すべてのコンポーネントをサイレントインストールし、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のリストで最初の項目である必要があります

Citrix Workspaceアプリのリセット

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

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

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

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

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

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

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

注：

• パラメーターでは大文字のUを使用します

Citrix Workspaceアプリのリセットは、次の項目には影響しません。

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

アンインストール

Windowsベースのアンインストーラーの使用:

Windowsのプログラムと機能ユーティリティ（プログラムの追加と削除）を使用して、Citrix Workspaceアプリをアンインストールできます。

注：

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

コマンドラインインターフェイスの使用:

コマンドラインから次のコマンドを入力して、Citrix Workspaceアプリをアンインストールできます。

CitrixWorkspaceApp.exe /uninstall

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

CitrixWorkspaceApp.exe /silent /uninstall

注：

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