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

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 ユーザーごとのインストール

注:

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

Windows向けインストーラーの使用

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

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

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

  1. CitrixWorkspaceApp.exeファイルを起動して [開始]をクリックします。
  2. EULAを読んで同意してから、インストールを続行します。
  3. 管理者権限でドメイン参加のマシンにインストールしようとすると、シングルサインオンのダイアログボックスが開きます。詳しくは、「[ドメインパススルー認証]」(/en-us/citrix-workspace-app-for-windows/authentication#domain-pass-through-authentication)を参照してください。
  4. Windows向けインストーラーの手順に従ってインストールを完了します。

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

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

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

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

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

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

CitrixWorkspaceApp.exe [commands] [properties]

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

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

一般的なパラメーター

  • /?または/help - すべてのインストールコマンドとプロパティを一覧表示します。
  • /silent - インストール中のインストールダイアログとプロンプトを無効にします。
  • /noreboot - インストール中に再起動のプロンプトを表示しません。再起動プロンプトを表示しない場合、一時停止状態だったUSBデバイスは認識されません。USBデバイスは、デバイスの再起動後にのみアクティブ化されます。
  • /includeSSON - 管理者としてインストールする必要があります。Citrix Workspaceアプリはシングルサインオンコンポーネントとともにインストールされます。詳しくは、「[ドメインパススルー認証]」(/en-us/citrix-workspace-app-for-windows/authentication#domain-pass-through-authentication)を参照してください。
  • /rcu - /rcuスイッチは、サポートされていないバージョンのソフトウェアからアップグレードする場合のみ有効です。既存のバージョンをアンインストールして、Citrix Workspaceアプリのインストールまたはアップグレードを行います。/rcuスイッチにより、既存の設定や古い設定も消去されます。

    注:

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

  • /forceinstall - このスイッチは、システム上のCitrix Workspaceアプリの既存の構成またはエントリをクリーンアップするときに役立ちます。このスイッチは、次のシナリオで使用します:

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

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

/AutoUpdateCheck

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

注:

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

  • Auto(デフォルト) - 更新が利用可能になると通知します。例:CitrixWorkspaceApp.exe /AutoUpdateCheck=auto
  • 手動 - 更新が利用可能になっても通知されません。手動で更新をチェックします。例:CitrixWorkspaceApp.exe /AutoUpdateCheck=manual
  • Disabled - 自動更新を無効にします。例:CitrixWorkspaceApp.exe /AutoUpdateCheck=disabled

/AutoUpdateStream

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

  • LTSR - 長期サービスリリース(LTSR)累積更新プログラム(CU)にのみ自動更新します。例: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

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

/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アプリのインストール時にReceiverInsideICA_Client、およびAMがインストールされます。

ADDLOCALにより、1つまたは複数の指定したコンポーネントがインストールされます。

ReceiverInside、ICA_Client、およびAMは必要なコンポーネントであり、Citrix Workspaceアプリのインストール時にデフォルトでインストールされます。

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

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

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

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のドキュメントで「[ローカルアプリアクセス]」(/en-us/citrix-virtual-apps-desktops/general-content-redirection/laa-url-redirect.html)を参照してください。

  • 0(デフォルト)- ローカルアプリアクセスのコンポーネントがインストールされていないことを示します。例:CitrixWorkspaceApp.exe FORCE_LAA =0
  • 1 - クライアント側ローカルアプリアクセスのコンポーネントがインストールされます。例:CitrixWorkspaceApp.exe FORCE_LAA =1

LEGACYFTAICONS

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

  • False(デフォルト)- サブスクライブするアプリケーションに関連付けられているファイルタイプのドキュメントまたはファイルに、そのアイコンが表示されます。Falseに設定すると、特定のアイコンが割り当てられていないドキュメントのアイコンがオペレーションシステムで生成されます。生成されたアイコンでは、標準的なアイコン上にアプリケーションの小さいアイコンが重なって表示されます。例:CitrixWorkspaceApp.exe LEGACYFTAICONS=False
  • False(デフォルト)- サブスクライブするアプリケーションに関連付けられているファイルタイプのドキュメントまたはファイルに、そのアイコンが表示されません。例:CitrixWorkspaceApp.exe LEGACYFTAICONS=True

ALLOW_CLIENTHOSTEDAPPSURL

ユーザーデバイスのURLリダイレクト機能を有効にします。詳しくは、Citrix Virtual Apps and Desktopsのドキュメントで「[ローカルアプリアクセス]」(/en-us/citrix-virtual-apps-desktops/general-content-redirection/laa-url-redirect.html)を参照してください。

  • 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アプリのユーザーインターフェイスに対するアクセスを制御します。

  • True - ユーザーはセルフサービスのユーザーインターフェイスにアクセスできます。例:CitrixWorkspaceApp.exe SELFSERVICEMODE=True
  • False - ユーザーはセルフサービスのユーザーインターフェイスにアクセスできません。例:CitrixWorkspaceApp.exe SELFSERVICEMODE=False

ENABLEPRELAUNCH

セッションの事前起動を制御します。詳しくは、「[アプリケーションの起動時間]」(/en-us/citrix-workspace-app-for-windows/configure.html#application-launch-time)を参照してください。

  • 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(デフォルト)- カスタマーエクスペリエンス向上プログラム(CEIP)にオプトインします。例:CitrixWorkspaceApp.exe EnableCEIP=True
  • False - カスタマーエクスペリエンス向上プログラム(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コマンドでインストールされた場合、シングルサインオンを有効にします。詳しくは、「[ドメインパススルー認証]」(/en-us/citrix-workspace-app-for-windows/authentication#domain-pass-through-authentication)を参照してください。

  • Yes(デフォルト)- シングルサインオンが有効になっています。例:CitrixWorkspaceApp.exe ENABLE_SSON=Yes
  • No - シングルサインオンが無効になっています。例:CitrixWorkspaceApp.exe ENABLE_SSON=No

ENABLE_KERBEROS

HDXエンジンでKerberos認証を使用する必要があるかどうかを指定します。シングルサインオン認証を有効にする場合のみ適用されます。詳しくは、「Kerberosを使用したドメインパススルー認証」を参照してください。

  • Yes - HDXエンジンがKerberos認証を使用する必要があることを示します。例:CitrixWorkspaceApp.exe ENABLE_KERBEROS=Yes
  • No - 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が一覧の先頭に表示される必要があります。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一覧で最初のエントリにする必要があります。

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

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

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

注:

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

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

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

アンインストール

Windows向けインストーラーの使用:

コントロールパネルの[プログラムと機能](または[プログラムの追加と削除])を使ってCitrix Workspaceアプリをアンインストールできます。

注:

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

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

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

CitrixWorkspaceApp.exe /uninstall

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

CitrixWorkspaceApp.exe /silent /uninstall

注:

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

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