

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

# ユーザーのアプリケーション設定の VHD を管理する
<a name="administer-app-settings-vhds"></a>

**Topics**
+ [Amazon S3 バケットのストレージ](#app-persistence-s3-buckets)
+ [ユーザーのアプリケーション設定をリセットする](#app-persistence-s3-reset)
+ [Amazon S3 オブジェクトのバージョニングを有効にしてユーザーのアプリケーション設定を元に戻す](#app-persistence-enable-versions-revert-settings)
+ [アプリケーション設定 VHD のサイズを拡大する](#app-persistence-increase-VHD-size)

## Amazon S3 バケットのストレージ
<a name="app-persistence-s3-buckets"></a>

アプリケーション設定の永続化を有効にすると、ユーザーのアプリケーションのカスタマイズと Windows 設定は、 AWS アカウントで作成された Amazon S3 バケットに保存されている Virtual Hard Disk (VHD) ファイルに自動的に保存されます。 AWS リージョンごとに、WorkSpaces Pools によってアカウントおよびリージョン固有のバケットがアカウント内に作成されます。ユーザーが行ったすべてのアプリケーション設定が該当リージョンのバケットに保存されます。

これらの S3 バケットを管理するための設定タスクは一切不要です。WorkSpaces Pools サービスによって完全に管理されます。各バケットに保存された VHD ファイルは、伝送時には Amazon S3 の SSL エンドポイントを使用して暗号化され、保管時には [AWS マネージド CMK](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk) を使用して暗号化されます。バケットは、以下にあるような特定の形式で命名されます。

```
wspool-app-settings-<region-code>-<account-id-without-hyphens>-<random-identifier>
```

***region-code***  
これは、アプリケーション設定の永続性を使用してディレクトリが作成される AWS リージョンコードです。

***account-id-without-hyphens***  
 AWS アカウント ID。ランダムな識別子により、該当リージョンで他のバケットとの競合が発生することはありません。バケット名の最初の部分 `wspool-app-settings` は、複数のアカウントやリージョンにまたがる場合でも変更されません。

例えば、アカウント番号 123456789012 で、米国西部 (オレゴン) リージョン (us-west-2) のディレクトリに対してアプリケーション設定の永続化を有効にすると、WorkSpaces Pools は、該当リージョンのアカウント内に次に示す名前で Amazon S3 バケットを作成します。適切なアクセス許可を持つ管理者のみが、このバケットを削除できます。

```
wspool-app-settings-us-west-2-1234567890123-abcdefg
```

アプリケーション設定の永続化を無効にしても、S3 バケットに保存された VHD は削除されません。設定 VHD を完全に削除するには、Amazon S3 コンソールまたは API を使用して、ユーザーまたは適切なアクセス許可を持つ別の管理者が削除する必要があります。WorkSpaces Pools には、バケットの誤った削除を防止するバケットポリシーが追加されます。

アプリケーション設定の永続化を有効にすると、設定 VHD を保存するために設定グループごとに固有のフォルダが作成されます。S3 バケットのフォルダの階層は、次のセクションで説明するように、ユーザーがストリーミングセッションを起動する方法によって異なります。

アカウントの S3 バケットで設定 VHD が保存されているフォルダへのパスは、次の構造になります。

```
bucket-name/Windows/prefix/settings-group/access-mode/user-id-SHA-256-hash
```

***bucket-name***  
ユーザーのアプリケーション設定が保存されている S3 バケットの名前。名前の形式については、このセクションで先ほど説明しました。

***prefix***  
Windows バージョン固有のプレフィックス。例えば、v4 for Windows Server 2012 R2 です。

***settings-group***  
設定グループの値。この値は、同じアプリケーション設定を共有する 1 つ以上のディレクトリに適用されます。

***access-mode***  
ユーザーの ID メソッド: WorkSpaces Pools API または CLI の場合は `custom`、SAML の場合は `federated`、ユーザープールのユーザーの場合は `userpool`。

***user-id-SHA-256-hash***  
ユーザー固有のフォルダ名。この名前は、ユーザー ID から生成された小文字の SHA-256 ハッシュ 16 進数文字列を使用して作成されます。

次のフォルダ構造例は、ユーザー ID が 、ID が `testuser@mydomain.com`、`test-stack`米国西部 (オレゴン) リージョン (us-west-2) AWS アカウント `123456789012`の設定グループで API または CLI を使用してアクセスされるストリーミングセッションに適用されます。

```
wspool-app-settings-us-west-2-1234567890123-abcdefg/Windows/v4/test-stack/custom/a0bcb1da11f480d9b5b3e90f91243143eac04cfccfbdc777e740fab628a1cd13
```

ユーザーのフォルダを確認するには、ウェブサイトを使用するか、オンラインで入手できるオープンソースコーディングライブラリを使用して、ユーザー ID の小文字の SHA-256 ハッシュ値を生成します。

## ユーザーのアプリケーション設定をリセットする
<a name="app-persistence-s3-reset"></a>

ユーザーのアプリケーション設定をリセットするには、 AWS アカウントの S3 バケットから VHD および関連するメタデータファイルを見つけて削除する必要があります。ユーザーのアクティブなストリーミングセッションが進行中は、この操作を実行しないでください。ユーザーの VHD とメタデータファイルを削除すると、次回、ユーザーがアプリケーション設定の永続化が有効になっているストリーミングインスタンスからセッションを起動したときに、WorkSpaces Pools によって当該ユーザーの新しい設定 VHD が作成されます。

**ユーザーのアプリケーション設定をリセットするには**

1. Amazon S3 コンソール ([https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)) を開きます。

1. [**Bucket name (バケット名)**] リストで、リセットするアプリケーション設定 VHD が含まれている S3 バケットを選択します。

1. VHD が含まれているフォルダを見つけます。S3 バケットのフォルダ構造内を移動する詳しい方法については、このトピックの前半にある「*Amazon S3 バケットのストレージ*」を参照してください。

1. [**名前**] のリストで、VHD と REG の横にあるチェックボックスをオンにし、[**詳細**]、[**削除**] の順に選択します。

1. [**Delete objects (オブジェクトの削除)**] ダイアログボックスで、VHD と REG が表示されていることを確認し、[**削除**] を選択します。

該当する設定グループに基づいてアプリケーション設定の永続化が有効になっているプールから次回ユーザーがストリーミングすると、新しいアプリケーション設定 VHD が作成されます。この VHD は、セッションの最後に S3 バケットに保存されます。

## Amazon S3 オブジェクトのバージョニングを有効にしてユーザーのアプリケーション設定を元に戻す
<a name="app-persistence-enable-versions-revert-settings"></a>

Amazon S3 オブジェクトのバージョニングとライフサイクルポリシーを使用して、ユーザーによるアプリケーション設定の変更を管理できます。Amazon S3 オブジェクトのバージョニングを使用すると、あらゆるバージョンの設定 VHD を保持、取得、復元できます。これにより、意図しないユーザーのアクションとアプリケーションの障害の両方から復旧できます。バージョニングを有効にすると、各ストリーミングセッション後に、新しいバージョンのアプリケーション設定 VHD が Amazon S3 と同期されます。新しいバージョンは以前のバージョンを上書きしないため、ユーザーの設定に問題が生じた場合は、以前のバージョンの VHD に戻すことができます。

**注記**  
各バージョンのアプリケーション設定 VHD は、別個のオブジェクトとして Amazon S3 に保存され、相応に課金されます。

S3 バケットでのオブジェクトのバージョニングは、デフォルトでは有効にならないため、明示的に有効にする必要があります。

**アプリケーション設定 VHD でオブジェクトのバージョニングを有効にするには**

1. Amazon S3 コンソール ([https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)) を開きます。

1. [**Bucket name (バケット名)**] リストで、オブジェクトのバージョニングを有効にするアプリケーション設定 VHD が含まれている S3 バケットを選択します。

1. **[プロパティ]** を選択します。

1. [**Versioning (バージョニング)**]、[**Enable versioning (バージョニングの有効化)**]、[**Save (保存)**] の順に選択します。

古いバージョンのアプリケーション設定 VHD を失効させるには、Amazon S3 ライフサイクルポリシーを使用できます。詳細については、*Amazon Simple Storage Service ユーザーガイド*の「[S3 バケットのライフサイクルポリシーを作成する方法を教えてください](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/create-lifecycle.html)」を参照してください。

**ユーザーのアプリケーション設定 VHD を前のバージョンに戻すには**

ユーザーのアプリケーション設定 VHD を前のバージョンに戻すには、該当する S3 バケットから以降のバージョンの VHD を削除します。ユーザーがアクティブなストリーミングセッションを進行中は、この操作を実行しないでください。

1. Amazon S3 コンソール ([https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)) を開きます。

1. [**Bucket name (バケット名)**] リストで、前のバージョンに戻すユーザーのアプリケーション設定 VHD が含まれている S3 バケットを選択します。

1. VHD が含まれているフォルダを見つけて選択します。S3 バケットのフォルダ構造内を移動する詳しい方法については、このトピックの前半にある「*Amazon S3 バケットのストレージ*」を参照してください。

   フォルダを選択すると、設定 VHD および関連するメタデータファイルが表示されます。

1. VHD とメタデータファイルのバージョンを一覧表示するには、[**Show (表示)**] を選択します。

1. 以前に戻す VHD のバージョンを見つけます。

1. [**Name (名前)**] リストで、以降のバージョンの VHD および関連するメタデータファイルの横にあるチェックボックスをオンにし、[**More (詳細)**]、[**Delete (削除)**] の順に選択します。

1. 前のバージョンに戻すアプリケーション設定 VHD および関連するメタデータファイルが以降のバージョンであることを確認します。

該当する設定グループに基づいてアプリケーション設定の永続化が有効になっているプールから次回ユーザーがストリーミングを行うと、前のバージョンに戻したユーザー設定が表示されます。

## アプリケーション設定 VHD のサイズを拡大する
<a name="app-persistence-increase-VHD-size"></a>

VHD のデフォルトの最大サイズは、プールの場合 5 GB です。ユーザーがアプリケーション設定の領域を増やす必要がある場合は、該当するアプリケーション設定 VHD を Windows コンピュータにダウンロードして拡大できます。次に、S3 バケット内の現在の VHD を、拡大したものに置き換えます。ユーザーがアクティブなストリーミングセッションを進行中は、この操作を実行しないでください。

**注記**  
Virtual Hard Disk (VHD) の物理サイズを減らすには、セッションを終了する前にごみ箱を空にします。これにより、アップロードとダウンロードの時間も短縮され、全体的なユーザーエクスペリエンスが向上します。

**アプリケーション設定 VHD のサイズを拡大するには**
**注記**  
ユーザーがアプリケーションのストリーミングを行う前に、VHD 全体をダウンロードする必要があります。アプリケーション設定 VHD のサイズを拡大すると、ユーザーがアプリケーションのストリーミングセッションを開始するまでの所要時間が長くなる場合があります。

1. Amazon S3 コンソール ([https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)) を開きます。

1. [**Bucket name (バケット名)**] リストで、拡大するアプリケーション設定 VHD が含まれている S3 バケットを選択します。

1. VHD が含まれているフォルダを見つけて選択します。S3 バケットのフォルダ構造内を移動する詳しい方法については、このトピックの前半にある「[Amazon S3 バケットのストレージ](#app-persistence-s3-buckets)」を参照してください。

   フォルダを選択すると、設定 VHD および関連するメタデータファイルが表示されます。

1. `Profile.vhdx` ファイルを Windows コンピュータのディレクトリにダウンロードします。ダウンロードが完了しても、ブラウザを閉じないでください。拡大した VHD をアップロードするためにブラウザを後で再び使用します。

1. Diskpart を使用して VHD のサイズを 7 GB に拡大するには、管理者としてコマンドプロンプトを開き、以下のコマンドを入力します。

   ```
   diskpart
   ```

   ```
   select vdisk file="C:\path\to\application\settings\profile.vhdx"
   ```

   ```
   expand vdisk maximum=7000
   ```

1. 次に、以下の Diskpart コマンドを入力して、VHD を見つけてアタッチし、ボリュームを一覧表示します。

   ```
   elect vdisk file="C:\path\to\application\settings\profile.vhdx"
   ```

   ```
   attach vdisk
   ```

   ```
   list volume
   ```

   出力で、ラベル「AwsEucUsers」が付いているボリュームの番号を書き留めます。次のステップで、このボリュームを選択して拡大します。

1. 次のコマンドを入力します。`<volume-number>` はボリューム一覧の出力の数値です。

   ```
   select volume <volume-number>
   ```

1. 次のコマンドを入力します。

   ```
   extend
   ```

1. 以下のコマンドを入力して、VHD のパーティションのサイズが正常に拡大したこと (この例では 7 GB) を確認します。

   ```
   diskpart
   ```

   ```
   select vdisk file="C:\path\to\application\settings\profile.vhdx"
   ```

   ```
   list volume
   ```

1. 次のコマンドを入力して VHD をデタッチし、アップロードできるようにします。

   ```
   detach vdisk
   ```

1. Amazon S3 コンソールのブラウザに戻り、[**Upload (アップロード)**]、[**Add files (ファイルの追加)**] の順に選択し、拡大した VHD を選択します。

1. **アップロード** を選択します。

VHD をアップロードすると、該当する設定グループに基づいてアプリケーション設定の永続化が有効になっているプールから次回ユーザーがストリーミングを行ったときに、拡大したアプリケーション設定 VHD を使用できます。