

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ユーザーの WorkSpaces クライアントエクスペリエンスを制御する
<a name="control-client-experience"></a>

2026 年 8 月 25 日以降、Amazon WorkSpaces は、シンプルな接続フロー、easier-to-find設定とセッションツール、より便利なエラーメッセージ、新しい Session Health 機能を備えた、使いやすいように設計されたインターフェイスが更新された新しい WorkSpaces Windows クライアントを導入します。

新しいエクスペリエンス (このドキュメントの残りの部分では「新規」と呼ばれます) は、バージョン 5.34 以降のクライアントアプリケーションインストーラパッケージに含まれ、現在のエクスペリエンス (「クラシック」と呼ばれます) と一緒にインストールおよび実行されます。

デフォルトでは、Amazon WorkSpaces Windows クライアントのエンドユーザーは、接続する WorkSpace を選択した後に新しいエクスペリエンスを「試す」オプションが表示されます。このオプションをクリックすると、何を期待するかを説明する確認ダイアログが表示され、続行すると従来のエクスペリエンスは閉じ、新しいエクスペリエンスは数秒以内に開きます。同様に、新しいエクスペリエンスでは、いつでも「クラシックに戻す」オプションが表示されます。デフォルトの動作を許可することを強くお勧めしますが、エンドユーザーの新しいクライアントエクスペリエンスのロールアウトを管理する必要がある場合に備えて、クライアントエクスペリエンスポリシー機能を導入しています。

管理者は、 クライアントエクスペリエンスポリシーを使用して、ユーザーが表示するエクスペリエンスと、ユーザーが 2 つのエクスペリエンスを切り替えることができるかどうかを制御できます。ポリシーが利用可能になりました。これにより、新しいエクスペリエンスをユーザーにロールアウトする方法を決定し、新しいクライアントが起動する前に必要な動作を配置できます。

このトピックでは、使用可能なポリシー値、WorkSpaces API または Windows レジストリを使用してポリシーを設定する方法、およびユーザーが接続するときにクライアントがポリシーを解決する方法について説明します。

**注記**  
クラシックエクスペリエンスは、PCoIP ベースの WorkSpaces と WorkSpaces Pools に接続するために必要であり、それぞれのサポート終了通知 ([PCoIP](workspaces-pcoip-end-of-support.md) と [WorkSpaces Pools](wsp-pools-end-of-support.md)) に従って引き続きサポートされます。

## クライアントエクスペリエンスポリシーの仕組み
<a name="client-experience-policy-how"></a>

クライアントエクスペリエンスポリシーは、ユーザーが WorkSpace に接続するときに表示するクライアントエクスペリエンスと、エクスペリエンスを切り替えるオプションを使用できるかどうかを決定します。

ポリシーは 2 つのレベルで設定できます。
+ **[オプション 1: ディレクトリごと、WorkSpaces API 経由](#client-experience-policy-api)** — ディレクトリに登録されている WorkSpaces に接続するすべてのユーザーに適用されます。`ModifyClientProperties` API オペレーションを使用してこれを設定します。これは、クライアントマシンを管理する必要がないため、ほとんどの管理者に推奨される方法です。
+ **[オプション 2: マシンごと、Windows レジストリ経由](#client-experience-policy-registry)** — 特定の Windows マシンのすべてのユーザーに適用されます。グループポリシー (GPO) または SCCM などの設定管理ツールを使用して、これをデプロイします。クライアントデバイスを一元管理し、マシンレベルの制御が必要な場合は、この方法を使用します。

アクションを実行しない場合、ポリシーはデフォルトで になります`USER_CHOICE`。Amazon WorkSpaces Windows クライアントバージョン 5.34 以降を使用するエンドユーザーは、デフォルトでクラシックエクスペリエンスになりますが、クライアントの「Try out」オプションをクリックして、新しいエクスペリエンス自体をオプトインできます。

## ポリシー値
<a name="client-experience-policy-values"></a>

クライアントエクスペリエンスポリシーでは、次の値を使用できます。


| 値 | 動作 | ユーザーは切り替えることができますか? | 
| --- | --- | --- | 
| `FORCE_CLASSIC` | ユーザーには、常にクラシックエクスペリエンスが表示されます。 | いいえ — スイッチオプションは非表示です。 | 
| `FORCE_UI_2026` | ユーザーには、常に新しいエクスペリエンスが表示されます。 | いいえ — スイッチオプションは非表示です。 | 
| `USER_CHOICE` | ユーザーは使用するエクスペリエンスを選択し、自由に切り替えることができます。 | はい — スイッチオプションが表示されます。 | 

**重要**  
PCoIP ベースの WorkSpaces または WorkSpaces Pools に接続する必要があるエンドユーザーがいる場合、新しいクライアントエクスペリエンスはこれらのサービスをサポートしていないため、 `FORCE_UI_2026`オプションを使用しないことをお勧めします。このシナリオでは、 値を に設定する`USER_CHOICE`と、これらのサービスを使用していないエンドユーザーは新しいクライアントエクスペリエンスにオプトインできますが、PCoIP および WorkSpaces Pools のユーザーは引き続き従来のクライアントエクスペリエンスを使用できます。

## ポリシー解決の順序
<a name="client-experience-policy-resolution"></a>

ユーザーが接続する WorkSpace を選択すると、クライアントは次の順序で各ソースをチェックして有効なポリシーを解決します。値が設定された最初のソースが優先され、優先度の低いすべてのソースよりも優先されます。API もレジストリも値が設定されていない場合、クライアントはデフォルトの`USER_CHOICE`動作を適用します。

1. **一元化ポリシー (WorkSpaces API)** — で設定したディレクトリごとのポリシー`ModifyClientProperties`。

1. **ローカルマシンポリシー (HKLM レジストリ)** — GPO または SCCM を介してデプロイするマシンごとのポリシー。

1. **ユーザー設定** — ユーザーが最後に選択したエクスペリエンス (有効なポリシーが の場合にのみ適用され`USER_CHOICE`、ポリシーが設定されていない場合はデフォルトです）。

1. **クライアントバージョンのデフォルト** — クライアントビルドでハードコードされたエクスペリエンス (次の表を参照）。


| クライアントバージョン | デフォルトのエクスペリエンス | サポートされているエクスペリエンス | 
| --- | --- | --- | 
| 5.33 以前 | Classic | Classic のみ (新しいエクスペリエンスはサポートされていません) | 
| 5.34 以降 | Classic | クラシックと新しい | 

**注記**  
クライアントバージョン 5.33 以前では、新しいエクスペリエンスはサポートされず、ポリシーは無視されます。これらのバージョンのユーザーには、常にクラシックエクスペリエンスが表示されます。

## ポリシーが有効になるとき
<a name="client-experience-policy-when"></a>

クライアントは、ユーザーが接続する WorkSpace を選択した後、サインインする前に、セッション前のフェーズでポリシーを適用します。エクスペリエンスを切り替えるには、クライアントの再起動が必要です。解決されたエクスペリエンスが現在実行中のエクスペリエンスと異なる場合、クライアントは選択した WorkSpace への接続を続行するためにクライアントを再起動するようユーザーに求めます。アクティブなセッション中、ポリシーは評価されません。ユーザーが接続されているときにポリシーを変更すると、その変更は次回クライアントを起動したとき、またはユーザーがサインアウトして再度ログインしたときに有効になります。

## オプション 1: WorkSpaces API を使用してポリシーを設定する
<a name="client-experience-policy-api"></a>

[`ModifyClientProperties`](https://docs.aws.amazon.com/workspaces/latest/api/API_ModifyClientProperties.html) API オペレーションを使用して、ディレクトリのポリシーを設定します。`ClientExperiencePolicy` フィールドは [`ClientProperties`](https://docs.aws.amazon.com/workspaces/latest/api/API_ClientProperties.html) オブジェクトの一部です。

**注記**  
起動時に、この設定は AWS CLI および SDKsでのみ使用できます。WorkSpaces コンソールのサポートは、今後の更新が予定されています。

### AWS CLI 例
<a name="client-experience-policy-cli-example"></a>

次のコマンドは、ディレクトリのポリシーを に設定し`USER_CHOICE`、ユーザーが自分のエクスペリエンスを選択できるようにします。

```
aws workspaces modify-client-properties \
    --resource-id d-1234567890 \
    --client-properties ClientExperiencePolicy=USER_CHOICE
```

ディレクトリ内のすべてのユーザーを新しいエクスペリエンスに強制するには:

```
aws workspaces modify-client-properties \
    --resource-id d-1234567890 \
    --client-properties ClientExperiencePolicy=FORCE_UI_2026
```

### 現在のポリシーを表示する
<a name="client-experience-policy-view"></a>

`DescribeClientProperties` API オペレーションを使用して、ディレクトリに現在設定されているポリシーを表示します。

```
aws workspaces describe-client-properties \
    --resource-ids d-1234567890
```

ポリシーが設定されている場合、レスポンスには `ClientExperiencePolicy`フィールドが含まれます。ディレクトリにポリシーが設定されていない場合、 フィールドは省略され、クライアントはマシンレベルのレジストリポリシー (設定されている場合) またはデフォルトの`USER_CHOICE`動作に戻ります。

```
{
    "ClientPropertiesList": [
        {
            "ResourceId": "d-1234567890",
            "ClientProperties": {
                "ReconnectEnabled": "ENABLED",
                "LogUploadEnabled": "ENABLED",
                "ClientExperiencePolicy": "USER_CHOICE"
            }
        }
    ]
}
```

**注意事項**  
設定後に`ClientExperiencePolicy`値をクリアすることはできません。デフォルトの動作を復元するには、値を に設定します`USER_CHOICE`。
認識されない値を送信すると、API は を返します`InvalidParameterValuesException`。

## オプション 2: Windows レジストリを使用してポリシーを設定する
<a name="client-experience-policy-registry"></a>

クライアントマシンを一元管理する場合は、次のレジストリ値を使用してマシンごとのポリシーを設定できます。グループポリシーまたは設定管理ツールを使用してデプロイします。

```
Path:  HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\Amazon WorkSpaces Client
Name:  ClientExperiencePolicy
Type:  REG_SZ
Value: FORCE_CLASSIC | FORCE_UI_2026 | USER_CHOICE
```

このレジストリパスは、 `clientUpgradeDisabled`や などの他の WorkSpaces クライアントマシン設定と一致しています`WSUseDualStackIPv6`。

昇格されたコマンドプロンプトから値を設定するには、次のコマンドを使用します。この例では、新しいエクスペリエンスを強制します。

```
reg add "HKLM\SOFTWARE\Amazon\Amazon WorkSpaces Client" /v ClientExperiencePolicy /t REG_SZ /d FORCE_UI_2026 /f
```

値を削除するには:

```
reg delete "HKLM\SOFTWARE\Amazon\Amazon WorkSpaces Client" /v ClientExperiencePolicy /f
```

レジストリポリシーは、ユーザーが接続するディレクトリにディレクトリごとの API ポリシーが設定されていない場合にのみ適用されます。ディレクトリごとの API ポリシーは、常にマシンレベルのレジストリポリシーよりも優先されます。

**重要**  
API を使用してディレクトリごとのポリシーを設定すると、削除できず、 に設定されている場合を含め、常にレジストリポリシーよりも優先されます`USER_CHOICE`。マシンレベルのレジストリポリシーに依存する場合は、それらのディレクトリのディレクトリごとのポリシーを設定しないでください。

## ユーザーが体験する内容
<a name="client-experience-policy-user-experience"></a>
+ **を設定する `USER_CHOICE` (または何も操作しない) 場合`USER_CHOICE`:** ユーザーはクライアントにリンクを表示し、従来のエクスペリエンスと新しいエクスペリエンスを切り替えることができます。切り替えると、新しく選択したエクスペリエンスが開く前 (数秒以内) にクライアントを再起動するように求められます。
+ **`FORCE_CLASSIC` または を設定すると`FORCE_UI_2026`、**ユーザーは選択したエクスペリエンスを表示し、切り替えオプションは非表示になります。ユーザーが別の強制ポリシーを持つディレクトリの WorkSpace に切り替えると、クライアントはクライアントエクスペリエンスポリシーを介して設定したエクスペリエンスに再起動するよう求めます。

## ロールアウトを計画する
<a name="client-experience-policy-rollout"></a>

新しいエクスペリエンスを採用するときは、次のアプローチをお勧めします。

1. **エンドユーザーのニーズを評価します。**PCoIP ベースの WorkSpaces または WorkSpaces Pools に接続する必要があるエンドユーザーがいる場合は、それを全体的な戦略に組み込む方法を検討してください。

1. **デフォルトの姿勢を決定します。**移行中にユーザーにオプトイン (`USER_CHOICE`)、新しいエクスペリエンスの標準化 (`FORCE_UI_2026`)、または従来のエクスペリエンスの保持 () を許可するかどうかを選択します`FORCE_CLASSIC`。

1. **クライアントが最新であることを確認します。**このポリシーは、クライアントバージョン 5.34 以降でのみ適用されます。ポリシーに依存する前に、ユーザーがサポートされているバージョンであることを確認します。

1. **ユーザーと通信します。**新しいエクスペリエンスがいつ利用可能になるか、また切り替えることができるかどうかをユーザーに知らせます。

1. **必要な調整を行います。**新しいエクスペリエンスが利用可能になったら、より詳細な評価を行い、エンドユーザーからフィードバックを取得し、必要に応じて体制の変更を実装します。

## 関連トピック
<a name="client-experience-policy-related"></a>
+ [クライアントプロパティの変更](https://docs.aws.amazon.com/workspaces/latest/api/API_ModifyClientProperties.html)
+ [クライアントプロパティを記述する](https://docs.aws.amazon.com/workspaces/latest/api/API_DescribeClientProperties.html)
+ [ClientProperties データ型](https://docs.aws.amazon.com/workspaces/latest/api/API_ClientProperties.html)