Citrix Workspace app for Windows

更新

手動更新

Citrix Workspaceアプリ for Windowsをすでにインストールしている場合は、Citrixダウンロードページからアプリの最新バージョンをダウンロードしてインストールしてください。インストールについては、インストールとアンインストールを参照してください。

自動更新

Citrix Workspaceアプリの新しいバージョンが利用可能になると、CitrixはCitrix Workspaceアプリがインストールされているシステムに更新をプッシュします。

注:

  • SSLインターセプト型アウトバウンドプロキシを構成している場合は、Citrixから更新を受信するために、Workspace自動更新サーバー https://downloadplugins.citrix.com/ に例外を追加してください。
  • 自動更新は、Citrix Workspaceアプリ for Windows 2104およびCitrix Workspaceアプリ for Windows 1912 LTSR CU4より前のバージョンでは利用できません。
  • 更新を受信するには、システムがインターネットに接続されている必要があります。
  • Citrix Workspaceアプリ 2402 LTSR CU1 for Windows以降、自動更新ストリームはデフォルトでLTSRに設定されています。
  • デフォルトでは、Citrix Workspaceアプリの更新はVDAで無効になっています。これには、RDSマルチユーザーサーバーマシン、VDI、およびリモートPCアクセス マシンが含まれます。
  • Citrix Workspaceアプリの更新は、Desktop Lockがインストールされているマシンでは無効になっています。
  • Workspace for webユーザーは、StoreFrontポリシーを自動的にダウンロードできません。
  • Citrix Workspaceアプリの更新は、LTSR更新のみに制限できます。
  • Citrix HDX RTME for Windowsは、Citrix Workspaceアプリの更新に含まれています。LTSRおよびCitrix Workspaceアプリの現在のリリースの両方でHDX RTMEの更新が利用可能になると、通知が表示されます。
  • バージョン2105以降、Citrix Workspaceアプリの更新ログパスが変更されました。Workspace更新ログはC:\Program Files (x86)\Citrix\Logsにあります。ログ記録については、ログ収集セクションを参照してください。
  • 非管理者でも、管理者によってインストールされたインスタンスでCitrix Workspaceアプリを更新できます。これを行うには、通知領域のCitrix Workspaceアプリのアイコンを右クリックし、更新の確認を選択します。更新の確認オプションは、ユーザーがインストールしたインスタンスと管理者がインストールしたインスタンスの両方で利用できます。
  • プロキシ自動構成(PAC)およびWebプロキシ自動検出プロトコル(WPAD)の検出が有効になっている場合でも、自動更新を実行できます。これは、プロキシが認証に資格情報を必要とする場合にはサポートされません。
  • Non-EDCHE暗号スイートが追加されている場合、Citrix WorkspaceアプリはCitrix自動更新サーバーに到達できず、自動更新中に次のエラーが表示されます。

サーバーに接続できません

手動または自動更新後、Citrix Workspaceアプリ for Windowsを再起動してください。

デバイスにインストールされているCitrix Workspaceアプリの現在のバージョンは、高度な設定から、またはHKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\CitrixOnlinePluginPackWebの場所からDisplayVersionレジストリを照会することで確認できます。

高度な設定でバージョンを表示するには:

  1. 通知領域のCitrix Workspaceアプリのアイコンを右クリックします。
  2. 高度な設定を選択します。

    Citrix Workspaceアプリのバージョンは、バージョン情報セクションに表示されます。

Citrix Workspaceアプリベータプログラムのインストール

Citrix Workspaceアプリが自動更新用に構成されている場合、更新通知を受け取ります。システムにベータビルドをインストールするには、次の手順を実行します。

  1. システムトレイからCitrix Workspaceアプリを開きます。
  2. 高度な設定 > Citrix Workspaceの更新に移動します。
  3. ベータビルドが利用可能な場合は、ドロップダウンリストからベータを選択し、保存をクリックします。 通知ウィンドウが表示されます。
  • ベータチャネル更新通知

    1. OKをクリックしてベータビルドに更新します。

ベータビルドからリリースビルドに切り替えるには、次の手順を実行します。

    1. システムトレイからCitrix Workspaceアプリを開きます。
    1. 高度な設定 > Citrix Workspaceの更新に移動します。
    1. 更新設定画面で、更新チャネルドロップダウンリストからリリースを選択し、保存をクリックします。

    注:

    • 新しい更新が利用可能な場合、自動更新通知が表示されます。
    • ベータビルドは、お客様が非本番環境または限定的な本番環境でテストし、フィードバックを共有するために利用できます。Citrixはベータビルドのサポートケースを受け付けていませんが、改善のためのフィードバックを歓迎します。Citrixは、その重大度、重要性、および重要度に基づいてフィードバックに対応する場合としない場合があります。ベータビルドを本番環境に展開しないことをお勧めします。

VDAでのCitrix Workspaceアプリの自動更新のサポート

Citrix Workspaceアプリ for Windowsバージョン2209以降、VDAで自動更新機能を有効にできます。この機能を有効にするには、次のレジストリ値を作成する必要があります。

32ビットマシン:

  • レジストリキー:HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA Client\AutoUpdate
  • レジストリ値:AllowAutoUpdateOnVDA
  • レジストリの種類:REG_SZ
  • レジストリデータ:True

64ビットマシン:

  • レジストリキー:HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\AutoUpdate
  • レジストリ値:AllowAutoUpdateOnVDA
  • レジストリの種類:REG_SZ
    • レジストリデータ:True

自動更新のバージョン管理

管理者は、組織内のデバイスの自動更新バージョンを管理できるようになりました。

管理者は、Global App Config ServiceのmaximumAllowedVersionプロパティでバージョンを設定することにより、バージョンを制御できます。

Global App Config ServiceのJSONファイルの例:


{
  "category": "AutoUpdate",
  "userOverride": false,
  "assignedTo": [
    "AllUsersNoAuthentication"
  ],
  "settings": [
    {
      "name": "Auto Update plugins settings",
      "value": [
        {
          "pluginSettings": {
            "upgradeToLatest": false,
            "deploymentMode": "InstallAndUpdate",
            "stream": "Current",
            "maximumAllowedVersion": "23.03.0.49",
            "minimumAllowedVersion": "0.0.0.0",
            "delayGroup": "Fast"
          },
          "pluginName": "WorkspaceApp",
          "pluginId": "1CDF566D-B2C7-47CA-802F-6283C862E1D6"
        }
    -  ]
    -  }
  ]
}

<!--NeedCopy-->

{
  "category": "AutoUpdate",
  "userOverride": false,
  "assignedTo": [
    "AllUsersNoAuthentication"
  ],
    -  "settings": [
    -  {
-  "name": "Auto Update plugins settings",
      "value": [
        {
          "pluginSettings": {
            "upgradeToLatest": false,
            "deploymentMode": "InstallAndUpdate",
            "stream": "Current",
            "maximumAllowedVersion": "23.03.0.49",
            "minimumAllowedVersion": "0.0.0.0",
            "delayGroup": "Fast"
          },
          "pluginName": "WorkspaceApp",
          "pluginId": "1CDF566D-B2C7-47CA-802F-6283C862E1D6"
        }
      ]
    }
  ]
}

<!--NeedCopy-->
-  バージョンが設定されると、ユーザーデバイス上のCitrix Workspaceアプリは、`maximumAllowedVersion`プロパティで指定されたバージョンに自動的に更新されます。

注:

  • 現在、上記のJSONファイルに記載されているすべてのパラメーターは必須です。組織の要件に基づいて、upgradeToLatest設定とmaximumAllowedVersion設定の値を指定する必要があります。ただし、残りのパラメーターについては、例のJSONファイルと同様の値を使用できます。
    • 自動更新のバージョン管理を実現するには、Global App Config ServiceのupgradeToLatest設定をfalseに設定する必要があります。これがtrueの場合、maximumAllowedVersionは無視されます。
    • pluginIdはCitrix Workspaceアプリにマッピングされているため、変更しないでください。
    • 管理者がGlobal App Config Serviceでバージョンを構成していない場合、Citrix Workspaceアプリはデフォルトで利用可能な最新バージョンに更新されます。

自動更新の詳細構成(Citrix Workspace Updates)

Citrix Workspace Updatesは、次の方法で構成できます。

  1. グループポリシーオブジェクト(GPO)管理用テンプレート
  2. Global App Configurationサービス(GACS)
  3. コマンドラインインターフェイス
  4. GUI
  5. StoreFront

グループポリシーオブジェクト管理用テンプレートを使用したCitrix Workspace Updatesの構成

  1. gpedit.mscを実行してCitrix Workspaceアプリのグループポリシーオブジェクト管理用テンプレートを開き、[コンピューターの構成] ノードに移動します。
  2. [管理用テンプレート] > [Citrix Components] > [Citrix Workspace] > [Workspace Updates] に移動します。

    Workspace update

  3. 更新の有効化または無効化 – Workspace Updatesを有効または無効にするには、[有効] または [無効] を選択します。

    注:

    [無効] を選択すると、新しい更新の通知は行われません。また、[無効] オプションは、[高度な設定] シートからWorkspace Updatesオプションを非表示にします。

  4. 更新通知 – 更新が利用可能になったときに、自動的に通知を受け取るか、手動で確認するかを選択できます。Workspace Updatesを有効にした後、[Citrix Workspace Updateポリシーを有効にする] ドロップダウンリストから次のいずれかのオプションを選択します。
    • 自動 - 更新が利用可能になったときに通知されます(デフォルト)。これはCitrix Workspaceアプリ2207より前のバージョンにのみ適用されます。バージョン2207以降では、Citrix Workspaceアプリの更新は自動で行われ、更新が利用可能になったときに通知されません。
    • 手動 - 更新が利用可能になったときに通知されません。手動で更新を確認します。
  5. LTSRのみの更新を取得するには、[LTSRのみ] を選択します。
  6. [Citrix-Workspace-Update-DeferUpdate-Count] ドロップダウンリストから、-1から30までの値を選択します。

    • 値が0の場合、[後で通知する] オプションは表示されません。定期的な自動更新チェックのたびに、[更新が利用可能です] プロンプトが表示されます。
    • 値が-1の場合、[更新が利用可能です] プロンプトとともに[後で通知する] オプションが表示されます。更新通知を何度でも延期できます。
    • 1~30の値は、[更新が利用可能です] プロンプトとともに[後で通知する] オプションが表示される回数を定義します。このフィールドで定義された値に基づいて更新通知を延期できます。ただし、[更新が利用可能です] プロンプトは引き続き表示されますが、[後で通知する] オプションは表示されません。

    注:

    Citrix Workspaceアプリfor Windowsバージョン2207以降、自動更新機能が改善され、Citrix-Workspace-Update-DeferUpdate-Countフィールドは不要になりました。

更新チェックの遅延構成

Citrix Workspaceアプリの新しいバージョンが利用可能になると、Citrixは特定の配信期間中に更新を展開します。このプロパティを使用すると、配信期間のどの段階で更新を受け取るかを制御できます。

配信期間を構成するには、gpedit.mscを実行してグループポリシーオブジェクト管理用テンプレートを起動します。[コンピューターの構成] ノードで、[管理用テンプレート] > [Citrix Components] > [Citrix Workspace] > [更新チェックの遅延を設定する] に移動します。

Set update period

[有効] を選択し、[遅延グループ] ドロップダウンリストから次のいずれかを選択します。

-  **高速** – 配信期間の開始時に更新が展開されます。
  • 中速 – 配信期間の中間に更新が展開されます。
    • 低速 – 配信期間の終了時に更新が展開されます。

    • 注:

    • [無効] を選択すると、利用可能な更新の通知は行われません。また、[無効] オプションは、[高度な設定] シートからWorkspace Updatesオプションを非表示にします。

コマンドラインインターフェイスを使用したCitrix Workspace Updatesの構成

-  Citrix Workspaceアプリのインストール中にコマンドラインパラメーターを指定する場合:

Citrix Workspaceアプリのインストール中にコマンドラインパラメーターを指定することで、Workspace Updatesを構成できます。詳細については、「インストールパラメーター」を参照してください。

Citrix Workspaceアプリのインストール後にコマンドラインパラメーターを使用する場合:

-  Citrix Workspaceアプリfor Windowsのインストール後も、Citrix Workspace Updatesを構成できます。Windowsコマンドラインを使用して、`CitrixReceiverUpdater.exe`の場所に移動します。

通常、CitrixReceiverUpdater.exeCitrixWorkspaceInstallLocation\Citrix\Ica Client\Receiverにあります。CitrixReceiverUpdater.exeバイナリを、「インストールパラメーター」セクションに記載されているコマンドラインパラメーターとともに実行できます。

例えば、

CitrixReceiverUpdater.exe /AutoUpdateCheck=auto /AutoUpdateStream=Current /DeferUpdateCount=-1 /AURolloutPriority=fast

注:

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

グラフィカルユーザーインターフェイスを使用したCitrix Workspace Updatesの構成

個々のユーザーは、詳細設定ダイアログを使用してCitrix Workspace Updatesの設定を上書きできます。これはユーザーごとの構成であり、設定は現在のユーザーにのみ適用されます。

  1. 通知領域のCitrix Workspaceアプリのアイコンを右クリックします。
  2. 詳細設定 > Citrix Workspace Updatesを選択します。
  3. 次の通知設定オプションのいずれかを選択します。

    • はい、通知する - Citrix Workspaceアプリのアップデートが利用可能になったときに通知されます。
    • いいえ、通知しない - Citrix Workspaceアプリのアップデートが利用可能になっても通知されません。手動でアップデートを確認してください。
    • 管理者指定の設定を使用する - StoreFrontサーバーで構成された設定を使用します。

      設定シート

  4. 保存をクリックします。

注:

  • はい、通知するおよびいいえ、通知しないオプションは、Citrix Workspaceアプリ2207より前のバージョンにのみ適用されます。バージョン2207以降では、Citrix Workspaceアプリのアップデートは自動で行われ、アップデートが利用可能になっても通知されません。いいえ、通知しないオプションを選択した場合、手動でアップデートを確認してください。
  • Citrix Workspaceアプリのアイコンから利用できる詳細設定シートのすべてまたは一部を非表示にできます。詳細については、「詳細設定シート」セクションを参照してください。

StoreFrontを使用したCitrix Workspace Updatesの構成

  1. テキストエディターを使用して、通常 C:\inetpub\wwwroot\Citrix\Roaming directory にある web.config ファイルを開きます。

  2. ファイル内でユーザーアカウント要素を見つけます(Storeは展開のユーザーアカウント名です)。

    例えば、<account id=... name="Store">

    </account> タグの前に、そのユーザーアカウントのプロパティに移動します。

    <properties>
           <clear/>
     </properties>
     <!--NeedCopy-->
    
  3. <clear /> タグの後に自動アップデートタグを追加します。

    <account>
    
        <clear />
    
        <account id="d1197d2c-ac82-4f13-9346-2ee14d4b0202" name="F84Store"
    
          description="" published="true" updaterType="Citrix" remoteAccessType="None">
    
          <annotatedServices>
    
            <clear />
    
            <annotatedServiceRecord serviceRef="1__Citrix_F84Store">
    
              <metadata>
    
                <plugins>
    
                  <clear />
    
                </plugins>
    
                <trustSettings>
    
                  <clear />
    
                </trustSettings>
    
                <properties>
    
                  <property name="Auto-Update-Check" value="auto" />
    
                  <property name="Auto-Update-DeferUpdate-Count" value="1" />
    
                          <property name="Auto-Update-LTSR-Only" value="FALSE" />
    
                  <property name="Auto-Update-Rollout-Priority" value="fast" />
    
                        </properties>
    
              </metadata>
    
            </annotatedServiceRecord>
    
          </annotatedServices>
    
          <metadata>
    
            <plugins>
    
              <clear />
    
            </plugins>
    
            <trustSettings>
    
              <clear />
    
            </trustSettings>
    
            <properties>
    
              <clear />
    
            </properties>
    
          </metadata>
    
        </account>
    
    <!--NeedCopy-->
    

プロパティとその可能な値の意味は次のとおりです。

  • Auto-update-Check: Citrix Workspaceアプリが利用可能なアップデートを自動的に検出することを示します。

    • Auto (デフォルト) – アップデートを自動的に確認し、実行します。
    • Manual – アップデートは、ユーザーがCitrix Workspaceアプリのシステムトレイメニューから確認要求を行った場合にのみ取得されます。
    • Disabled – アップデートの確認は実行されません。
  • Auto-update-LTSR-Only: アップデートがLTSR専用であることを示します。

    • True – アップデーターは、LTSR有効としてマークされていないアップデートを無視します。LTSRアップデートのみが考慮されます。
    • False (デフォルト) – アップデーターは現在のストリームのアップデートのみを考慮します。
  • Auto-update-Rollout-Priority: アップデートを受け取ることができる配信期間を示します。

    • Fast – 配信期間の開始時にユーザーにアップデートが展開されます。
    • Medium – 配信期間の中頃にユーザーにアップデートが展開されます。
    • Slow – 配信期間の終わりにユーザーにアップデートが展開されます。
  • Auto-update-DeferUpdate-Count: アップデートの通知を延期できる回数を示します。

    注:

    この構成は、対話型アップデートにのみ適用され、サイレント自動アップデート機能が有効になっている場合は適用されません。これは、ユーザーがアップデートを延期するオプションを持たないためです。

    • -1: ユーザーは自動アップデートを何度でも延期できます。
    • 0: ユーザーは後で通知するオプションを表示できません。
    • number: ユーザーは指定された回数で後で通知するオプションを表示できます。
更新