翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# FSx for Windows ファイルシステムの管理
Amazon FSx は、ワークロードやユーザー要件の変化、組織の規制やコンプライアンスのニーズを満たすために、Amazon FSx for Windows File Server ファイルシステムを簡単に管理および拡張するのに役立つ幅広い管理機能を提供します。以下は、、 AWS CLI API AWS マネジメントコンソール、PowerShell でのリモート管理用の Amazon FSx CLI、およびネイティブ Microsoft Windows Server グラフィカルインターフェイスを使用して管理できるファイルシステム設定のリストです。
+ ストレージキャパシティ
+ ストレージタイプ
+ SSD IOPS
+ スループット容量
+ DNS エイリアス
+ データ重複除外
+ シャドウコピー
+ ストレージクォータ
+ ファイルアクセスの監査
+ ファイル共有
以下のセクションでは、利用可能なファイルシステム管理機能と設定について説明します。状況に最適なオプションと、該当する場合はベストプラクティスを判断するのに役立つガイダンスが含まれています。
**Topics**
+ [Amazon FSx ファイルシステムのステータス](#file-system-lifecycle-states)
+ [PowerShell での Amazon FSx CLI の使用](#remote-pwrshell)
+ [Amazon FSx リモート PowerShell セッションの開始](start-remote-powershell-session.md)
+ [PowerShell でのリモート管理に Amazon FSx CLI を使用する 1 回限りのファイルシステムセットアップタスク](one-time-admin-tasks.md)
+ [PowerShell での Amazon FSx CLI へのアクセスのトラブルシューティング](cant-access-rps.md)
+ [ファイルシステムのメンテナンスウィンドウ](#maintenance-windows)
+ [週次メンテナンスウィンドウを変更する](update-maintenance-window.md)
+ [DNS エイリアスを管理する](managing-dns-aliases.md)
+ [ユーザーセッションと開いているファイル](manage-sessions-and-files.md)
+ [FSx for Windows File Server のファイルサーバーリソースマネージャー](managing-files-fsrm.md)
+ [FSx for Windows File Server でのストレージの管理](managing-storage-configuration.md)
+ [DFS 名前空間の使用](using-dfs-namespaces.md)
+ [スループット容量の管理](managing-throughput-capacity.md)
+ [ネットワークタイプの管理](manage-network-type.md)
+ [Amazon FSx リソースのタグ付け](tag-resources.md)
+ [を使用してファイルシステムを更新する AWS CLI](walkthrough03-update-file-system.md)
## Amazon FSx ファイルシステムのステータス
Amazon FSx ファイルシステムのステータスを表示するには、Amazon FSx コンソール、 AWS CLI コマンド [describe-file-systems](https://docs.aws.amazon.com/cli/latest/reference/fsx/describe-file-systems.html)、または API オペレーション [DescribeFileSystems](https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeFileSystems.html) を使用します。
| ファイルシステムのステータス | 説明 |
| --- | --- |
| AVAILABLE (利用可能) | ファイルシステムは正常な状態にあり、到達可能であり、使用可能です。 |
| CREATING (作成) | Amazon FSx は新しいファイルシステムを作成しています。 |
| [DELETING] (削除中) | Amazon FSx は既存のファイルシステムを削除しています。 |
| UPDATING (更新) | ファイルシステムは、お客様によって開始される更新を受けています。 |
| [MISCONFIGURED] (設定ミスです) | アクティブディレクトリ環境での変更により、ファイルシステムが障害状態になっています。ファイルシステムは現在使用できないか、アベイラビリティーを失うリスクがあり、バックアップが成功しない可能性があります。アベイラビリティーの復元の詳細については、「[ファイルシステムが正しく設定されていない状態です](misconfigured-ad-config.md)」を参照してください。 |
| MISCONFIGURED\$1UNAVAILABLE | アクティブディレクトリ環境での変更により、ファイルシステムは現在使用できません。アベイラビリティーの復元の詳細については、「[ファイルシステムが正しく設定されていない状態です](misconfigured-ad-config.md)」を参照してください。 |
| FAILED | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/fsx/latest/WindowsGuide/administering-file-systems.html) |
## PowerShell での Amazon FSx CLI の使用
この章では、PowerShell でのリモート管理のために Amazon FSx CLI にアクセスして、FSx for Windows ファイルシステムのファイルシステム管理タスクを実行する方法について説明します。Microsoft Windows ネイティブグラフィカルユーザーインターフェイス (GUI) を使用して、いくつかの管理タスクを実行することもできます。
PowerShell でのリモート管理の Amazon FSx CLI を使用すると、ファイルシステム管理者グループのユーザーのファイルシステム管理が可能になります。FSx for Windows File Server 上でリモート PowerShell セッションを開始するには、まず次の前提条件を満たす必要があります。
+ FSx for Windows File Server ファイルシステムとのネットワーク接続を持つ Windows コンピューティングインスタンスに接続できる。
+ ファイルシステム管理者グループのメンバーとして Windows コンピューティングインスタンスにログインする。を使用している場合 AWS Managed Microsoft AD、これは*AWS 委任 FSx 管理者*グループです。セルフマネージド Microsoft Active Directory を使用している場合、ユーザーは、ドメイン管理者グループ、またはファイルシステムの作成時に管理用に指定したカスタムグループのメンバーである必要があります。詳細については、「[自己管理型アクティブディレクトリを使用する場合のベストプラクティス](self-managed-AD.md#self-managed-AD-best-practices)」を参照してください。
+ ファイルシステムのセキュリティグループの VPC インバウンドルールがポート 5985 でのトラフィックを許可していることを確認します。
PowerShell でのリモート管理の Amazon FSx CLI では、次のセキュリティ機能が使用されます。
+ ユーザー認証情報は Kerberos 認証を使用して認証されます。
+ 接続されたクライアントとファイルシステム間の管理セッション通信は、Kerberos を使用して暗号化されます。
Amazon FSx ファイルシステム上でリモート管理 CLI コマンドを実行するには、2 つのオプションがあります。
+ 長時間実行されるリモート PowerShell セッションを確立し、セッション内でコマンドを実行できます。
+ `Invoke-Command` を使用して、長時間実行されるリモート PowerShell セッションを確立せずに、単一のコマンドまたは単一のコマンドブロックを実行することができます。
リモート管理コマンドにパラメータとして可変を設定して渡す場合は、`Invoke-Command` を使用する必要があります。
**注記**
マルチ AZ ファイルシステムの場合、リモート管理に Amazon FSx CLI を使用できるのは、ファイルシステムが優先ファイルサーバーを使用している場合のみです。詳細については、「[可用性および耐久性: シングル AZ およびマルチ AZ のファイルシステム](high-availability-multiAZ.md)」を参照してください。
リモート PowerShell にアクセスするには、ファイルシステムの Windows Remote PowerShell エンドポイントを使用する必要があります。リモート管理エンドポイントの形式は `amznfsxctlyaa1k.ActiveDirectory-DNS-name`です (例: `amznfsxctlyaa1k.corp.example.com`)。エンドポイント名は、**ネットワークとセキュリティ**タブ AWS マネジメントコンソール の**ファイルシステムの詳細**ページで を使用して確認できます。[https://docs.aws.amazon.com/v2/documentation/api/latest/reference/fsx/describe-file-systems.html](https://docs.aws.amazon.com/v2/documentation/api/latest/reference/fsx/describe-file-systems.html) コマンドを使用して AWS CLI 、レスポンスで返された `RemoteAdministrationEndpoint`プロパティを表示します。
`Get-Command` コマンドレットを使用して、PowerShell で使用可能なコマンドレット、関数、エイリアスに関する情報を取得できます。詳細については、「Microsoft ドキュメント」の「[Get-Command](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/get-command?view=powershell-7.3)」を参照してください。
次に説明する `Invoke-Command` コマンドレットを使用し、以下の構文を使用し、ファイルシステムの PowerShell コマンドでリモート管理 CLI 用の Amazon FSx CLI を実行することもできます。
```
PS C:\Users\delegateadmin> Invoke-Command -ComputerName amznfsxctlyaa1k.corp.example.com -ConfigurationName FSxRemoteAdmin -scriptblock { fsx-command}
```
FSx for Windows File Server ファイルシステムで存続期間の長いリモート PowerShell セッションを開始する方法については、「[Amazon FSx リモート PowerShell セッションの開始](start-remote-powershell-session.md)」を参照してください。
# Amazon FSx リモート PowerShell セッションの開始
このトピックでは、FSx for Windows File Server ファイルサーバーで存続期間の長いリモート PowerShell セッションを開始する手順について説明します。
**ファイルシステム上でリモート PowerShell セッションを開始するには**
1. ファイルシステムの作成時に選択した委任された FSx 管理者グループのメンバーであるユーザーとして、ファイルシステムとのネットワーク接続があるコンピューティングインスタンスに接続します。
1. コンピューティングインスタンスで Windows PowerShell ウィンドウを開きます。
1. PowerShell では、次のコマンドを使用して、Amazon FSx ファイルシステム上で存続期間の長いリモートセッションを開きます。`Remote-PowerShell-Endpoint` を、管理したいファイルシステムの Windows Remote PowerShell エンドポイントに置き換えます。セッション設定の名前に `FsxRemoteAdmin` を使用します。
```
PS C:\Users\delegateadmin> enter-pssession -ComputerName Remote-PowerShell-Endpoint -ConfigurationName FsxRemoteAdmin
[fs-0123456789abcdef0]: PS>
```
インスタンスが Amazon FSx Active Directory ドメインに含まれていない場合は、ポップアップにユーザー認証情報を入力するように求められます。FSx 管理者グループのメンバーであるユーザーの認証情報を入力します。インスタンスがドメインに含まれている場合、認証情報の入力は要求されません。
**重要**
セルフマネージドの Active Directory 設定を使用していて、適切な Active Directory グループポリシー設定なしでサービスアカウントを変更すると、Windows Remote PowerShell エンドポイントが変わることがあります。詳細については、「[Amazon FSx サービスアカウントの変更](changing-ad-service-account.md) の詳細」を参照してください。
# PowerShell でのリモート管理に Amazon FSx CLI を使用する 1 回限りのファイルシステムセットアップタスク
PowerShell コマンドのリモート管理に次の Amazon FSx CLI を使用して、ファイルシステムに以下のベストプラクティスをすばやく実装します。
## ストレージの消費量の管理
次のコマンドを使用して、ファイルシステムのストレージの消費量を管理します。
+ デフォルトのスケジュールでデータ重複除外を有効にするには、次のコマンドを実行します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock { Enable-FsxDedup }
```
必要に応じて、次のコマンドを使用して、最低ファイル年齢を必要とすることなく、ファイルの作成後すぐにファイルに対してデータ重複除外を実行できます。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock { Set-FSxDedupConfiguration -MinimumFileAgeDays 0 }
```
詳細については、「[データ重複排除によるストレージコストの削減](managing-storage-configuration.md#using-data-dedup)」を参照してください。
+ 次のコマンドを使用して、ユーザーストレージクォータの制限を「追跡」モードで有効にします。これはレポートのみを目的としており、強制ではありません。
```
$QuotaLimit = Quota limit in bytes
$QuotaWarningLimit = Quota warning threshold in bytes
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock { Enable-FSxUserQuotas -Track -DefaultLimit $Using:QuotaLimit -DefaultWarningLimit $Using:QuotaWarningLimit }
```
詳細については、「[ストレージクォータの管理](managing-user-quotas.md)」を参照してください。
## シャドウコピーを有効にして、エンドユーザーがファイルやフォルダを以前のバージョンにリカバリできるようにする
次のように、デフォルトのスケジュール (平日の午前 7 時と正午 12 時) でシャドウコピーを有効にします。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock { Set-FsxShadowStorage -Default }
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock { Set-FsxShadowCopySchedule -Default -Confirm:$False}
```
詳細については、「[デフォルトのストレージとスケジュールを使用するようにシャドウコピーを設定する](setting-up-fsx-shadow-copies.md)」を参照してください。
## 転送時の暗号化の強制
次のコマンドは、ファイルシステムに接続しているクライアントに対して暗号化を強制します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock { Set-FsxSmbServerConfiguration -EncryptData $True -RejectUnencryptedAccess $True -Confirm:$False}
```
開いているすべてのセッションを閉じて、現在接続しているクライアントを暗号化を使用して再接続するように強制できます。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock { Close-FSxSmbSession -Confirm:$False}
```
詳細については、「[転送時の暗号化の管理](encryption-in-transit.md#manage-encrypt-in-transit)」および「[ユーザーセッションと開いているファイル](manage-sessions-and-files.md)」を参照してください。
# PowerShell での Amazon FSx CLI へのアクセスのトラブルシューティング
次のように、Remote PowerShell を使用してファイルシステムに接続できない原因はいくつか考えられますが、それぞれ独自の解決方法があります。
最初に、Windows Remote PowerShell エンドポイントに正常に接続できることを確認するために、基本的な接続テストを実行することもできます。例えば、`test-netconnection endpoint -port 5985` コマンドを実行できます。
## ファイルシステムのセキュリティグループには、リモート PowerShell 接続を許可するために必要なインバウンドルールがありません
ファイルシステムのセキュリティグループには、Remote PowerShell セッションを確立するために、ポート 5985 でのトラフィックを許可するインバウンドルールが必要です。詳細については、「[Amazon VPC セキュリティグループ](limit-access-security-groups.md#fsx-vpc-security-groups)」を参照してください。
## AWS マネージド Microsoft Active Directory とオンプレミス Active Directory の間に外部信頼が設定されている
Kerberos 認証で Amazon FSx Remote PowerShell を使用するには、フォレストの検索順序についてクライアントでローカルグループポリシーを設定する必要があります。詳細については、Microsoft のドキュメント 「[Kerberos フォレスト検索順序 (KFSO) の設定](https://docs.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2008-R2-and-2008/hh921473(v=ws.10)?redirectedfrom=MSDN)」を参照してください。
## リモート PowerShell セッションを開始しようとすると、言語ローカライズエラーが発生します
次の `-SessionOption` をコマンドに追加する必要があります: `-SessionOption (New-PSSessionOption -uiCulture "en-US")`
以下は、ファイルシステムでリモート PowerShell セッションを開始するときに `-SessionOption` を使用する 2 つの例です。
```
PS C:\Users\delegateadmin> Invoke-Command -ComputerName Windows Remote PowerShell Endpoint -ConfigurationName FSxRemoteAdmin -scriptblock {fsx-command} -SessionOption (New-PSSessionOption -uiCulture "en-US")
```
```
PS C:\Users\delegateadmin> Enter-Pssession -ComputerName Windows Remote PowerShell Endpoint -ConfigurationName FsxRemoteAdmin -SessionOption (New-PSSessionOption -uiCulture "en-US")
```
## ファイルシステムのメンテナンスウィンドウ
Amazon FSx for Windows File Server は、管理している Microsoft Windows サーバーソフトウェアの定期的なソフトウェアパッチを実行します。メンテナンスウィンドウは、このメンテナンスプロセスが開始される曜日と時刻を指定します。ファイルシステムの作成時に、メンテナンスウィンドウの開始期間を指定できます。指定しない場合、30 分のデフォルトのメンテナンス開始ウィンドウが割り当てられます。メンテナンスウィンドウの期間は、メンテナンスの範囲や、マルチ AZ ファイルシステムのプライマリサーバーとセカンダリサーバーの間でメンテナンス中に発生するファイルの読み取りおよび書き込みアクティビティを同期するプロセスなど、複数の要因によって異なります。詳細については、「[フェイルオーバープロセス](high-availability-multiAZ.md#MultiAZ-Failover)」を参照してください。
FSx for Windows File Server では、ワークロードと運用要件に合わせて、メンテナンスウィンドウの開始時刻を調整できます。メンテナンスウィンドウの開始時刻は、少なくとも 14 日ごとに 1 回開始時刻がスケジュールされていれば、必要に応じて何度でも変更できます。14 日以内にメンテナンスウィンドウが設定されていない状態でパッチがリリースされた場合、FSx for Windows File Server は、セキュリティと信頼性を確保するためにファイルシステムのメンテナンスを続行します。ファイルシステムのメンテナンスウィンドウの開始時間を調整する方法の詳細については、「[週次メンテナンスウィンドウを変更する](update-maintenance-window.md)」を参照してください。
パッチの適用中は、シングル AZ ファイルシステムが使用できなくなります (通常 20 分間未満)。マルチ AZ ファイルシステムは引き続き利用可能で、優先ファイルサーバーとスタンバイファイルサーバー間で自動的にフェイルオーバーおよびフェイルバックを行います。詳細については、「[フェイルオーバープロセス](high-availability-multiAZ.md#MultiAZ-Failover)」を参照してください。マルチ AZ ファイルシステムのパッチ適用ではファイルサーバー間のフェイルオーバーとフェイルバックが行われるため、この間に発生するファイルの読み書きアクティビティは、優先ファイルサーバーとスタンバイファイルサーバーの間で同期させる必要があります。パッチ適用の時間を短縮するために、ファイルシステムの負荷が最小であるアイドル期間中にメンテナンスウィンドウをスケジュールすることをお勧めします。
**注記**
メンテナンスアクティビティ中のデータの整合性を確保するために、Amazon FSx for Windows File Server は、メンテナンスが開始される前に、ファイルシステムをホストしている基盤となるストレージボリュームへの保留中の書き込みオペレーションを完了します。
# 週次メンテナンスウィンドウを変更する
FSx for Windows File Server では、ワークロードと運用要件に合わせて、ファイルシステムのメンテナンスウィンドウの開始時刻を調整できます。 AWS マネジメントコンソール、 AWS CLI、および Amazon FSx API を使用して、毎週のメンテナンスウィンドウがいつ開始するかを変更できます。詳細については、次の手順を参照してください。
**毎週のメンテナンス期間の開始時間を変更するには (コンソール)**
1. [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/) で Amazon FSx コンソールを開きます。
1. 左側のナビゲーション列で **[File systems]** (ファイルシステム) を選択します。
1. 週次のメンテナンスウィンドウを変更するファイルシステムを選択します。ファイルシステムの詳細ページが表示されます。
1. **[Administration]** (管理) を選択して、ファイルシステム管理の **[Settings]** (設定) パネルを表示します。
1. **[Update]** (更新) を選択して、**[Change maintenance window]** (メンテナンスウィンドウの変更) ウィンドウを表示します。
1. 週次のメンテナンスウィンドウを開始する新しい日時を入力します。
1. **[Save]** (保存) を選択して変更を保存します。新しいメンテナンス開始時刻は、**[Administration Settings]** (管理設定) パネルに表示されます。
[update-file-system](https://docs.aws.amazon.com/cli/latest/reference/fsx/update-file-system.html) CLI コマンドを使用して毎週のメンテナンス期間の開始時刻を変更するには、「[を使用してファイルシステムを更新する AWS CLI](walkthrough03-update-file-system.md)」を参照してください。
# DNS エイリアスを管理する
Amazon FSx が提供するデフォルトのドメインネームシステム (DNS) 名に加えて、選択した DNS エイリアスをファイルシステムに関連付けることもできます。DNS エイリアスを使用すると、[ファイルシステムのストレージをオンプレミスから Amazon FSx に移行する](migrate-to-fsx.md)ときに、ツールやアプリケーションを更新することなく、既存の DNS 名を使用して Amazon FSx に保存されたデータにアクセスできます。
DNS エイリアスを新規および既存の FSx for Windows File Server ファイルシステムに関連付けたり、 AWS マネジメントコンソール および を使用してバックアップを新しいファイルシステムに復元したりできます AWS CLI。ファイルシステムには、一度で最大 50 個の DNS エイリアスを関連付けることができます。
**注記**
DNS エイリアスのサポートは、2020 年 11 月 9 日の午後 12:00 ET 以降に作成された FSx for Windows ファイルサーバーのファイルシステム上で利用できます: 2020 年 11 月 9 日の午後 12:00 ET より前に作成されたファイルシステムで DNS エイリアスを使用するには、次の手順を実行します:
既存のファイルシステムのバックアップを作成します。詳細については、「[ユーザー主導のバックアップ機能](using-backups.md#user-initiated-backups)」を参照してください。
新しいファイルシステムにバックアップを復元します。詳細については、「[新しいファイルシステムへのバックアップの復元](using-backups.md#restoring-backups)」を参照してください。
新しいファイルシステムが使用可能になったら、このセクションに記載されている情報を使い、DNS エイリアスを使用してアクセスできるようになります。
**注記**
ここで示す情報は、ユーザーがアクティブディレクトリ内のみで作業しており、外部 DNS プロバイダーを使用していないことを前提としています。サードパーティー DNS プロバイダーでは、予想外の動作が発生することがあります。
Amazon FSx は、結合しているアクティブディレクトリドメインがデフォルトの DNS として Microsoft DNS を使用している場合のみ、ファイルシステムの DNS レコードを登録します。サードパーティー DNS を使用している場合は、ファイルシステムを作成した後、Amazon FSx ファイルシステムの DNS エントリを手動で設定する必要があります。ファイルシステムに使用する正しい IP アドレスの選択の詳細については、「[手動 DNS エントリに使用する正しいファイルシステムの IP アドレスの取得](file-system-ip-addresses-for-dns.md)」を参照してください。
DNS エイリアスは、新しいファイルシステムを作成する際、およびバックアップから新しいファイルシステムを作成する際に、既存の FSx for Windows File Server ファイルシステムに関連付けることができます。ファイルシステムには、最大 50 個の DNS エイリアスを一度に関連付けることができます。
DNS エイリアスをファイルシステムに関連付けるだけでなく、クライアントが DNS エイリアスを使用してファイルシステムに接続するには、次の操作も実行する必要があります:
+ Kerberos 認証と暗号化用のサービスプリンシパル名 (SPN) を設定します。
+ Amazon FSx ファイルシステムのデフォルト DNS 名に解決される、DNS エイリアスの DNS CNAME レコードを設定します。
詳細については、「[DNS エイリアスを使用したデータへのアクセス](dns-aliases.md)」を参照してください。
FSx for Windows File Server ファイルシステムの DNS エイリアス名は、次の要件を満たす必要があります:
+ 完全修飾ドメイン名 (FQDN) としてフォーマットする必要があります。
+ 英数字およびハイフン (‐) が使用できます。
+ ハイフンでスタートまたは終了することはできません。
+ 数字で始めることができます。
DNS エイリアス名の場合、大文字または小文字を指定するか、あるいはエスケープコードで対応する文字を指定するかに関係なく、Amazon FSx は英字を小文字 (a～z) として保存します:
ファイルシステムにすでに関連付けられているエイリアスを関連付けしようとした場合、そのエイリアスは無効になります。ファイルシステムが関連付けされていないファイルシステムから、エイリアスの関連付けを解除しようとすると、Amazon FSx は不正リクエストエラーでレスポンスします。
**注記**
Amazon FSx がファイルシステム上でエイリアスを追加または削除すると、接続されたクライアントは一時的に切断され、自動的にファイルシステムに再接続されます。切断時に非連続使用可能 (CA 以外) 共有をマッピングしているクライアントによって開かれていたファイルは、クライアントによって再度開かれる必要があります。
**Topics**
+ [DNS エイリアスのステータス](#alias-status)
+ [Kerberos 認証での DNS エイリアスの使用](#aliases-and-kerberos)
+ [ファイルシステムおよびバックアップの DNS エイリアスの表示](view-aliases.md)
+ [DNS エイリアスとファイルシステムの関連付け](add-alias-new-filesystem.md)
+ [既存のファイルシステム上の DNS エイリアスを管理する](manage-aliases-existing-fs.md)
## DNS エイリアスのステータス
DNS エイリアスには、次のいずれかのステータス値が設定されます:
+ 利用可能 - DNS エイリアスは Amazon FSx ファイルシステムに関連付けられています。
+ 作成中 - Amazon FSx は DNS エイリアスを作成し、ファイルシステムに関連付けています。
+ 削除 - Amazon FSx はファイルシステムから DNS エイリアスの関連付けを解除し、削除しています。
+ 作成に失敗しました - Amazon FSx は DNS エイリアスをファイルシステムに関連付けることができませんでした。
+ 削除に失敗しました - Amazon FSx はファイルシステムから DNS エイリアスの関連付けを解除できませんでした。
## Kerberos 認証での DNS エイリアスの使用
Amazon FSx との転送中に、Kerberos ベースの認証と暗号化を使用することをお勧めします。Kerberos は、ファイルシステムにアクセスするクライアントに対して最も安全な認証を提供します。DNS エイリアスを使用して Amazon FSx ファイルシステムにアクセスするクライアントの Kerberos 認証を有効にするには、ファイルシステムの Active Directory コンピュータオブジェクトの DNS エイリアスに対応するサービスプリンシパル名 (SPN) を設定する必要があります。
アクティブディレクトリ内のコンピュータオブジェクト上の別のファイルシステムに割り当てた DNS エイリアスに SPN が設定されている場合は、ファイルシステムのコンピュータオブジェクトに SPN を追加する前に、まずこれらの SPN を削除する必要があります。詳細については、「[Kerberos のサービスプリンシパル名 (SPN) を設定する](step2-configure-spn-kerberos.md)」を参照してください。
# ファイルシステムおよびバックアップの DNS エイリアスの表示
次の手順で説明するように、 AWS マネジメントコンソール、、および API を使用して AWS CLI、FSx for Windows File Server ファイルシステムとバックアップに現在関連付けられている DNS エイリアスを表示できます。
**ファイルシステムに関連付けられている DNS エイリアスを表示するには**
+ コンソールの使用 - ファイルシステムを選択し、**ファイルシステム** 詳細ページを表示します。**[Network & security** (ネットワークとセキュリティ) タブを選択して **DNS エイリアス** を表示します。
+ CLI または API の使用 - `describe-file-system-aliases` CLI コマンドまたは [DescribeFileSystemAliases](https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeFileSystemAliases.html) API オペレーションを使用します。
**バックアップに関連付けられた DNS エイリアスを表示するには**
+ コンソールの使用 - ナビゲーションペインで、**[Backups]** (バックアップ) を選択し、表示するバックアップを選択します。**[Summary]** (概要) ペインで、**DNS エイリアス** フィールドを表示します。
+ CLI または API の使用 - `describe-backups` CLI コマンドまたは [DescribeBackups](https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeBackups.html) API オペレーションを使用します。
# DNS エイリアスとファイルシステムの関連付け
DNS エイリアスは、新しい FSx for Windows File Server ファイルシステムをゼロから作成するとき、またはバックアップを新しいファイルシステムに復元するときに AWS マネジメントコンソール AWS CLI、 と API を使用して関連付けることができます。手順は以下のとおりです。
## 新しいファイルシステムを作成するときに DNS エイリアスを関連付けるには (コンソール)
1. [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/) で Amazon FSx コンソールを開きます。
1. 「使用開始」セクションの [ステップ 5. ファイルシステムを作成](getting-started.md#getting-started-step1) で説明されている新しいファイルシステムを作成する手順に従います。
1. **[Create file system]** (ファイルシステムの作成) ウィザードの **[Access - optional]** (アクセス - オプション) セクションで、ファイルシステムに関連付ける DNS エイリアスを入力します。
![\[\]](http://docs.aws.amazon.com/ja_jp/fsx/latest/WindowsGuide/images/FSxW-create-fs-Access-aliases.png)
1. ファイルシステムが **[Available]** (使用可能) の場合、サービスプリンシパル名 (SPN) を設定して、エイリアスの DNS CNAME レコードを更新、または作成することで、DNS エイリアスを使用してファイルシステムにアクセスできます。詳細については、「[DNS エイリアスを使用したデータへのアクセス](dns-aliases.md)」を参照してください。
## 新しい Amazon FSx ファイルシステムの作成時に DNS エイリアスを関連付けるには (CLI)
1. 新しいファイルシステムを作成する際は、[CreateFileSystem](https://docs.aws.amazon.com/fsx/latest/APIReference/API_CreateFileSystem.html) API オペレーションで [エイリアス](https://docs.aws.amazon.com/fsx/latest/APIReference/API_Alias.html) プロパティを使用して、DNS エイリアスを新しいファイルシステムに関連付けます。
```
aws fsx create-file-system \
--file-system-type WINDOWS \
--storage-capacity 2000 \
--storage-type SSD \
--subnet-ids subnet-123456 \
--windows-configuration Aliases=[financials.corp.example.com,accts-rcv.corp.example.com]
```
1. ファイルシステムが **[Available]** (使用可能) の場合、サービスプリンシパル名 (SPN) を設定して、エイリアスの DNS CNAME レコードを更新、または作成することで、DNS エイリアスを使用してファイルシステムにアクセスできます。詳細については、「[DNS エイリアスを使用したデータへのアクセス](dns-aliases.md)」を参照してください。
## バックアップの復元時に DNS エイリアスを追加または削除するには (CLI)
1. 既存のファイルシステムのバックアップから新しいファイルシステムを作成する場合は、次のように [エイリアス](https://docs.aws.amazon.com/fsx/latest/APIReference/API_Aliases.html) プロパティと [CreateFileSystemFromBackup](https://docs.aws.amazon.com/fsx/latest/APIReference/API_CreateFileSystemFromBackup.html) API オペレーションを使用します:
+ デフォルトでは、バックアップに関連付けられているエイリアスは、新しいファイルシステムに関連付けられます。
+ バックアップからエイリアスを保持せずにファイルシステムを作成するには、空のセットで `Aliases` プロパティを使用します。
追加の DNS エイリアスを関連付けるには、`Aliases` プロパティを選択して、バックアップに関連付けられた元のエイリアスと、関連付ける新しいエイリアスの両方を含めます。
次の CLI コマンドは、Amazon FSx がバックアップから作成しているファイルシステムに 2 つのエイリアスを関連付けます。
```
aws fsx create-file-system-from-backup \
--backup-id backup-0123456789abcdef0
--storage-capacity 2000 \
--storage-type HDD \
--subnet-ids subnet-123456 \
--windows-configuration Aliases=[transactions.corp.example.com,accts-rcv.corp.example.com]
```
1. ファイルシステムが **[Available]** (使用可能) の場合、サービスプリンシパル名 (SPN) を設定して、エイリアスの DNS CNAME レコードを更新、または作成することで、DNS エイリアスを使用してファイルシステムにアクセスできます。詳細については、「[DNS エイリアスを使用したデータへのアクセス](dns-aliases.md)」を参照してください。
# 既存のファイルシステム上の DNS エイリアスを管理する
以下の手順で説明するように、 AWS マネジメントコンソール および を使用して AWS CLI、既存の FSx for Windows File Server ファイルシステムのエイリアスを追加および削除できます。
## ファイルシステム DNS エイリアスを管理するには (コンソール)
1. [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/) で Amazon FSx コンソールを開きます。
1. **[File systems]** (ファイルシステム) に移動し、DNS エイリアスを管理する Windows ファイルシステムを選択します。
1. **[ネットワークとセキュリティ]** タブで、**[DNS エイリアス]** の **[管理]** を選択して、**[DNS エイリアスの管理]** ウィンドウを表示します。
+ DNS エイリアスを関連付けるには - **[Associate new aliases]** (新しいエイリアスを関連付ける) ボックスに、関連付ける DNS エイリアスを入力します。**[Associate]** (関連付け) を選択します。
+ DNS エイリアスの関連付けを解除するには - **[Current aliases]** (現在のエイリアス) リストで、関連付けを解除するエイリアスを選択します。**[Disassociate]** (関連付け解除) を選択します。
**[Current aliases]** (現在のエイリアス) リストで管理しているエイリアスのステータスをモニタリングできます。リストを更新してステータスを更新します。エイリアスがファイルシステムに関連付け、または関連付け解除されるまでには、最大 2.5 分かかります。
1. エイリアスが **[Available]** (使用可能) の場合、サービスプリンシパル名 (SPN) を設定し、エイリアスの DNS CNAME レコードを更新または作成することで、DNS エイリアスを使用してファイルシステムにアクセスできます。詳細については、「[DNS エイリアスを使用したデータへのアクセス](dns-aliases.md)」を参照してください。
## 既存のファイルシステムに DNS エイリアスを関連付けるには (CLI)
1. `associate-file-system-aliases` CLI コマンド、または [AssociateFileSystemAliases](https://docs.aws.amazon.com/fsx/latest/APIReference/API_AssociateFileSystemAliases.html) API オペレーションを使用して、既存のファイルシステムに DNS エイリアスを関連付けます。
次の CLI リクエストは、指定されたファイルシステムに 2 つのエイリアスを関連付けます。
```
aws fsx associate-file-system-aliases \
--file-system-id fs-0123456789abcdef0 \
--aliases financials.corp.example.com transfers.corp.example.com
```
レスポンスには、Amazon FSx がファイルシステムに関連付けているエイリアスのステータスが表示されます。
```
{
"Aliases": [
{
"Name": "financials.corp.example.com",
"Lifecycle": CREATING
},
{
"Name": "transfers.corp.example.com",
"Lifecycle": CREATING
}
]
}
```
1. `describe-file-system-aliases` CLI コマンド ([DescribeFileSystemAliases](https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeFileSystemAliases.html) は同等の API オペレーション) を使用して、関連付けているエイリアスのステータスをモニタリングします。
1. `Lifecycle` の値が [AVAILABLE] (利用可能) の場合 (最大 2.5 分かかるプロセス)、サービスプリンシパル名 (SPN) を設定し、エイリアスの DNS CNAME レコードを更新または作成することで、DNS エイリアスを使用してファイルシステムにアクセスできます。詳細については、「[DNS エイリアスを使用したデータへのアクセス](dns-aliases.md)」を参照してください。
## ファイルシステムから DNS エイリアスの関連付けを解除するには (CLI)
+ `disassociate-file-system-aliases` CLI コマンドまたは [AssociateFileSystemAliases](https://docs.aws.amazon.com/fsx/latest/APIReference/API_DisassociateFileSystemAliases.html) API オペレーションを使用して、既存のファイルシステムから DNS エイリアスの関連付けを解除します。
次のコマンドは、ファイルシステムから 1 つのエイリアスの関連付けを解除します。
```
aws fsx disassociate-file-system-aliases \
--file-system-id fs-0123456789abcdef0 \
--aliases financials.corp.example.com
```
レスポンスには、Amazon FSx がファイルシステムとの関連付けを解除しているエイリアスのステータスが表示されます。
```
{
"Aliases": [
{
"Name": "financials.corp.example.com",
"Lifecycle": DELETING
}
]
}
```
エイリアスのステータスをモニタリングするには、`describe-file-system-aliases` CLI コマンド ([DescribeFileSystemAliases](https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeFileSystemAliases.html) は同等の API オペレーション) を使用します。エイリアスが削除されるまでには、最大 2.5 分かかります。
# ユーザーセッションと開いているファイル
共有フォルダツールを使用して、 FSx for Windows File Server ファイルシステムで、接続されているユーザーセッションと開いているファイルをモニタリングできます。共有フォルダツールを使用すると、ファイルシステムに接続されているユーザーと、どのファイルが誰によって開かれているかをモニタリングするための一元的な場所が提供されます。このツールを使用して、以下のことを行うことができます:
+ ロックされたファイルへのアクセスを復元します。
+ ユーザーセッションを切断すると、そのユーザーが開いたすべてのファイルが閉じられます。
PowerShell でのリモート管理に Windows ネイティブの共有フォルダ GUI ツールと Amazon FSx CLI を使用して、ユーザーセッションを管理し、 FSx for Windows File Server ファイルシステム上のファイルを開くことができます。
## GUI を使用してユーザーとセッションを管理する
次の手順では、Microsoft Windows 共有フォルダツールを使用して、Amazon FSx ファイルシステムでユーザーセッションを管理してファイルを開く方法の詳細を説明します。
### 共有フォルダツールを起動するには
1. Amazon EC2 インスタンスを起動し、Amazon FSx ファイルシステムが接続している Microsoft アクティブディレクトリに接続します。これを行うには、*AWS Directory Service 管理ガイド* から次のいずれかの手順を選択します:
+ [Windows EC2 インスタンスにシームレスに接続する](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/launching_instance.html)
+ [Windows インスタンスを手動で結合させる](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/join_windows_instance.html)
1. ファイルシステム管理者グループのメンバーであるユーザーとしてインスタンスに接続します。 AWS Managed Microsoft Active Directory では、このグループは委任 AWS FSx 管理者と呼ばれます。セルフマネージド Microsoft アクティブディレクトリで、このグループはドメイン管理者、または作成時に指定した管理者グループのカスタム名と呼ばれます。詳細については、*Amazon EC2 ユーザーガイド* の [Windows インスタンスへの接続](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/connecting_to_windows_instance.html) を参照してください。
1. **[Start]** (スタート) メニューを開き、`Run As Administrator` を使って **fsmgmt.msc** を実行します。これにより、共有フォルダ GUI ツールが開きます。
1. **[Action]** (アクション) で、**[Connect to another computer]** (別のコンピュータに接続する) を選択します。
1. **[Another computer]** (別のコンピュータ) で、Amazon FSx ファイルシステムの DNS 名 (例えば、`fs-012345678901234567.ad-domain.com`) を入力します。
1. **OK** を選択します。Amazon FSx ファイルシステムのエントリが共有フォルダツールのリストに表示されます。
### ユーザーセッションを管理するには (GUI)
共有フォルダツールで、**[Sessions]** (セッション) を選択し、 FSx for Windows File Server ファイルシステムに接続されているすべてのユーザーセッションを表示します。ユーザーまたはアプリケーションが Amazon FSx ファイルシステム上のファイル共有にアクセスしている場合、このスナップインはユーザーのセッションを表示します。セッションのコンテキスト (右クリック) メニューを開き、**[Close Session]** (セッションを閉じる) を選択すると、セッションを切断できます。
![\[FSx for Windows File Server ファイルシステムに接続されているユーザーセッションを表示している共有フォルダツール。\]](http://docs.aws.amazon.com/ja_jp/fsx/latest/WindowsGuide/images/usersessions-close.png)
開いているセッションをすべて切断するには、**[Sessions]** (セッション) のコンテキスト (右クリック) メニューを開き、**[Disconnect All Sessions]** (すべてのセッションを切断する) を選択してアクションを確認します。
![\[セッションのコンテキストメニューが開いている共有フォルダツール。\]](http://docs.aws.amazon.com/ja_jp/fsx/latest/WindowsGuide/images/discnnct-all-sessions.png)
### 開いているファイルを管理するには (GUI)
共有フォルダツールで、**[Open Files]** (開いているファイル) を選択して、現在開いているシステム上のすべてのファイルを表示します。ビューには、どのユーザーがファイルやフォルダを開いているかも表示されます。この情報は、他のユーザーが特定のファイルを開くことができない理由を追跡するのに役立ちます。リスト内のファイルのエントリのコンテキスト (右クリック) メニューを開き、**[Close Open File]** (開いているファイルを閉じる) を選択すると、ユーザーが開いているすべてのファイルを閉じることができます。
![\[共有フォルダツールの開いているファイルタブ。\]](http://docs.aws.amazon.com/ja_jp/fsx/latest/WindowsGuide/images/clse-opn-file.png)
ファイルシステム上で開いているすべてのファイルを切断するには、**[Open Files]** (開いているファイル) のコンテキスト (右クリック) メニューで **開いているファイルをすべて切断する** を選択し、アクションを確認します。
![\[共有フォルダツールの開いているファイルのコンテキストメニュー。\]](http://docs.aws.amazon.com/ja_jp/fsx/latest/WindowsGuide/images/clse-ALL-opn-file.png)
## PowerShell を使用してユーザーセッションを管理し、ファイルを開く
PowerShell でのリモート管理用の Amazon FSx CLI を使用して、アクティブなユーザーセッションを管理し、ファイルシステム上のファイルを開くことができます。この CLI を使用する方法については、「[PowerShell での Amazon FSx CLI の使用](administering-file-systems.md#remote-pwrshell)」を参照してください。
ユーザーセッションおよび開いているファイルの管理に使用できるコマンドは次のとおりです。
| コマンド | 説明 |
| --- | --- |
| **Get-FSxSmbSession** | ファイルシステムと関連するクライアント間で現在確立されているサーバーメッセージブロック (SMB) セッションに関する情報を取得します。 |
| **Close-FSxSmbSession** | SMB セッションを終了します。 |
| **Get-FSxSmbOpenFile** | ファイルシステムに接続されているクライアントに対して開いているファイルに関する情報を取得します。 |
| **Close-FSxSmbOpenFile** | SMB サーバーのクライアントの 1 つに対して開いているファイルを閉じます。 |
各コマンドのオンラインヘルプには、すべてのコマンドオプションのリファレンスが記載されています。このヘルプにアクセスするには、**-?** (例えば、 **Get-FSxSmbSession -?**) でコマンドを実行します。
# FSx for Windows File Server のファイルサーバーリソースマネージャー
File Server Resource Manager (FSRM) は、Amazon FSx for Windows File Server ファイルシステムに保存されているデータの管理と分類に役立つ Windows Server の機能です。FSRM は、ストレージコストの制御、データ管理ポリシーへの準拠の維持、ビジネスルールに基づくファイルの整理に役立つ、自動化されたポリシーの適用とレポート機能を提供します。
FSRM を使用すると、ストレージ制限を設定して、ユーザーが過剰なストレージを消費しないようにしたり、機密データを自動的に識別および分類したり、不正なファイルタイプがビジネスフォルダに保存されないようにしたり、ストレージの使用パターンに関する詳細なレポートを生成したりできます。これらの機能は、すべてのファイルまたはフォルダに手動で介入することなく、整理され、効率的で、準拠したファイルシステムを維持するのに役立ちます。
FSRM は、以下を必要とする組織にとって特に重要です。
+ ユーザーと部門が保存できるディスク容量を制限してストレージコストを制御する
+ 個人を特定できる情報や財務記録などの機密データを特定する
+ 特定のフォルダで許可されるファイルタイプに関するポリシーを適用する
+ データ保持、ファイルの所有権、またはストレージの使用状況に関するコンプライアンスレポートを生成する
+ 組織全体でストレージがどのように使用されているかを可視化する
## 主な機能
+ **[クォータ管理](fsrm-quota-management.md)** - フォルダにストレージ制限を設定して、ユーザーとアプリケーションが消費できる容量を制御します。ユーザーが制限を超えるのを防ぐハードクォータや、通知の送信中に超過を許可するソフトクォータを設定できます。クォータは、ストレージコストを管理し、ユーザーや部門が不釣り合いな量のストレージを消費するのを防ぐのに役立ちます。
+ **[ファイルスクリーニング](fsrm-file-screening.md)** - ユーザーが特定のフォルダに保存できるファイルのタイプを制御します。ビジネスフォルダ内の実行可能ファイル、メディアファイル、個人ドキュメントなどの不正なファイルタイプをブロックできます。ファイルスクリーニングは、データ管理ポリシーを適用し、セキュリティリスクを軽減し、非ビジネスファイルによるストレージの無駄を防ぐのに役立ちます。
+ **[ファイル分類](fsrm-file-classification.md)** - コンテンツまたは場所に基づいて、メタデータプロパティをファイルに自動的に割り当てます。分類は、ファイルの整理、機密データの識別、保持ポリシーの適用、ファイルの特性に基づいたレポートの生成に役立ちます。データ機密性、部門、保持期間、または定義したその他のカスタムプロパティでファイルを分類できます。
+ **[ストレージレポート](fsrm-storage-reports.md)** - 大きなファイル、重複ファイル、所有者別のファイル、タイプ別のファイル、クォータの使用など、ファイルシステムの使用状況に関する詳細なレポートを生成します。ストレージレポートは、ストレージの使用状況を理解し、アーカイブまたは削除できるファイルを特定し、ストレージ管理について情報に基づいた意思決定を行うのに役立ちます。
**Topics**
+ [主な機能](#managing-files-fsrm-capabilities)
+ [File Server Resource Manager の開始方法](enabling-fsrm.md)
+ [クォータ管理](fsrm-quota-management.md)
+ [ファイルグループ](fsrm-file-groups.md)
+ [ファイルスクリーニング](fsrm-file-screening.md)
+ [ファイル分類](fsrm-file-classification.md)
+ [ストレージレポート](fsrm-storage-reports.md)
+ [ファイル管理タスク](fsrm-file-management.md)
+ [FSRM 設定](fsrm-settings.md)
+ [イベントログ](fsrm-event-logs.md)
+ [一般的なユースケース](fsrm-common-use-cases.md)
# File Server Resource Manager の開始方法
新しい Amazon FSx for Windows File Server ファイルシステムを作成するときに File Server Resource Manager (FSRM) を有効にすることも、既存のファイルシステムを更新して FSRM を有効にすることもできます。
FSRM は、SSD ストレージとスループット容量が 128 MB/秒以上の Amazon FSx for Windows File Server ファイルシステムでのみサポートされています。ファイルシステムを作成した後、ストレージタイプを SSD に更新し、スループットキャパシティをいつでも変更できます。詳細については、「[FSx for Windows ファイルシステムのストレージタイプの更新](updating-storage-type.md)」および「[スループット容量の管理](managing-throughput-capacity.md)」を参照してください。
## ファイルシステムの作成時に FSRM を有効にするには (コンソール)
1. [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/) で Amazon FSx コンソールを開きます
1. ダッシュボードで **ファイルシステムの作成** を選択し、ファイルシステム作成ウィザードを起動します。
1. **Amazon FSx for Windows File Server** を選択し、次**へ**を選択します。
1. **標準作成**オプションを選択する
1. 必要な情報を入力します。
1. **File Server Resource Manager** ブロックを開き、**有効**を選択します。
1. **イベントログの送信先**として、次のいずれかのオプションを選択します。
+ **CloudWatch Logs** - FSRM イベントログを受信する CloudWatch Logs ロググループを選択します。CloudWatch Logs ロググループの名前は、`'/aws/fsx/'` プレフィックスで始まる必要があります。
+ **Kinesis Data Firehose** - FSRM イベントログを受信する Kinesis Data Firehose 配信ストリームを選択する
1. 残りのセクションを完了し、**ファイルシステムの作成**を選択します。
## ファイルシステムの作成時に FSRM を有効にするには (CLI)
FSx for Windows File Server ファイルシステムの作成時に FSRM を有効にするには、 AWS CLI コマンド を使用します`create-file-system`。`--windows-configuration` パラメータに次の FSRM 設定を含めます。
+ `FsrmServiceEnabled` - `true` に設定
+ `EventLogDestination` - FSRM イベントログの送信先を指定する Amazon リソースネーム (ARN)。CloudWatch Logs ロググループ ARN または Kinesis Data Firehose 配信ストリーム ARN を使用できます。
```
aws fsx create-file-system \
--file-system-type WINDOWS \
--storage-capacity 300 \
--storage-type SSD \
--subnet-ids subnet-0123456789abcdef0 \
--windows-configuration "ThroughputCapacity=128,WindowsFsrmConfiguration={FsrmServiceEnabled=true,EventLogDestination=arn:aws:logs:us-east-1:123456789012:log-group:/aws/fsx/fsrm}"
```
## 既存のファイルシステムの FSRM 設定を変更するには (コンソール)
1. [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/) で Amazon FSx コンソールを開きます。
1. **ファイルシステム**に移動し、変更する Windows ファイルシステムを選択します。
1. **[Administration]** (管理) タブを選択します。
1. **ファイルサーバーリソースマネージャー**セクションで、**管理**を選択します。
1. 必要な変更を加えます。
+ イベントログの送信先を変更するには、別の CloudWatch Logs ロググループまたは Kinesis Data Firehose 配信ストリームを選択します。
+ FSRM を有効にするには、**Enabled** を選択します。
+ FSRM を無効にするには、**Disabled** を選択します。
**重要**
マルチ AZ ファイルシステムではこのプロセス中に自動フェイルオーバーとフェイルバックイベントが発生しますが、シングル AZ ファイルシステムでは短時間使用できなくなります。
1. **[保存]** を選択します。
更新の進行状況は、ファイルシステムの詳細ページの**「更新**」タブでモニタリングできます。
## 既存のファイルシステムの FSRM 設定を変更するには (CLI)
既存の FSx for Windows File Server ファイルシステムで FSRM AWS を有効または無効にするには、CLI コマンド を使用します`update-file-system`。
### FSRM の有効化
FSRM を有効にするには、 `--windows-configuration`パラメータに次の FSRM 設定を含めます。
+ `FsrmServiceEnabled` - `true` に設定
+ `EventLogDestination` - FSRM イベントログの送信先を指定する Amazon リソースネーム (ARN)。CloudWatch Logs ロググループ ARN または Kinesis Data Firehose 配信ストリーム ARN を使用できます。
```
aws fsx update-file-system \
--file-system-id fs-0123456789abcdef0 \
--windows-configuration FsrmConfiguration='{FsrmServiceEnabled=true,EventLogDestination=”arn:aws:logs:us-east-1:123456789012:log-group:/aws/fsx/fsrm”}'
```
### FSRM の無効化
FSRM を無効にするには:
```
aws fsx update-file-system \
--file-system-id fs-0123456789abcdef0 \
--windows-configuration FsrmConfiguration='{FsrmServiceEnabled=false}'
```
**重要**
マルチ AZ ファイルシステムではこのプロセス中に自動フェイルオーバーとフェイルバックイベントが発生しますが、シングル AZ ファイルシステムでは短時間使用できなくなります。
## FSx リモート PowerShell
FSRM 機能を設定して使用するには、PowerShell でのリモート管理に Amazon FSx CLI を使用する必要があります。詳細については、「[Amazon FSx リモート PowerShell セッションの開始](start-remote-powershell-session.md)」を参照してください。
# クォータ管理
File Server Resource Manager (FSRM) のクォータ管理を使用して、ユーザーが FSx for Windows File Server ファイルシステムで消費するストレージ容量を制御できます。クォータは、特定のフォルダに保存できるデータの量を制限し、ストレージ使用量が定義されたしきい値に近づいたときに通知を生成することで、ストレージ容量を管理するのに役立ちます。
## クォータ管理の仕組み
クォータ管理には、ファイルシステムのフォルダに適用できる 2 種類のクォータが用意されています。
ハードクォータ
クォータ制限に達した後にユーザーがファイルを保存できないようにします。ユーザーがクォータ制限を超えるファイルを保存しようとすると、オペレーションは失敗し、ユーザーはエラーメッセージを受け取ります。
ソフトクォータ
違反のログ記録中にクォータ制限を超えることをユーザーに許可します。ソフトクォータは、厳密な制限を適用せずにストレージの使用状況をモニタリングするのに役立ちます。
## クォータテンプレート
クォータテンプレートは、サイズ制限、クォータタイプ (ハードまたはソフト）、しきい値通知など、クォータ設定を定義する再利用可能な設定を提供します。クォータテンプレートを作成したら、毎回同じ設定を再設定することなく、複数のフォルダに適用できます。クォータテンプレートを更新する場合、オプションで、そのテンプレートから作成されたすべてのクォータに変更を適用できます。
クォータテンプレートを使用すると、いくつかの利点があります。
+ **整合性** - 類似フォルダのクォータ設定が同じであることを確認します
+ **効率** - クォータ設定を複数のフォルダにすばやく適用する
+ **保守性** - テンプレートを変更して複数のフォルダのクォータ設定を更新する
## クォータの自動適用
自動適用クォータは、指定されたテンプレートに基づいてサブフォルダのクォータを自動的に作成します。親フォルダに自動適用クォータを作成すると、FSRM は既存の各サブフォルダと、ユーザーが将来作成する新しいサブフォルダのクォータを自動的に生成します。このアプローチは、複数のユーザーディレクトリまたは部門フォルダに一貫したクォータ制限を適用するシナリオに役立ちます。
## しきい値通知
しきい値は、FSRM が特定のアクションを実行する使用レベルを定義します。クォータごとに複数のしきい値を設定し、各しきい値をクォータ制限の割合に設定できます。ストレージ使用量がしきい値の割合に達すると、FSRM は次のアクションを実行できます。
イベントログ
モニタリングと分析のためにイベントを Amazon CloudWatch または Amazon Kinesis Data Firehose に記録します。イベントの重要度レベル (情報、警告、またはエラー) を指定し、カスタムメッセージ本文を指定できます。イベントログ記録は、クォータの使用状況をモニタリングし、既存のモニタリングシステムと統合するのに役立ちます。
ストレージレポート
ストレージ領域を消費するファイルとフォルダに関する詳細情報を提供するストレージ使用状況レポートを生成します。ストレージレポートは、どのユーザーまたはアプリケーションが最もストレージを消費しているかを特定し、ストレージ管理について情報に基づいた意思決定を行うのに役立ちます。詳細については、「[ストレージレポート](fsrm-storage-reports.md)」を参照してください。
クォータごとに異なるアクションで複数のしきい値を設定できます。例えば、情報イベントの使用率が 75%、警告イベントの使用率が 90% のクォータを設定できます。
## クォータ管理コマンド
Quotas を管理するために、FSx リモート PowerShell コマンドの 3 つのファミリーにアクセスできます。
1. **クォータコマンド** - 特定のフォルダのクォータを作成、取得、変更、削除、更新します。これらのコマンドは、folder-by-folderクォータを管理する必要がある場合に使用します。
1. **クォータテンプレートコマンド** - 再利用可能なクォータ設定を定義するクォータテンプレートを作成、取得、変更します。これらのコマンドを使用して、複数のフォルダに適用できる標準クォータポリシーを確立します。
1. **自動クォータコマンド** - サブフォルダのクォータを自動的に生成する自動適用クォータを作成、取得、変更、削除、更新します。個々のクォータを手動で作成せずに、複数のサブフォルダに一貫したクォータ制限を適用する必要がある場合は、これらのコマンドを使用します。
### Quota Management FSx リモート PowerShell コマンドのリスト
**注記**
このページのすべての例では、ファイルシステムの Windows Remote PowerShell エンドポイントで ` $FSxWindowsRemotePowerShellEndpoint`変数が定義されていることを前提としています。このエンドポイントは、ファイルシステムの詳細ページの Amazon FSx コンソール、または コマンドを使用して AWS CLI `describe-file-systems`確認できます。
### クォータコマンド
#### 新しい FSxFSRMQuota
フォルダに新しいクォータを作成します。クォータは、ユーザーがフォルダに保存できるデータの量を制限します。オプションで、ユーザーがクォータのしきい値を超えたときに通知を生成するようにクォータを設定できます。
**パラメータ :**
+ `Folder (string)` - 必須。クォータが適用されるフォルダパス。
+ `Size (string)` - テンプレートを使用しない場合は必須です: クォータのサイズ制限。
+ `Template (string)` - オプション。使用する既存のクォータテンプレートの名前。テンプレートを指定する場合、 説明パラメータのみを使用できます。他のすべての設定はテンプレートから継承されます。
+ `Description (string)` - オプション。クォータの説明。
+ `SoftLimit (boolean)` - オプション。true に設定すると、 は、違反のログ記録中にユーザーが制限を超えることを許可するソフトクォータを作成します。
+ `Disabled (boolean)` - オプション。true に設定すると、 は無効状態のクォータを作成します。
+ `ThresholdConfigurations (array)` - オプション。さまざまな使用レベルで実行するアクションを指定するしきい値設定の配列。各設定には次のプロパティがあります。
+ `ThresholdPercentage (number)`: アクションをトリガーするクォータ制限の割合。0～250 の値を入力します。
+ `Action (array)`: しきい値に達したときに実行する 1 つ以上のアクション。各アクションには次のプロパティがあります。
+ `ActionType`: 実行するアクションのタイプ。次の値を指定できます。
1. `Event`: ファイルシステムのイベントログにイベントを記録します。イベントを指定するときは、次のプロパティも指定する必要があります。
+ `EventType`: 情報、警告、またはエラー
+ `MessageBody`: イベントでログに記録するメッセージテキスト。
1. `Report`: ストレージ使用状況レポートを生成します。
**例:**
**1. クォータテンプレートを使用せずに、5GB のハードクォータを作成します。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMQuota -Folder "share\test" -Size 5GB
}
```
**2。しきい値通知を使用してソフトクォータを作成する**
```
$thresholds = [System.Collections.ArrayList]@()
$warning = @{
ThresholdPercentage = 75
Action = @(
@{
ActionType = "Event"
EventType = "Warning"
MessageBody = "Quota usage has reached 75%"
}
)
}
$thresholds.Add($warning)
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList ($thresholds) -ScriptBlock {
param($thresholds)
New-FSxFSRMQuota -Folder "share/test" -Size 1GB -Description "Test quota" -SoftLimit -ThresholdConfigurations $Using:thresholds
}
```
#### Get-FSxFSRMQuota
ファイルシステムから 1 つ以上のクォータを取得します。コマンドは、サイズ制限、しきい値、現在の使用状況など、クォータ設定に関する詳細を返します。
**パラメータ :**
+ `Folder (string)` - オプション。クォータを取得するフォルダパス。フォルダパスを指定しない場合、コマンドはファイルシステム上のすべてのクォータを返します。
**例:**
**1. ファイルシステム上の既存のクォータをすべて取得します。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMQuota
}
```
#### Remove-FSxFSRMQuota
ファイルシステムの指定されたフォルダからクォータを削除します。
**パラメータ :**
+ `Folder (string)` - 必須。クォータを削除するフォルダパス。
+ `PassThru (boolean)` - オプション。true に設定すると、削除されたクォータオブジェクトが返されます。
**例:**
**1. クォータを削除します。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Remove-FSxFSRMQuota -Folder "share\test" -PassThru
}
```
#### Set-FSxFSRMQuota
既存のクォータの設定を変更します。
**パラメータ :**
+ `Folder (string)` - 必須。変更するクォータを含むフォルダパス。
+ `Description (string)` - オプション。クォータの新しい説明。
+ `Size (string)` - オプション。クォータの新しいサイズ制限。
+ `SoftLimit (boolean)` - オプション。true に設定すると、クォータがソフト制限に変更され、ユーザーは違反のログ記録中に制限を超えることができます。
+ `Disabled (boolean)` - オプション。true に設定すると、 はクォータを無効にします。false に設定すると、クォータが有効になります。
+ `ThresholdConfigurations (array)` - オプション。新しいしきい値設定の配列。各しきい値設定には、次のプロパティがあります。
+ `ThresholdPercentage (number)`: アクションをトリガーするクォータ制限の割合。0～250 の値を入力します。
+ `Action (array)`: しきい値に達したときに実行する 1 つ以上のアクション。各アクションには次のプロパティがあります。
+ `ActionType`: 実行するアクションのタイプ。次の値を指定できます。
1. `Event`: ファイルシステムのイベントログにイベントを記録します。イベントを指定するときは、次のプロパティも指定する必要があります。
+ `EventType`: 情報、警告、またはエラー
+ `MessageBody`: イベントでログに記録するメッセージテキスト。
1. `Report`: ストレージ使用状況レポートを生成します。
+ `PassThru (boolean)` - オプション。true に設定すると、変更されたクォータオブジェクトが返されます。
**例:**
**1. クォータのサイズと説明を変更します。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Set-FSxFSRMQuota -Folder "share\department" -Size 2GB -Description "Updated quota for department share"
}
```
**2。クォータを無効にする**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Set-FSxFSRMQuota -Folder "share\department" -Disabled: $true
}
```
#### Update-FSxFSRMQuota
フォルダをスキャンしてクォータの現在の使用状況統計を再計算し、実際に使用されているスペースの量を決定します。
**パラメータ :**
+ `Folder (string)` - 必須。更新するクォータを含むフォルダパス。
+ `PassThru (boolean)` - オプション。true に設定すると、更新されたクォータオブジェクトが返されます。
**例:**
**1. 指定されたクォータの現在の使用状況統計を再計算します。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Update-FSxFSRMQuota -Folder "share\department" -PassThru
}
```
### クォータテンプレートコマンド
#### 新しい FSxFSRMQuotaTemplate
クォータの再利用可能な設定を定義する新しいクォータテンプレートを作成します。
**パラメータ :**
+ `Name (string)` - 必須。クォータテンプレートの名前。
+ `Size (string)` - 必須。クォータテンプレートが適用するサイズ制限。
+ `Description (string)` - オプション。クォータテンプレートの説明。
+ `SoftLimit (boolean)` - オプション。true に設定すると、 は使用量をレポートするソフトクォータのテンプレートを作成しますが、制限は適用しません。
+ `ThresholdConfigurations (array)` - オプション。さまざまな使用レベルで実行するアクションを指定するしきい値設定の配列。各設定には次のプロパティがあります。
+ `ThresholdPercentage (number)`: アクションをトリガーするクォータ制限の割合。0～250 の値を入力します。
+ `Action (array)`: しきい値に達したときに実行する 1 つ以上のアクション。各アクションには次のプロパティがあります。
+ `ActionType`: 実行するアクションのタイプ。次の値を指定できます。
1. `Event`: ファイルシステムのイベントログにイベントを記録します。イベントを指定するときは、次のプロパティも指定する必要があります。
+ `EventType`: 情報、警告、またはエラー
+ `MessageBody`: イベントでログに記録するメッセージテキスト。
1. `Report`: ストレージ使用状況レポートを生成します。
**例:**
**1. ハード 1 GB 制限テンプレートを作成します。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMQuotaTemplate -Name "1GB Hard Limit" -Size 1GB -Description "Standard 1GB hard limit template"
}
```
**2. 使用率が 90% の警告しきい値を持つ 5 GB のソフト制限テンプレートを作成する**
```
$threshold = @{
ThresholdPercentage = 90
Action = @(
@{
ActionType = "Event"
EventType = "Warning"
MessageBody = "Quota usage has reached 90% of the limit"
}
)
}
$thresholds = [System.Collections.ArrayList]@()
$thresholds.Add($threshold)
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList $thresholds -ScriptBlock {
param($thresholds)
New-FSxFSRMQuotaTemplate -Name "5GB Soft Limit" -Size 5GB -Description "5GB soft limit with 90% warning" -SoftLimit -ThresholdConfigurations $Using:thresholds
}
```
#### Get-FSxFSRMQuotaTemplate
ファイルシステムから 1 つ以上のクォータテンプレートを取得します。
**パラメータ :**
+ `Name (string)` - オプション。取得する特定のクォータテンプレートの名前。名前を指定しない場合、コマンドはすべてのクォータテンプレートを返します。
**例:**
**1. ファイルシステム上のすべてのクォータテンプレートを取得します。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMQuotaTemplate
}
```
#### Set-FSxFSRMQuotaTemplate
クォータテンプレートのプロパティを変更します。
**パラメータ :**
+ `Name (string)` - 必須。変更するクォータテンプレートの名前。
+ `Description (string)` - オプション。テンプレートの新しい説明。
+ `Size (string)` - オプション。テンプレートの新しいサイズ制限。
+ `SoftLimit (boolean)` - オプション。true に設定すると、テンプレートが変更され、使用量をレポートするソフトクォータが作成されますが、制限は適用されません。
+ `ThresholdConfigurations (array)` - オプション。さまざまな使用レベルで実行するアクションを指定するしきい値設定の配列。各設定には次のプロパティがあります。
+ `ThresholdPercentage (number)`: アクションをトリガーするクォータ制限の割合。0～250 の値を入力します。
+ `Action (array)`: しきい値に達したときに実行する 1 つ以上のアクション。各アクションには次のプロパティがあります。
+ `ActionType`: 実行するアクションのタイプ。次の値を指定できます。
1. `Event`: ファイルシステムのイベントログにイベントを記録します。イベントを指定するときは、次のプロパティも指定する必要があります。
+ `EventType`: 情報、警告、またはエラー
+ `MessageBody`: イベントでログに記録するメッセージテキスト。
1. `Report`: ストレージ使用状況レポートを生成します。
+ `UpdateDerived (boolean)` - オプション。true に設定すると、このテンプレートから作成されたすべてのクォータが更新されます。
+ `UpdateDerivedMatching (boolean)` - オプション。true に設定すると、このテンプレートから作成され、作成後に変更されていないクォータのみが更新されます。
+ `PassThru (boolean)` - オプション。true に設定すると、変更されたテンプレートオブジェクトが返されます。
**例:**
**1. クォータテンプレートのサイズと説明を変更します。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Set-FSxFSRMQuotaTemplate -Name "5GB Soft Limit" -Size 10GB -Description "Updated to 10GB soft limit"
}
```
**2. クォータテンプレートを変更し、テンプレートから作成されたすべてのクォータを更新します。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Set-FSxFSRMQuotaTemplate -Name "1GB Hard Limit" -Size 2GB -UpdateDerived
}
```
#### Reset-FSxFSRMQuota
指定されたテンプレートの設定と一致するようにクォータをリセットします。
#### パラメータ
+ `Folder (string)` - 必須。リセットするクォータを含むフォルダパス。
+ `Template (string)` - 必須。適用するクォータテンプレートの名前。
#### 例
**例: クォータテンプレートで定義されている設定と一致するようにクォータをリセットします。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Reset-FSxFSRMQuota -Folder "share\department" -Template "1GB Hard Limit"
}
```
### Auto Quota コマンド
#### 新しい FSxFSRMAutoQuota
`New-FSxFSRMAutoQuota` コマンドは、指定されたフォルダに自動適用クォータを作成します。自動適用クォータは、既存の各サブフォルダの指定されたテンプレートと、指定されたフォルダに作成された新しいサブフォルダに基づいてクォータを自動的に生成します。
##### パラメータ
+ `Folder (string)` - 必須。自動適用クォータが作成されるフォルダパス。
+ `Template (string)` - オプション。自動適用クォータに使用する既存のクォータテンプレートの名前。
+ `Disabled (boolean)` - オプション。true に設定すると、 は無効状態の自動適用クォータを作成します。
##### 例
**1. 指定されたテンプレートをすべてのサブフォルダに自動的に適用する自動適用クォータを作成します。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMAutoQuota -Folder "share\department" -Template "250 MB Extended Limit"
}
```
#### Get-FSxFSRMAutoQuota
`Get-FSxFSRMAutoQuota` コマンドは、ファイルシステムから 1 つ以上の自動適用クォータを取得します。
##### パラメータ
+ `Folder (string)` - オプション。自動適用クォータを取得するフォルダパス。パスの`...`最後に を使用して、すべてのサブフォルダを含めることもできます。
フォルダパスを指定しない場合、コマンドはファイルシステム上のすべての自動適用クォータを返します。
##### 例
**1. ファイルシステムのすべての自動適用クォータを取得します。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMAutoQuota
}
```
#### Remove-FSxFSRMAutoQuota
`Remove-FSxFSRMAutoQuota` コマンドは、指定したフォルダから自動適用クォータを削除します。自動適用クォータを削除すると、 コマンドは関連するクォータテンプレートから派生したサブフォルダからすべてのクォータも削除します。
##### パラメータ
+ `Folder (string)` - 必須。自動適用クォータを削除するフォルダパス。
+ `PassThru (boolean)` - オプション。true に設定すると、削除された自動適用クォータオブジェクトを返します。
##### 例
**1. 特定のフォルダから自動適用クォータを削除します。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Remove-FSxFSRMAutoQuota -Folder "share\department" -PassThru
}
```
#### Set-FSxFSRMAutoQuota
`Set-FSxFSRMAutoQuota` コマンドは、自動適用クォータの設定を変更します。
##### パラメータ
+ `Folder (string)` - 必須。変更する自動適用クォータを含むフォルダパス。
+ `Template (string)` - オプション。適用するクォータテンプレートの名前。
+ `Disabled (boolean)` - オプション。true に設定すると、自動適用クォータが無効になります。false に設定すると、自動適用クォータが有効になります。
+ `UpdateDerived (boolean)` - オプション。true に設定すると、この自動適用クォータから派生した既存のクォータがすべて更新されます。
+ `UpdateDerivedMatching (boolean)` - オプション。true に設定すると、 は作成後に変更されていない派生クォータのみを更新します。
+ `PassThru (boolean)` - オプション。true に設定すると、変更された自動適用クォータオブジェクトを返します。
##### 例
**1. 自動適用クォータで使用されるクォータテンプレートを変更します。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Set-FSxFSRMAutoQuota -Folder "share\department" -Template "100 MB Limit"
}
```
**2. 自動適用クォータを無効にし、そこから派生したすべてのクォータを更新します。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Set-FSxFSRMAutoQuota -Folder "share\department" -Disabled: $true -UpdateDerived
}
```
#### Update-FSxFSRMAutoQuota
`Update-FSxFSRMAutoQuota` コマンドは、自動適用クォータのプロパティとそれから派生したクォータを再計算するために、 フォルダをスキャンして、実際に使用されているスペースの量を決定します。
##### パラメータ
+ `Folder (string)` - 必須。更新する自動適用クォータを含むフォルダパス。
+ `PassThru (boolean)` - オプション。true に設定すると、更新された自動適用クォータオブジェクトを返します。
##### 例
**1. 使用状況統計を再計算し、更新された自動適用クォータオブジェクトを返します。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Update-FSxFSRMAutoQuota -Folder "share\department" -PassThru
}
```
# ファイルグループ
ファイルグループは、ファイル[画面](fsrm-file-screening.md)を設定するときに使用する必要があるファイル名パターンの論理コレクションを定義し、オプションで[ストレージレポート](fsrm-storage-reports.md)を生成するときに使用できます。ファイルグループには、インクルードパターン (一致するファイル) と除外パターン (一致から除外するファイル) が含まれ、毎回個々のパターンを指定するのではなく、ファイルグループ名で参照します。
## ファイルグループの使用方法
次の FSRM 機能にはファイルグループが必要です。
+ **ファイル画面** - ブロックまたはモニタリングするファイルタイプを定義するには、1 つ以上のファイルグループを指定する必要があります。
+ **ファイル画面の例外** - 親フォルダ内のファイル画面をブロックしても、許可するファイルタイプを定義するには、1 つ以上のファイルグループを指定する必要があります。
+ **ファイル画面テンプレート** - テンプレートがブロックまたはモニタリングするファイルタイプを定義するには、1 つ以上のファイルグループを指定する必要があります。
ファイルグループは、次の FSRM 機能ではオプションです。
+ **ストレージレポート** - オプションでファイルグループでレポートをフィルタリングして、特定のファイルタイプのストレージ使用状況を分析できます。たとえば、オーディオファイルとビデオファイルのみを表示するレポートを生成できます。
## ファイル名パターン
ファイルグループは、ワイルドカードパターンを使用してファイル名を一致させます。インクルードパターン (一致させるファイル) と除外パターン (一致から除外するファイル) の両方を指定できます。
FSRM は、次のワイルドカードをサポートしています。
+ **アスタリスク (\$1)** - 0 文字以上と一致
+ **疑問符 (?)** - 1 文字のみに一致
たとえば、パターンは `report.doc` 、、 `report.docx`などのファイル`*.doc*`と一致し`document.doc`、除外パターンは Microsoft Office アプリケーションによって作成された一時ファイル` ~$*`を除外します。
## デフォルトのファイルグループ
ファイルシステムで FSRM を有効にすると、次のファイルグループが自動的に作成されます。
**オーディオファイルとビデオファイル**
`*.mp3`、、、` *.wav`、、 `*.avi` `*.mp4`などの一般的なオーディオおよびビデオファイル形式`*.mpeg`と一致 `*.wmv`
**バックアップファイル**
、`*.bak`、 などのバックアップファイル形式`*.backup`と一致 `*.old`
**圧縮ファイル**
、`*.zip`、` *.rar`、、 `*.7z`などのアーカイブ形式`*.gz`と圧縮ファイル形式を一致 `*.tar`
**E メールファイル**
`*.eml`、、 などの E メールメッセージ` *.msg`とメールボックス形式を一致 `*.pst`
**実行可能ファイル**
、`*.exe`、` *.dll`、、、 `*.com` `*.bat`などの実行可能ファイル形式`*.cmd`とスクリプトファイル形式を一致 `*.vbs`
**イメージファイル**
`*.jpg`、、、` *.jpeg`、、 `*.png` `*.gif`などの一般的なイメージファイル形式`*.bmp`と一致 `*.tif`
**Office ファイル**
`*.doc`、、、` *.docx`、、 などの Microsoft Office `*.xls` `*.xlsx`ドキュメント形式`*.ppt`と一致 `*.pptx`
**システムファイル**
`*.sys`、、` *.dll`、 などの Windows システムファイル形式と一致 `*.ocx` `*.drv`
**一時ファイル**
`*.tmp`、、 などの一時ファイル形式`*.temp`と一致 `~*`
**テキストファイル**
`*.txt`、、`*.log`、 などのテキストベースのファイル形式`*.csv`に一致 `*.xml`
**ウェブページファイル**
`*.html`、、` *.htm`、`*.asp`、、 `*.aspx`などのウェブコンテンツファイル形式`*.php`と一致 `*.js`
これらのデフォルトのファイルグループは、ファイル画面とストレージレポートですぐに使用することも、特定の要件に合わせて変更することもできます。
## ファイルグループ管理コマンド
FSRM には、ファイルグループを作成および管理するための PowerShell コマンドが用意されています。これらのコマンドを使用して、組織のファイル管理ポリシーに一致するカスタムファイルグループを定義します。
**注記**
このページのすべての例では、ファイルシステムの Windows Remote PowerShell エンドポイントで ` $FSxWindowsRemotePowerShellEndpoint`変数が定義されていることを前提としています。このエンドポイントは、ファイルシステムの詳細ページの AWS FSx コンソール、または AWS CLI ` describe-file-systems` コマンドを使用して確認できます。
### New-FSxFSRMFileGroup
ファイル名パターンの論理コレクションを定義するファイルグループを作成します。これらのパターンは、ファイル画面、ファイル画面の例外、およびストレージレポートに使用できます。
**パラメータ :**
+ `Name (string)` - 必須。ファイルグループの名前。
+ `Description (string)` - オプション。ファイルグループの説明。
+ `IncludePattern (array)` - オプション。含めるファイルを指定するパターン文字列の配列。
+ `ExcludePattern (array)` - オプション。除外するファイルを指定するパターン文字列の配列。
**例:**
1. テキストファイルのファイルグループを作成します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMFileGroup -Name "My Text Files" -IncludePattern "*.txt"
}
```
1. 包含パターンと除外パターンを使用して、ソースコードのファイルグループを作成します。
```
$includePatterns = @("*.cpp", "*.h", "*.cs", "*.py")
$excludePatterns = @("*.tmp", "*.bak")
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList @($includePatterns, $excludePatterns) -ScriptBlock {
param($includePatterns, $excludePatterns)
New-FSxFSRMFileGroup -Name "Source Code" -Description "Programming source files" -IncludePattern $includePatterns -ExcludePattern $excludePatterns
}
```
### Get-FSxFSRMFileGroup
ファイルシステムから 1 つ以上のファイルグループを取得します。ファイルグループは、ファイルスクリーニングとレポートで使用されるファイルパターンのコレクションを定義します。
**パラメータ :**
+ `Name (array)` - オプション。取得するファイルグループの名前の配列。名前を指定しない場合、コマンドはファイルシステム上のすべてのファイルグループを返します。
**例:**
1. ファイルシステム上のすべてのファイルグループを取得します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMFileGroup
}
```
### Remove-FSxFSRMFileGroup
ファイルシステムから 1 つ以上のファイルグループを削除します。削除後、ファイルグループはファイル画面またはファイル画面の例外では使用できません。
**パラメータ :**
+ `Name (array)` - 必須。削除するファイルグループの名前の配列。
+ `PassThru (boolean)` - オプション。true に設定すると、削除されたファイルグループオブジェクトを返します。
**例:**
1. 1 つのファイルグループを削除します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Remove-FSxFSRMFileGroup -Name "My Text Files" -PassThru
}
```
### Set-FSxFSRMFileGroup
既存のファイルグループのプロパティを変更します。
**パラメータ :**
+ `Name (array)` - 必須。変更するファイルグループの名前の配列。
+ `Description (string)` - オプション。ファイルグループの新しい説明。
+ `IncludePattern (array)` - オプション。含めるファイルを指定するパターン文字列の新しい配列。
+ `ExcludePattern (array)` - オプション。除外するファイルを指定するパターン文字列の新しい配列。
+ `PassThru (boolean)` - オプション。true に設定すると、変更されたファイルグループオブジェクトが返されます。
**例:**
1. ファイルグループの説明とパターンを更新します。
```
$includePatterns = @("*.docx", "*.pdf", "*.rtf")
$excludePatterns = @("~$*", "*.tmp")
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList @($includePatterns, $excludePatterns) -ScriptBlock {
param($includePatterns, $excludePatterns)
Set-FSxFSRMFileGroup -Name "Documents" -Description "Updated document types" -IncludePattern $includePatterns -ExcludePattern $excludePatterns -PassThru
}
```
# ファイルスクリーニング
ファイルスクリーニングは、ユーザーがファイルシステムのフォルダに保存できるファイルの種類を制御します。ファイルスクリーニングは、ストレージポリシーの適用、不正なファイルタイプの防止、組織の要件への準拠の維持に役立ちます。
**注記**
ファイル画面は、ファイルグループを使用して、ブロックまたはモニタリングするファイルタイプを定義します。ファイルグループの作成と管理の詳細については、「」を参照してください[ファイルグループ](fsrm-file-groups.md)。
FSRM は 2 種類のファイル画面をサポートしています。
1. **アクティブなファイル画面** - ユーザーが指定されたファイルグループに一致するファイルを保存できないようにブロックし、ユーザーがブロックされたファイルを保存しようとしたときに通知を生成します。特定のフォルダで許可されるファイルタイプに関する厳格なポリシーを適用する必要がある場合は、アクティブなファイル画面を使用します。
1. **パッシブファイル画面** - ユーザーが指定されたファイルグループに一致するファイルを保存したときにモニタリングおよびログ記録しますが、保存オペレーションは妨げません。ユーザーワークフローを中断することなくファイルの使用パターンを追跡する場合は、パッシブファイル画面を使用します。
## ファイル画面テンプレート
ファイル画面テンプレートは、ブロックまたはモニタリングするファイルグループや生成する通知など、ファイルスクリーニング設定を定義する再利用可能な設定を提供します。ファイル画面テンプレートを作成したら、毎回同じ設定を再設定することなく、複数のフォルダに適用できます。ファイル画面テンプレートを更新する場合、オプションで、そのテンプレートから作成されたすべてのファイル画面に変更を適用できます。
ファイル画面テンプレートを使用すると、いくつかの利点があります。
+ **整合性** - 類似フォルダのファイルスクリーニング設定が同じであることを確認します
+ **効率** - ファイルスクリーニング設定を複数のフォルダにすばやく適用する
+ **保守性** - テンプレートを変更して複数のフォルダのファイルスクリーニング設定を更新する
## ファイル画面の例外
ファイル画面の例外は、フォルダとそのすべてのサブフォルダに適用されるファイルスクリーニングルールを上書きします。ファイル画面の例外を作成するときは、親フォルダでファイル画面がブロックされているにもかかわらず、許可するファイルグループを指定します。ファイル画面の例外は、フォルダ階層のより高いレベルでより広範な制限を維持しながら、特定のサブフォルダで特定のファイルタイプを許可する必要がある場合に便利です。
たとえば、共有全体で実行可能ファイルをブロックし、管理者がインストールファイルを保存する必要がある特定のサブフォルダの例外を作成できます。
## ファイルスクリーニング通知
ユーザーがアクティブなファイル画面によってブロックされているファイルを保存しようとすると、FSRM は管理者に警告する通知を生成したり、ユーザーに情報を提供したりできます。次のタイプの通知を設定できます。
+ **イベントログ**記録 - モニタリングと分析のために Amazon CloudWatch または Amazon Kinesis Data Firehose にイベントを記録します。イベントの重要度レベル (情報、警告、またはエラー) を指定し、カスタムメッセージ本文を指定できます。イベントログ記録は、ファイル画面違反を追跡し、既存のモニタリングシステムと統合するのに役立ちます。
+ **ストレージレポート** - ファイルスクリーニングアクティビティに関する詳細情報を提供するストレージ使用状況レポートを生成します。ストレージレポートは、ファイル保存試行のパターンを特定し、ファイルスクリーニングポリシーについて情報に基づいた意思決定を行うのに役立ちます。詳細については、「[ストレージレポート](fsrm-storage-reports.md)」を参照してください。
## ファイルスクリーニング管理コマンド
ファイル画面を管理するために、FSx リモート PowerShell コマンドの 3 つのファミリーにアクセスできます。
1. **ファイル画面コマンド** - 特定のフォルダで個々のファイル画面を作成、取得、変更、削除、リセットします。ファイル画面をfolder-by-folder管理する必要がある場合は、これらのコマンドを使用します。
1. **ファイル画面テンプレートコマンド** - 再利用可能なファイルスクリーニング設定を定義するファイル画面テンプレートを作成、取得、変更、削除します。これらのコマンドを使用して、複数のフォルダに適用できる標準のファイルスクリーニングポリシーを確立します。
1. **ファイル画面の例外コマンド** - 親フォルダ内のファイルスクリーニングルールを上書きするファイル画面の例外を作成、取得、変更、削除します。より広範な制限を維持しながら、特定のサブフォルダで特定のファイルタイプを許可する必要がある場合は、これらのコマンドを使用します。
### ファイルスクリーニング FSx リモート PowerShell コマンドのリスト
**注記**
このページのすべての例では、ファイルシステムの Windows Remote PowerShell エンドポイントで ` $FSxWindowsRemotePowerShellEndpoint`変数を定義していることを前提としています。このエンドポイントは、Amazon FSx コンソールのファイルシステムの詳細ページ、または コマンドを使用して AWS CLI `describe-file-systems`確認できます。
### ファイル画面のコマンド
#### New-FSxFSRMFileScreen
ユーザーが指定されたタイプのファイルをフォルダに保存できないようにするファイル画面を作成します。
**パラメータ :**
+ `Folder (string)` - 必須。ファイル画面が適用されるフォルダパス。
+ `Description (string)` - オプション。ファイル画面の説明。
+ `IncludeGroup (array)` - オプション。ブロックまたはモニタリングするファイルを指定するファイルグループ名の配列。
+ `Active (boolean)` - オプション。true に設定すると、 はファイルをブロックするアクティブなファイル画面を作成します。false に設定すると、 はファイルのみをモニタリングするパッシブファイル画面を作成します。デフォルトは true です。
+ `Template (string)` - オプション。使用する既存のファイル画面テンプレートの名前。
+ `NotificationConfigurations (array)` - オプション。ユーザーがブロックされたファイルを保存しようとしたときの通知の設定の配列。各設定には次のプロパティがあります。
+ `ActionType (string)`: 実行するアクションのタイプ。次の値を指定できます。
1. `Event`: ファイルシステムのイベントログにイベントを記録します。イベントを指定するときは、次のプロパティも指定する必要があります。
+ `EventType (string)`: 情報、警告、またはエラー
+ `MessageBody (string)`: イベントでログに記録するメッセージテキスト。
1. `Report`: ストレージ使用状況レポートを生成します。レポートを指定するときは、以下も指定する必要があります。
+ `ReportType (string)`: レポートのタイプ。、`DuplicateFiles`、、`FilesByFileGroup`、、`FilesByOwner``FilesByProperty`、`LargeFiles``LeastRecentlyAccessed``MostRecentlyAccessed`、または の値を指定できます`QuotaUsage`。
**例:**
1. オーディオファイルをブロックする基本的なアクティブなファイル画面を作成します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMFileScreen -Folder "share\department" -IncludeGroup "Audio and Video Files"
}
```
1. ユーザーがビデオファイルを保存しようとしたときに、ビデオファイルをブロックし、イベントログエントリを生成するファイル画面を作成します。
```
$notifications = [System.Collections.ArrayList]@()
$eventNotification = @{
ActionType = "Event"
EventType = "Warning"
MessageBody = "File screen violation detected"
}
$null = $notifications.Add($eventNotification)
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList $notifications -ScriptBlock {
param($notifications)
New-FSxFSRMFileScreen -Folder "share\projects" -IncludeGroup "Audio and Video Files" -NotificationConfigurations $Using:notifications
}
```
#### Get-FSxFSRMFileScreen
ファイルシステムから 1 つ以上のファイル画面を取得します。
**パラメータ :**
+ `Folder (string)` - オプション。ファイル画面を取得するフォルダパス。フォルダパスを指定しない場合、コマンドはファイルシステム上のすべてのファイル画面を返します。
**例:**
1. ファイルシステムのすべてのファイル画面を取得します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMFileScreen
}
```
#### Set-FSxFSRMFileScreen
既存のファイル画面のプロパティを変更します。
**パラメータ :**
+ `Folder (string)` - 必須。変更するファイル画面を含むフォルダパス。
+ `Description (string)` - オプション。ファイル画面の新しい説明。
+ `IncludeGroup (array)` - オプション。ブロックまたはモニタリングするファイルを定義するファイルグループ名の新しい配列。
+ `Active (boolean)` - オプション。true に設定すると、ファイル画面がアクティブモード (ブロック) に設定されます。false に設定すると、ファイル画面はパッシブモード (モニタリングのみ) に設定されます。デフォルトは true です。
+ `NotificationConfigurations (array)` - オプション。通知設定の新しい配列。
+ `PassThru (boolean)` - オプション。true に設定すると、変更されたファイル画面オブジェクトが返されます。
**例:**
1. ファイル画面の説明とファイルグループを変更します。
```
$includeGroups = @("Audio and Video Files")
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList $includeGroups -ScriptBlock {
param($includeGroups)
Set-FSxFSRMFileScreen -Folder "share\projects" -Description "Updated screen" -IncludeGroup $includeGroups
}
```
1. ファイル画面をアクティブモードに設定し、通知を追加します。
```
$notifications = [System.Collections.ArrayList]@()
$eventNotification = @{
ActionType = "Event"
EventType = "Warning"
MessageBody = "File screen violation detected"
}
$null = $notifications.Add($eventNotification)
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList $notifications -ScriptBlock {
param($notifications)
Set-FSxFSRMFileScreen -Folder "share\projects" -Active: $true -NotificationConfigurations $Using:notifications -PassThru
}
```
#### Remove-FSxFSRMFileScreen
指定されたフォルダからファイル画面を削除します。
**パラメータ :**
+ `Folder (string)` - 必須。ファイル画面を削除するフォルダパス。
+ `PassThru (boolean)` - オプション。true に設定すると、削除されたファイル画面オブジェクトが返されます。
**例:**
1. 特定のフォルダからファイル画面を削除します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Remove-FSxFSRMFileScreen -Folder "share\projects" -PassThru
}
```
#### Reset-FSxFSRMFileScreen
指定したテンプレートの設定と一致するようにファイル画面をリセットします。
**パラメータ :**
+ `Folder (string)` - 必須。リセットするファイル画面を含むフォルダパス。
+ `Template (string)` - 必須。適用する既存のファイル画面テンプレートの名前。
**例:**
1. ファイル画面テンプレートで定義されている設定と一致するようにファイル画面をリセットします。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Reset-FSxFSRMFileScreen -Folder "share\department" -Template "Block Audio Files"
}
```
### ファイル画面のテンプレートコマンド
#### Get-FSxFSRMFileScreenTemplate
`Get-FSxFSRMFileScreenTemplate` コマンドは、ファイルシステムから 1 つ以上のファイル画面テンプレートを取得します。
##### パラメータ
+ `Name (array)` - オプション。取得するファイル画面テンプレートの名前の配列。名前を指定しない場合、コマンドはファイルシステム上のすべてのファイル画面テンプレートを返します。
##### 例
1. すべてのファイル画面テンプレートを取得します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMFileScreenTemplate
}
```
#### New-FSxFSRMFileScreenTemplate
`New-FSxFSRMFileScreenTemplate` コマンドは、ファイル画面の再利用可能な設定を定義するファイル画面テンプレートを作成します。テンプレートは、ブロックするファイルグループと、ユーザーがブロックされたファイルを保存しようとしたときに生成する通知を指定します。
##### パラメータ
+ `Name (string)` - 必須。ファイル画面テンプレートの名前。
+ `Description (string)` - オプション。ファイル画面テンプレートの説明。
+ `IncludeGroup (array)` - オプション。ブロックまたはモニタリングするファイルを指定するファイルグループ名の配列。
+ `Active (boolean)` - オプション。true に設定すると、 はファイルをブロックするアクティブなファイル画面テンプレートを作成します。false に設定すると、 ファイルのみをモニタリングするパッシブテンプレートが作成されます。デフォルトは true です。
+ `NotificationConfigurations (array)` - オプション。ユーザーがブロックされたファイルを保存しようとしたときの通知の設定の配列。各設定には次のプロパティがあります。
+ `ActionType (string)`: 実行するアクションのタイプ。次の値を指定できます。
1. `Event`: ファイルシステムのイベントログにイベントを記録します。イベントを指定するときは、次のプロパティも指定する必要があります。
+ `EventType (string)`: 情報、警告、またはエラー
+ `MessageBody (string)`: イベントでログに記録するメッセージテキスト。
1. `Report`: ストレージ使用状況レポートを生成します。レポートを指定するときは、以下も指定する必要があります。
+ `ReportType (string)`: レポートのタイプ。次の値を指定できます: `DuplicateFiles`、`FilesByFileGroup`、、`FilesByOwner`、`FilesByProperty`、`LargeFiles``LeastRecentlyAccessed``MostRecentlyAccessed`、、または `QuotaUsage`
##### 例
1. 通知を含むファイル画面テンプレートを作成します。
```
$notifications = [System.Collections.ArrayList]@()
$eventNotif = @{
ActionType = "Event"
EventType = "Warning"
MessageBody = "Blocked file detected"
}
$null = $notifications.Add($eventNotif)
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList $notifications -ScriptBlock {
param($notifications)
New-FSxFSRMFileScreenTemplate -Name "Block Executables" -Description "Blocks executable files" -IncludeGroup "Executable Files" -Active: $true -NotificationConfigurations $Using:notifications
}
```
#### Remove-FSxFSRMFileScreenTemplate
`Remove-FSxFSRMFileScreenTemplate` コマンドは、ファイルシステムから 1 つ以上のファイル画面テンプレートを削除します。テンプレートを削除すると、そのテンプレートから作成されたファイル画面は変更されません。
##### パラメータ
+ `Name (array)` - 必須。削除するファイル画面テンプレートの名前の配列。
+ `PassThru (boolean)` - オプション。true に設定すると、削除されたファイル画面テンプレートオブジェクトが返されます。
##### 例
1. 1 つのファイル画面テンプレートを削除します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Remove-FSxFSRMFileScreenTemplate -Name "Block Executables" -PassThru
}
```
#### Set-FSxFSRMFileScreenTemplate
`Set-FSxFSRMFileScreenTemplate` コマンドは、既存のファイル画面テンプレートのプロパティを変更します。必要に応じて、変更されたテンプレートを使用して作成されたファイル画面を更新します。
##### パラメータ
+ `Name (array)` - 必須。変更するファイル画面テンプレートの名前の配列。
+ `Description (string)` - オプション。テンプレートの新しい説明。
+ `IncludeGroup (array)` - オプション。ブロックまたはモニタリングするファイルを定義するファイルグループ名の新しい配列。
+ `Active (boolean)` - オプション。true に設定すると、テンプレートをアクティブモード (ブロッキング) に設定します。false に設定すると、 テンプレートをパッシブモード (モニタリング) に設定します。デフォルトは true です。
+ `NotificationConfigurations (array)` - オプション。通知設定の新しい配列。
+ `UpdateDerived (boolean)` - オプション。true に設定すると、 は、これらのファイル画面に加えられた変更に関係なく、このテンプレートから作成された既存のすべてのファイル画面を更新します。
+ `UpdateDerivedMatching (boolean)` - オプション。true に設定すると、このテンプレートから作成されてから変更されていないファイル画面のみが更新されます。
+ `PassThru (boolean)` - オプション。true に設定すると、変更されたファイル画面テンプレートオブジェクトが返されます。
##### 例
1. 新しいファイルグループでファイル画面テンプレートを更新します。
```
$includeGroups = @("Audio and Video Files")
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList $includeGroups -ScriptBlock {
param($includeGroups)
Set-FSxFSRMFileScreenTemplate -Name "Block Executables" -IncludeGroup $includeGroups
}
```
2. ファイル画面テンプレートをアクティブモードに更新し、派生したすべてのファイル画面を更新します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Set-FSxFSRMFileScreenTemplate -Name "Block Executables" -Active: $true -UpdateDerived
}
```
### ファイル画面の例外コマンド
#### New-FSxFSRMFileScreenException
`New-FSxFSRMFileScreenException` コマンドは、フォルダとそのすべてのサブフォルダに適用されるファイルスクリーニングルールを上書きするファイル画面の例外を作成します。これにより、親フォルダのファイル画面によってブロックされていても、特定のファイルタイプを例外フォルダに作成できます。
##### パラメータ
+ `Folder (string)` - 必須。ファイル画面の例外が適用されるフォルダパス。この例外は、このフォルダとそのすべてのサブフォルダに適用されます。
+ `Description (string)` - オプション。ファイル画面の例外の説明。
+ `IncludeGroup (array)` - オプション。親フォルダから適用されるブロッキングファイル画面にもかかわらず、許可するファイルを指定するファイルグループ名の配列。
##### 例
1. 特定のフォルダとファイルグループのファイル画面の例外を作成します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMFileScreenException -Folder "share\department" -IncludeGroup "Text Files"
}
```
2. 複数のファイルグループでファイル画面の例外を作成します。
```
$includeGroups = @("Audio and Video Files", "Documents")
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList $includeGroups -ScriptBlock {
param($includeGroups)
New-FSxFSRMFileScreenException -Folder "share\projects" -Description "Allow media files in project folder" -IncludeGroup $includeGroups
}
```
#### Get-FSxFSRMFileScreenException
`Get-FSxFSRMFileScreenException` コマンドは、ファイルシステムから 1 つ以上のファイル画面の例外を取得します。
##### パラメータ
+ `Folder (string)` - オプション。ファイル画面の例外を取得するフォルダパス。フォルダパスを指定しない場合、コマンドはファイルシステム上のすべてのファイル画面の例外を返します。
##### 例
1. ファイルシステムのすべてのファイル画面の例外を取得します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMFileScreenException
}
```
2. 特定のフォルダのファイル画面の例外を取得します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMFileScreenException -Folder "share\department"
}
```
#### Remove-FSxFSRMFileScreenException
`Remove-FSxFSRMFileScreenException` コマンドは、指定されたフォルダからファイル画面の例外を削除します。削除後、フォルダとそのサブフォルダには、例外によって以前に上書きされた親フォルダからのファイルスクリーニングルールが適用されます。
##### パラメータ
+ `Folder (string)` - 必須。ファイル画面の例外を削除するフォルダパス。
+ `PassThru (boolean)` - オプション。true に設定すると、削除されたファイル画面の例外オブジェクトが返されます。
##### 例
1. 特定のフォルダからファイル画面の例外を削除します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Remove-FSxFSRMFileScreenException -Folder "share\projects" -PassThru
}
```
#### Set-FSxFSRMFileScreenException
`Set-FSxFSRMFileScreenException` コマンドは、ファイル画面の例外のプロパティを変更します。
##### パラメータ
+ `Folder (string)` - 必須。変更するファイル画面の例外を含むフォルダパス。
+ `Description (string)` - オプション。ファイル画面の例外に関する新しい説明。
+ `IncludeGroup (array)` - オプション。親フォルダから適用されるブロッキングファイル画面にもかかわらず、許可するファイルを定義するファイルグループ名の新しい配列。
+ `PassThru (boolean)` - オプション。true に設定すると、変更されたファイル画面の例外オブジェクトが返されます。
##### 例
1. ファイル画面例外の許可されたファイルグループを更新します。
```
$includeGroups = @("Audio and Video Files")
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList $includeGroups -ScriptBlock {
param($includeGroups)
Set-FSxFSRMFileScreenException -Folder "share\projects" -IncludeGroup $includeGroups -PassThru
}
```
# ファイル分類
ファイル分類は、コンテンツ、場所、またはその他の属性に基づいて、メタデータプロパティをファイルに自動的に割り当てます。分類は、機密情報を含むファイル、特定のビジネスカテゴリに属するファイル、または保持期間を必要とするファイルを識別することで、ファイルの整理、データ管理ポリシーの適用、コンプライアンス要件を満たすのに役立ちます。
## ファイル分類の仕組み
ファイル分類では、3 ステップのプロセスを使用します。
1. **プロパティの定義** - `"Data Sensitivity"`や などのファイルに割り当てるメタデータのタイプを指定する分類プロパティ定義を作成します`"ContainsPII"`。
1. **ルールの作成** - ファイルコンテンツパターンやフォルダの場所など、指定した基準に基づいてファイルに自動的にプロパティ値を割り当てる分類ルールを設定します。たとえば、社会保障番号などのパターンを含むファイルは、自動的に として分類`(XXX-XX-XXXX)`できます`ContainsPII=Yes`。
1. **分類の実行** - 分類プロセスを実行してファイルをスキャンし、ルールを適用します。分類は、オンデマンドで、スケジュールに従って、またはバックグラウンドで継続的に実行できます。
分類が完了したら、割り当てられたプロパティを使用して、ストレージレポートの生成、 の適用[ファイル管理タスク](fsrm-file-management.md)、または特定の特性を持つファイルの検索を行うことができます。
## 分類プロパティの定義
分類プロパティ定義は、ファイルに割り当てることができるメタデータのタイプを指定します。各プロパティ定義には、名前、プロパティタイプ、およびオプションで許可される値のリストがあります。たとえば、 `OrderedList` というプロパティを Type と指定できる値 `Public`、`Internal`、`Confidential`、 `"Data Sensitivity"`で作成できます`Restricted`。
次のプロパティタイプがサポートされています。
+ `OrderedList` - 値が特定のシーケンス (低、中、高など) を持つ順序付きリスト。値の順序がレポートまたはポリシーの決定に重要な場合は、このタイプを使用します。
+ `MultiChoice` - リストから複数の値を選択できるようにします (たとえば、ファイルは「財務」カテゴリと「法的」カテゴリの両方でタグ付けされる場合があります）。
+ `SingleChoice` - リストから選択できる値は 1 つだけです。
+ `String` - 事前定義されたオプションのない単一のテキスト値。
+ `MultiString` - 事前定義されたオプションのない複数のテキスト値。
+ `Integer` - 数値。
+ `YesNo` - ブール値 (true または false)。
+ `DateTime` - 日付と時刻の値。
プロパティ定義は、複数の分類ルールで再利用できます。プロパティ定義を作成したら、そのプロパティの値を割り当てる必要がある任意の分類ルールでそれを参照できます。
## 分類ルール
分類ルールは、ファイルに自動的にプロパティ値を割り当てるロジックを定義します。各ルールは以下を指定します。
+ 設定するプロパティ
+ そのプロパティに割り当てる値
+ ルールを適用する場所 (どのフォルダ)
+ プロパティ値を受け取るファイルを識別する方法。次の 2 つの分類メカニズムを使用できます。
### コンテンツ分類子
コンテンツ分類子は、特定のテキストパターンまたは正規表現のファイルコンテンツをスキャンします。このメカニズムを使用して、ファイルの内容に基づいてファイルを識別します。コンテンツ分類子には、ファイルコンテンツを照合する 3 つの方法があります。
+ `ContentString` - 大文字と小文字を区別しないテキスト文字列を検索します。このオプションは、大文字と小文字に関係なく特定の単語やフレーズを検索する場合に使用します。たとえば、「機密」を検索すると、「機密」、「機密」、および「機密」と一致します。
+ `ContentStringCaseSensitive` - 大文字と小文字を区別するテキスト文字列を検索します。このオプションは、大文字と小文字を区別して検索する場合に使用します。たとえば、「SSN」を検索すると「SSN」は一致しますが、「ssn」や「Ssn」は一致しません。これは、頭字語、製品コード、または大文字と小文字が重要なその他の識別子に役立ちます。
+ `ContentRegularExpression` - 正規表現を使用してパターンを検索します。このオプションは、複雑なパターンまたは変数形式を一致させる必要がある場合に使用します。たとえば、正規表現を使用して以下を検出できます。
+ 123-45-6789 形式の社会保障番号: ` \b\d{3}-\d{2}-\d{4}\b`
+ オプションのスペースまたはダッシュを含むクレジットカード番号: ` \b\d{4}[\s-]?\d{4}[\s-]?\d{4}[\s-]?\d{4}\b`
+ E メールアドレス、電話番号、またはその他の構造化データ
1 つのルールで複数の文字列またはパターンを指定でき、そのコンテンツが指定された値のいずれかと一致するとファイルが分類されます。
### フォルダ分類子
フォルダ分類子は、ファイルが保存されている場所に基づいてプロパティ値を割り当てます。このメカニズムを使用して、フォルダ階層内の場所別にファイルを分類します。例えば、次のようになります。
+ リーガルドキュメントフォルダ内のすべてのファイルの保持期間プロパティを設定する
+ 特定のプロジェクトフォルダ内のすべてのファイルをプロジェクト識別子でマークする
さらに、 `ReevaluateProperty`パラメータを使用して、 プロパティの値がすでにあるファイルで分類が実行されたときの動作を制御できます。次の設定を選択できます。
+ `Never` - このプロパティの値を持たないファイルのみを分類する
+ `Overwrite` - ファイルが変更されたときに既存の値を置き換える
+ `Aggregate` - 新しい値と既存の値を組み合わせる (複数値プロパティの場合)
## 管理プロパティ
管理プロパティは、ファイルではなくフォルダに適用される分類プロパティです。管理プロパティを使用して、ファイルシステム階層内のフォルダを整理および分類します。分類ルールによって自動的に割り当てられたファイルプロパティとは異なり、 ` Set-FSxFSRMMgmtProperty` コマンドを使用して管理プロパティを手動で設定します。
フォルダを分類するには、 `FolderUsage_MS`プロパティを使用します。次の値を指定できます。
+ `User Files`
+ `Group Share`
+ `Application Files`
+ `Backup and Archival`
## 分類の実行
ファイル分類は、次の 3 つの方法で実行できます。
1. **手動分類** - 分類をすぐに実行[Start-FSxFSRMClassification](#start-fsxfsrmclassification)するために使用します。このアプローチは、新しいルールのテストや 1 回限りの分類タスクの実行に役立ちます。
1. **スケジュールされた分類** - 自動分類のスケジュールを設定[Set-FSxFSRMClassification](#set-fsxfsrmclassification)するために使用します。分類は、毎週または毎月の特定の時間に実行するようにスケジュールできます。スケジュールされた分類は、予測可能な分類を定期的に実行するほとんどの本番環境に適しています。
1. **連続分類** - `Continuous`パラメータ[Set-FSxFSRMClassification](#set-fsxfsrmclassification)で を使用して、継続的に実行されるバックグラウンド分類を有効にします。連続分類は、新規および変更されたファイルが作成または変更された直後に自動的に分類します。このアプローチはup-to-date最新の分類を提供しますが、より多くのシステムリソースを消費します。
分類を開始するときは、 を指定`RunDuration`して、プロセスの実行期間を制限できます。分類が指定された時間内に完了しない場合、次回のスケジュールされた実行時、または手動で再開したときに、分類が停止して再開されます。
分類が完了したら、Windows File Explorer でファイルを右クリックし、プロパティを選択し、分類タブを選択することで、ファイルに割り当てられた**分類****プロパティ**を表示できます。このタブには、ファイルのすべての分類プロパティとその値が表示されます。
## 分類プロセス管理
分類プロセスは、次のコマンドを使用してモニタリングおよび制御できます。
+ [Get-FSxFSRMClassification](#get-fsxfsrmclassification) - 分類の現在のステータスを確認する (`Running`、`Queued`、`NotRunning`、または `Unknown`)
+ [Stop-FSxFSRMClassification](#stop-fsxfsrmclassification) - 実行中またはキューに入れられた分類ジョブを停止する
+ [Wait-FSxFSRMClassification](#wait-fsxfsrmclassification) - 分類が完了するかタイムアウトの有効期限が切れるまでスクリプトの実行を一時停止する
これらのコマンドを使用して、分類を他のタスクと調整します。たとえば、分類が完了するまで待ってから、分類されたファイルプロパティに依存するストレージレポートを生成できます。
## 分類のベストプラクティス
効率的で効果的なファイル分類を行うには、以下のベストプラクティスに従ってください。
### 1. パフォーマンスに関する考慮事項
FSRM はファイルコンテンツを読み取ってスキャンする必要があるため、コンテンツベースの分類はリソースを大量に消費します。
+ **小さなデータセットで最初にルールをテスト**する - 分類ルールをファイルシステム全体に適用する前に、ファイルの代表的なサンプルでテストして、それらが期待どおりに動作することを検証し、分類にかかる時間を推定します。
+ **コンテンツスキャン範囲の制限** - コンテンツベースの分類は、ファイルコンテンツの読み取りを必要とするため、リソースを大量に消費します。`Namespace` パラメータを使用して、ファイルシステム全体をスキャンするのではなく、ルールを特定のフォルダに制限します。
+ **可能な場合はフォルダ分類を使用する** - ファイルの内容を読み取る必要がないため、フォルダ分類子はコンテンツ分類子よりもはるかに高速です。ファイルが場所に基づいて分類できる場合は、コンテンツ分類子の代わりにフォルダ分類子を使用します。
+ **オフピーク時間帯のスケジュール分類** - システムアクティビティが少ない時間帯にスケジュール分類を実行して、ユーザーパフォーマンスへの影響を最小限に抑えます。バックアップウィンドウやその他のメンテナンスタスク中に分類を実行しないでください。
+ **適切な RunDuration 制限を設定する** - `RunDuration`パラメータを使用して、分類の実行時間が長すぎてシステムパフォーマンスに影響を与えないようにします。分類が時間制限内に完了しない場合、次回のスケジュールされた実行中に再開されます。
+ **分類パフォーマンスのモニタリング** - ` Get-FSxFSRMClassification`分類ステータスをチェックし、分類に予想以上に時間がかかるかどうかを特定します。長時間実行される分類は、ルールを最適化する必要があるか、システムがより多くのリソースを必要とすることを示している可能性があります。
### 2. ルール設計
+ **特定の正規表現を使用する **- を使用する場合は`ContentRegularExpression`、誤一致を避けるために、できるだけ具体的なパターンを記述します。正規表現を本番環境にデプロイする前に、完全にテストします。
+ **複数のパターンを効率的に組み合わせ**る - 同様のパターンに対して個別のルールを作成する代わりに、複数の `ContentString`または `ContentRegularExpression`値を持つ単一のルールに結合します。これにより、FSRM が各ファイルをスキャンするために必要な回数が減ります。
+ **不要なフォルダを除外する** - の `ExcludeNamespace`パラメータ`Set-FSxFSRMClassification`を使用して、分類を必要としない一時ディレクトリやその他の場所を除外します。
### 3. プロパティ管理
+ **プロパティスキーマを計画する** - ルールを作成する前に分類プロパティを設計します。レポート、コンプライアンス、ファイル管理ポリシーに必要なプロパティを検討してください。
+ **ドキュメントプロパティ定義** - 説明フィールドを使用して、各プロパティの意味と使用方法を説明します。これにより、他の管理者が分類スキーマを理解するのに役立ちます。
### 4. 継続的なメンテナンス
+ **分類結果を定期的に確認する** - ストレージレポートを生成して、分類が期待どおりに機能し、ファイルが正しいプロパティ値を受信していることを確認します。
+ **必要に応じてルールを更新する** - 組織のデータ管理要件が変更されたら、新しいポリシーまたはコンプライアンス要件を反映するように分類ルールを更新します。
+ **未使用のプロパティをクリーンアップ**する - 分類設定を管理可能にするために不要になったプロパティ定義とルールを削除します。
## 分類管理コマンド
ファイル分類を管理するために、FSx リモート PowerShell コマンドの 4 つのファミリーにアクセスできます。
1. **プロパティ定義コマンド** - ファイルに割り当てることができるメタデータのタイプを指定する分類プロパティ定義を作成および管理します。
1. **分類ルールコマンド** - ファイルの内容または場所に基づいてプロパティ値を割り当てる自動分類ルールを作成および管理します。
1. **管理プロパティコマンド** - ファイルではなくフォルダの分類プロパティを設定および取得します。
1. **分類プロセスコマンド** - 分類プロセスを開始、停止、モニタリング、設定します。
### ファイル分類 FSx リモート PowerShell コマンドのリスト
**注記**
このページのすべての例では、ファイルシステムの Windows Remote PowerShell エンドポイントで ` $FSxWindowsRemotePowerShellEndpoint`変数が定義されていることを前提としています。このエンドポイントは、ファイルシステムの詳細ページの Amazon FSx コンソール、または コマンドを使用して AWS CLI `describe-file-systems`確認できます。
### プロパティ定義コマンド
#### New-FSxFSRMClassificationPropertyDefinition
`New-FSxFSRMClassificationPropertyDefinition`: ファイルの分類に使用できる分類プロパティ定義を作成します。プロパティ定義は、分類ルールを通じてファイルに割り当てることができる属性を定義します。
**パラメータ :**
+ `Name (string)` - 必須。プロパティ定義の名前。
+ `DisplayName (string)` - オプション。プロパティ定義の表示名。
+ `Description (string)` - オプション。プロパティ定義の説明。
+ `Type (string)` - 必須。分類プロパティのタイプ。次の値を指定できます。
+ `OrderedList`: 可能な値の順序付きリスト
+ `MultiChoice`: 可能な値からの複数選択肢の選択
+ `SingleChoice`: 可能な値から 1 つの選択肢
+ `String`: 単一テキスト文字列
+ `MultiString`: 複数のテキスト文字列
+ `Integer`: 数値
+ `YesNo`: ブール値
+ `DateTime`: 日付と時刻の値
+ `PossibleValueConfigurations (array)` - オプション。OrderedList、MultiChoice、または SingleChoice プロパティタイプの設定の配列。各設定には次のプロパティがあります。
+ `Name (string)`: 値の名前 (必須)
+ `Description (string)`: 値の説明 (オプション)
+ `Parameters (array)` - オプション。追加設定用の `"name=value"` 形式の文字列の配列。
**例:**
**1. PII データのプロパティリストを作成します。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMClassificationPropertyDefinition -Name "ContainsPII" -Type OrderedList -PossibleValueConfigurations @(
@{ Name = "Yes" },
@{ Name = "No" })
}
```
**2。データ感度の順序付きリストプロパティを作成します。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMClassificationPropertyDefinition -Name "DataSensitivity" -Type OrderedList -PossibleValueConfigurations @(
@{ Name = "Public" },
@{ Name = "Internal" },
@{ Name = "Confidential" },
@{ Name = "Restricted" }
)
}
```
#### Get-FSxFSRMClassificationPropertyDefinition
`Get-FSxFSRMClassificationPropertyDefinition`: ファイルシステムから 1 つ以上の分類プロパティ定義を取得します。
**パラメータ :**
+ `Name (array)` - オプション。取得するプロパティ定義の名前の配列。名前を指定しない場合、コマンドはファイルシステム上のすべてのプロパティ定義を返します。
**例:**
**1. ファイルシステム上のすべての分類プロパティ定義を取得します。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMClassificationPropertyDefinition
}
```
#### Set-FSxFSRMClassificationPropertyDefinition
既存の分類プロパティ定義のプロパティを変更します。
##### パラメータ
+ `Name (array)` - 必須。変更するプロパティ名の配列。
+ `DisplayName (string)` - オプション。プロパティ定義の新しい表示名。
+ `Description (string)` - オプション。プロパティ定義の新しい説明。
+ `PossibleValueConfigurations (array)` - オプション。OrderedList、MultiChoice、または SingleChoice プロパティの設定の新しい配列。各設定には次のプロパティがあります。
+ `Name (string)`: 値の名前 (必須)
+ `Description (string)`: 値の説明 (オプション)
+ `Parameters (array)` - オプション。「name=value」形式の文字列の新しい配列。
+ `PassThru (boolean)` - オプション。true に設定すると、変更されたプロパティ定義オブジェクトを返します。
**例:**
1. 既存のプロパティ定義の説明を使用して、可能な値を更新します。
```
$values = [System.Collections.ArrayList]@()
$null = $values.Add(@{
Name = "High"
Description = "High Risk Content"
})
$null = $values.Add(@{
Name = "Medium"
Description = "Medium Risk Content"
})
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList $values -ScriptBlock {
param($values)
Set-FSxFSRMClassificationPropertyDefinition -Name "RiskLevel" -PossibleValueConfigurations $Using:values -PassThru
}
```
#### Remove-FSxFSRMClassificationPropertyDefinition
ファイルシステムから 1 つ以上の分類プロパティ定義を削除します。削除できるのは、ローカルに定義されたプロパティ定義のみです。
##### パラメータ
+ `Name (array)` - 必須。削除するプロパティ名の配列。
+ `PassThru (boolean)` - オプション。true に設定すると、削除されたプロパティ定義オブジェクトを返します。
**例:**
1. 単一のプロパティ定義を削除します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Remove-FSxFSRMClassificationPropertyDefinition -Name "RiskLevel" -PassThru
}
```
### 分類ルールのコマンド
#### New-FSxFSRMClassificationRule
指定された基準に基づいてファイルにプロパティ値を割り当てる自動分類ルールを作成します。各ルールは、単一のプロパティの値を設定します。
##### パラメータ
+ `Name (string)` - 必須。分類ルールの名前。
+ `Description (string)` - オプション。分類ルールの説明。
+ `Property (string)` - 必須。設定する分類プロパティの名前。既存のプロパティ定義名である必要があります。
+ `PropertyValue (string)` - オプション。プロパティに割り当てる値。指定された分類メカニズムに対して有効である必要があります。
+ `Namespace (array)` - 必須。ルールが適用されるパスまたはフォルダタイプの配列。
+ `Disabled (boolean)` - オプション。true に設定すると、 は無効状態のルールを作成します。
+ `ReevaluateProperty (string)` - オプション。ファイルを再評価するタイミングを指定します。次の値を指定できます。
+ `Never`: 既存のプロパティ値がないファイルのみを評価する
+ `Overwrite`: ファイルが変更されたときに再評価し、既存の値を上書きする
+ `Aggregate`: ファイルが変更されたときに再評価し、既存の値と組み合わせる
+ `Flags (array)` - オプション。ルールの特別な動作を指定します。次の値を指定できます。
+ `ClearAutomaticallyClassifiedProperty`
+ `ClearManuallyClassifiedProperty`
+ `Deprecated`
+ `ContentRegularExpression (array)` - オプション。ファイルの内容に一致する正規表現の配列。
+ `ContentString (array)` - オプション。ファイルコンテンツ内で検索する大文字と小文字を区別しない文字列の配列。
+ `ClassificationMechanism (string)` - 必須。ファイルの分類に使用するメカニズム。次の値を指定できます。
+ `Content Classifier`: 特定の文字列または正規表現パターンのファイルコンテンツをスキャンします。Content Classifier を指定すると、ContentString、ContentStringCaseSensitive、または ContentRegularExpression パラメータを使用して、検索するコンテンツを定義できます。
+ `Folder Classifier`: フォルダの場所に基づいてファイルを分類します
+ `Parameters (array)` - オプション。追加設定用の`"name=value"`文字列の配列。
**例:**
1. 正規表現を使用して社会保障番号を検出します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMClassificationRule -Name "Detect_SSN" -Property "ContainsPII" -PropertyValue "Yes" -Namespace "share" -ClassificationMechanism "Content Classifier" -ContentRegularExpression "\b\d{3}-\d{2}-\d{4}\b"
}
```
2. 通常の式を使用してクレジットカード番号を検出します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMClassificationRule -Name "Detect_CreditCard" -Property "ContainsPII" -PropertyValue "Yes" -Namespace "share" -ClassificationMechanism "Content Classifier" -ContentRegularExpression "\b\d{4}[\s-]?\d{4}[\s-]?\d{4}[\s-]?\d{4}\b"
}
```
3. フォルダ内のすべてのファイルを 7 年間の保持期間プロパティで分類します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMClassificationRule -Name "Contracts_Records_7Year" -Property "RetentionPeriod" -PropertyValue "7 years" -Namespace "share/Legal Documents" -ClassificationMechanism "Folder Classifier"
}
```
#### Get-FSxFSRMClassificationRule
ファイルシステムから 1 つ以上の分類ルールを取得します。
##### パラメータ
+ `Name (array)` - オプション。取得する分類ルールの名前の配列。名前を指定しない場合、コマンドはファイルシステム上のすべてのルールを返します。
**例:**
1. ファイルシステムのすべての分類ルールを取得します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMClassificationRule
}
```
##### Set-FSxFSRMClassificationRule
既存の分類ルールのプロパティを変更します。
##### パラメータ
+ `Name (array)` - 必須。変更する分類ルールの名前の配列。
+ `Description (string)` - オプション。ルールの新しい説明。
+ `Property (string)` - オプション。設定する分類プロパティの名前。
+ `PropertyValue (string)` - オプション。プロパティに割り当てる新しい値。
+ `Namespace (array)` - オプション。ルールが適用されるパスまたはフォルダタイプの新しい配列。
+ `Disabled (boolean)` - オプション。true に設定すると、 はルールを無効にします。false に設定すると、ルールが有効になります。
+ `ReevaluateProperty (string)` - オプション。ファイルを再評価するタイミングを変更します。次の値を指定できます。
+ `Never`: 既存のプロパティ値がないファイルのみを評価する
+ `Overwrite`: ファイルが変更されたときに再評価し、既存の値を上書きする
+ `Aggregate`: ファイルが変更されたときに再評価し、既存の値と組み合わせる
+ `Flags (array)` - オプション。ルールの新しい特殊な動作。次の値を指定できます。
+ `ClearAutomaticallyClassifiedProperty`
+ `ClearManuallyClassifiedProperty`
+ `Deprecated`
+ `ContentRegularExpression (array)` - オプション。正規表現の新しい配列。
+ `ContentString (array)` - オプション。大文字と小文字を区別しない検索文字列の新しい配列。
+ `ContentStringCaseSensitive (array)` - オプション。大文字と小文字を区別する検索文字列の新しい配列。
+ `ClassificationMechanism (string)` - オプション。使用する新しい分類メカニズム。次の値を指定できます。
+ `Content Classifier`: 特定の文字列または正規表現パターンのファイルコンテンツをスキャンします。Content Classifier を指定すると、ContentString、ContentStringCaseSensitive、または ContentRegularExpression パラメータを使用して、検索するコンテンツを定義できます。
+ `Folder Classifier`: フォルダの場所に基づいてファイルを分類します
+ `Parameters (array)` - オプション。`"name=value"` 設定文字列の新しい配列。
+ `PassThru (boolean)` - オプション。true に設定すると、変更されたルールオブジェクトが返されます。
**例:**
1. 既存の分類ルールのルールプロパティと名前空間を更新します。
```
$namespaces = @("share\finance", "share\accounting")
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList $namespaces -ScriptBlock {
param($namespaces)
Set-FSxFSRMClassificationRule -Name "Detect_CreditCard" -Description "Updated PII detection" -Namespace $Using:namespaces -ReevaluateProperty "Overwrite"
}
```
##### Remove-FSxFSRMClassificationRule
ファイルシステムから 1 つ以上の分類ルールを削除します。
##### パラメータ
+ `Name (array)` - 必須。削除する分類ルールの名前の配列。
+ `PassThru (boolean)` - オプション。true に設定すると、削除されたルールオブジェクトが返されます。
**例:**
1. 1 つの分類ルールを削除します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Remove-FSxFSRMClassificationRule -Name "Find Confidential Files" -PassThru
}
```
### 管理プロパティコマンド
#### Get-FSxFSRMMgmtProperty
指定されたフォルダから管理プロパティを取得します。管理プロパティは、ファイルではなくフォルダに適用される分類プロパティです。
##### パラメータ
+ `Namespace (string)` - オプション。フォルダへのパス。
+ `Name (string)` - オプション。取得する管理プロパティの名前。名前を指定しない場合、コマンドはすべての管理プロパティを取得します。
+ `Recurse (boolean)` - オプション。true に設定すると、 は名前空間内のすべてのフォルダの管理プロパティを取得します。Namespace パラメータが必要です。
+ `Effective (boolean)` - オプション。true に設定すると、指定した名前の最も近いフォルダの管理プロパティを取得します。検索には、指定された名前空間とその親階層が含まれます。Name パラメータが必要です。
**例:**
1. ファイルシステムのすべての管理プロパティを取得します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMMgmtProperty
}
```
2. 特定のフォルダの管理プロパティを取得します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMMgmtProperty -Namespace "share\department"
}
```
#### Remove-FSxFSRMMgmtProperty
指定されたフォルダから管理プロパティを削除します。
##### パラメータ
+ `Namespace (string)` - オプション。フォルダへのパス。
+ `Name (string)` - 必須。削除する管理プロパティの名前。
+ `Recurse (boolean)` - オプション。true に設定すると、 は名前空間内のすべてのフォルダの管理プロパティを削除します。Namespace パラメータが必要です。
**例:**
1. 管理プロパティのすべてのインスタンスを削除します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Remove-FSxFSRMMgmtProperty -Name "FolderUsage_MS"
}
```
2. 特定のフォルダから管理プロパティを削除します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Remove-FSxFSRMMgmtProperty -Name "FolderUsage_MS" -Namespace "share\department"
}
```
#### Set-FSxFSRMMgmtProperty
指定された名前空間の管理プロパティの値を変更します。管理プロパティは、フォルダに適用され、Secure フラグが設定されていない分類プロパティです。
##### パラメータ
+ `Namespace (string)` - オプション。フォルダパス。
+ `Name (string)` - 必須。変更する管理プロパティの名前。フォルダに適用される既存の分類プロパティである必要があります。
+ `Value (string)` - 必須。管理プロパティに割り当てる新しい値。
**例:**
1. フォルダ使用状況プロパティを設定します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Set-FSxFSRMMgmtProperty -Namespace "share\department" -Name "FolderUsage_MS" -Value "User Files"
}
```
### 分類プロセスコマンド
#### Get-FSxFSRMClassification
実行中のファイル分類プロセスのステータスを取得します。ステータスは、次のいずれかの値になります。
+ `Unknown`: 分類ステータスを特定できません
+ `NotRunning`: 現在実行中の分類はありません
+ `Queued`: 分類は開始するためにキューに入れられます
+ `Running`: 分類は現在進行中です
##### パラメータ
なし
**例:**
1. 現在の分類ステータスを取得します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMClassification
}
```
#### Start-FSxFSRMClassification
ファイル分類プロセスを開始し、ファイルに分類ルールを適用して分類レポートを生成します。
##### パラメータ
+ `Queue (boolean)` - オプション。true に設定すると、 は分類タスクをキューに追加し、5 分以内に実行します。この期間中にキューに入れられたタスクは一緒に実行されます。false に設定するか、指定しない場合、分類はすぐに開始されます。
+ `RunDuration (number)` - オプション。分類プロセスがキャンセルされるまでに実行する時間を指定します。有効な値: `-1` から `2147483`。特殊な値:
+ `-1`: キャンセルされるまで実行
+ `0`: 完了まで実行
+ 指定しない場合、 は完了まで実行されます。
**例:**
1. 制限時間なしで分類を開始します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Start-FSxFSRMClassification -RunDuration 0
}
```
#### Stop-FSxFSRMClassification
ファイルシステムで実行中またはキューに入れられた分類ジョブを停止します。
##### パラメータ
なし
**例:**
1. 実行中の分類を停止します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Stop-FSxFSRMClassification
}
```
#### Wait-FSxFSRMClassification
ファイル分類プロセスが完了するまで待ちます。分類ファイルに基づくレポートの生成など、分類の終了に依存するアクションを実行する必要がある場合は、このコマンドを使用します。
##### パラメータ
+ `Timeout (number)` - オプション。分類が完了するまでの待機時間を秒単位で指定します。分類が終了する前にタイムアウトが期限切れになると、 コマンドは を返しますが、分類はバックグラウンドで実行され続けます。有効な値: `-1` から `2147483`。特殊な値:
+ `-1`: 分類が完了するまで無期限に待機する (デフォルト)
+ `0`: 現在のステータスを確認し、待たずにすぐに戻る
**例:**
1. 分類が完了するまで無期限に待ちます。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Wait-FSxFSRMClassification
}
```
#### Set-FSxFSRMClassification
ファイル分類の設定を変更します。
##### パラメータ
+ `ExcludeNamespace (array)` - オプション。分類から除外する追加のフォルダの配列。
+ `ScheduleConfigurations (hashtable)` - オプション。次のプロパティを持つスケジュール設定を含むハッシュテーブル。
+ `Time (datetime)`: タスクを実行するタイミングを指定する DateTime オブジェクト (必須)
+ `RunDuration (number)`: タスクを実行する時間数 (オプション)
+ `Weekly (array)`: 平日の配列 (オプション)
+ `Monthly (array)`: 曜日の配列。最終日には -1 を使用します (オプション)
+ `Continuous (boolean)` - オプション。true に設定すると、連続バックグラウンド分類が有効になります。
+ `PassThru (boolean)` - オプション。true に設定すると、変更された分類設定オブジェクトが返されます。
**例:**
1. 連続分類を有効にします。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Set-FSxFSRMClassification -Continuous $true
}
```
2. 週次スケジュールを設定して分類を実行します。
```
$schedule = @{
Time = ("12:00am")
Weekly = @('Monday', 'Wednesday', 'Friday')
}
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList $schedule -ScriptBlock {
param($schedule)
Set-FSxFSRMClassification -ScheduleConfigurations $schedule
}
```
3. カスタム除外を使用して毎月のスケジュールを設定します。
```
$schedule = @{
Time = ("12:00am")
Monthly = @(1, 15, -1) # 1st, 15th, and last day
RunDuration = 4
}
$excludeNamespaces = @("share\folder /s")
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList @($schedule, $excludeNamespaces) -ScriptBlock {
param($schedule, $excludeNamespaces)
Set-FSxFSRMClassification -ScheduleConfigurations $schedule -ExcludeNamespace $excludeNamespaces
}
```
# ストレージレポート
ストレージレポートは、ファイルシステムの使用状況の詳細な分析を提供し、ストレージの使用状況の把握、アーカイブまたは削除できるファイルの特定、ファイル管理ポリシーへの準拠のモニタリングに役立ちます。ファイルの所有権、ファイルタイプ、重複ファイル、大きなファイル、ファイルスクリーニング、クォータの使用状況を分析する複数のタイプのレポートを生成できます。
## レポートタイプ
次のレポートタイプを作成できます。
+ `DuplicateFiles`
ファイルサイズとハッシュ比較に基づいて、同じコンテンツを持つファイルを識別します。このレポートを使用して、不要なストレージ領域を消費する冗長ファイルを検索します。レポートは重複ファイルをグループ化し、重複を削除することで復旧できる合計領域を表示します。
+ `FilesByFileGroup`
ファイル[グループ](fsrm-file-groups.md)メンバーシップでファイルをグループ化し、各ファイルグループのストレージ消費量を表示します。このレポートを使用して、どのタイプのファイル (ドキュメント、メディア、実行可能ファイルなど) が最も消費するストレージ領域を把握します。
+ `FilesByOwner`
所有者ごとにファイルをグループ化し、各ユーザーまたはグループが消費するストレージの量を示します。このレポートを使用して、ストレージ領域を最も多く消費しているユーザーを特定し、ストレージコストまたはクォータを適切に割り当てます。
+ `FilesByProperty`
分類プロパティ値でファイルをグループ化し、各プロパティ値のファイル数とストレージ消費量を表示します。このレポートを使用して、データの機密性レベル、部門、保持期間などの分類に基づいてファイルを分析します。このレポートでは、ファイルが を使用して分類されている必要があります[分類ルール](fsrm-file-classification.md#fsrm-classification-rules)。
+ `FileScreenAuditFiles`
アクティブなファイル画面によってブロックされたファイルを保存しようとした[ファイルスクリーニング](fsrm-file-screening.md)違反を一覧表示します。このレポートを使用して、ファイルスクリーニングポリシーへの準拠をモニタリングし、不正なファイルタイプの保存を頻繁に試みるユーザーを特定します。
+ `FoldersByProperty`
管理プロパティ値でフォルダをグループ化し、各プロパティ値のストレージ消費量を表示します。このレポートを使用して、ユーザーファイル、グループ共有、アプリケーションファイルなど、フォルダの目的別にストレージの使用状況を分析します。
+ `LargeFiles`
指定されたサイズのしきい値を超えるファイルを一覧表示します。このレポートを使用して、大量のストレージ領域を消費し、アーカイブ、圧縮、削除の対象となる可能性のあるファイルを特定します。
+ `LeastRecentlyAccessed`
指定した日数アクセスされていないファイルを一覧表示します。このレポートを使用して、アーカイブまたは低コストのストレージ階層に移動できる非アクティブなファイルを特定します。
+ `MostRecentlyAccessed`
指定された日数内にアクセスされたファイルを一覧表示します。
+ `QuotaUsage`
クォータが設定されたフォルダの[クォータ](fsrm-quota-management.md)使用状況統計を表示します。このレポートを使用して、クォータのコンプライアンスをモニタリングし、クォータの制限に近づいているフォルダを特定します。
## レポート形式
さまざまなユースケースに合わせて、複数の形式でレポートを生成できます。
+ `DHTML` - ソートやフィルタリングなどのインタラクティブな機能を備えた動的 HTML 形式。
+ `HTML` - アーカイブまたは E メール送信に適した静的 HTML 形式。
+ `XML` - プログラムによる処理のための構造化データ形式。
+ `CSV` - スプレッドシートアプリケーションにインポートするためのカンマ区切り値形式。
+ `Text` - シンプルな表示または処理のためのプレーンテキスト形式。
1 つのレポートに複数の形式を指定できます。
## インタラクティブレポートとスケジュールされたレポート
次の 2 種類のストレージレポートを作成できます。
1. **インタラクティブレポート** - 作成時にすぐに実行し、1 回だけ実行します。アドホック分析またはトラブルシューティングには、インタラクティブなレポートを使用します。インタラクティブレポートにはスケジュールがないため、作成後に変更することはできません。別のインタラクティブレポートを実行するには、別の名前で新しいレポートを作成する必要があります。
1. **スケジュールされたレポート** - 設定されたスケジュールに従って自動的に実行されます。スケジュールされたレポートを使用して、定期的なモニタリングとコンプライアンスレポートを作成します。レポートは、週 1 回または月 1 回、特定の時間に実行するようにスケジュールできます。スケジュールされたレポートは設定を変更できます。また、スケジュールされた時間を待たずに [Start-FSxFSRMStorageReport](#start-fsxfsrmstoragereport) コマンドを使用してオンデマンドで実行することもできます。
## レポートの実行
スケジュールされたレポートを作成したら、いくつかの方法で実行できます。
+ **自動実行** - スケジュールされたレポートは、設定されたスケジュール時刻に自動的に実行されます。
+ **手動実行** - スケジュールされた時間を待たずに、スケジュールされたレポートをオンデマンドで実行[Start-FSxFSRMStorageReport](#start-fsxfsrmstoragereport)するために使用します。
を使用してレポートの実行をモニタリング[Get-FSxFSRMStorageReport](#get-fsxfsrmstoragereport)し、ステータスを確認できます。
## ストレージレポートへのアクセス
FSRM がストレージレポートを生成すると、レポートファイルはファイルシステムのデフォルトの場所に保存されます。これらのレポートにアクセスするには、ファイルシステムの管理 D\$1 共有をマッピングする必要があります。
**ストレージレポートにアクセスするには**
1. 次のパス形式を使用して管理 D\$1 共有をマッピングします。
```
\\file-system-dns-name\D$
```
例えば、次のようになります。
```
\\amznfsxaa11bb22.corp.example.com\D$
```
1. StorageReports フォルダに移動します。このフォルダには、レポートタイプと実行日別に整理されたサブフォルダが含まれています。
**注記**
管理 D\$1 共有にアクセスするには、管理者認証情報が必要です。
## ストレージレポートのベストプラクティス
効率的で効果的なストレージレポートを確実に行うには、以下のベストプラクティスに従ってください。
### パフォーマンスに関する考慮事項
FSRM は大量のファイルをスキャンする必要があるため、ストレージレポートの生成はリソースを大量に消費します。
+ **レポート範囲の制限** - `Namespace`パラメータを使用して、ファイルシステム全体をスキャンするのではなく、レポートを特定のフォルダに制限します。大規模なディレクトリ構造のスキャンはリソースを大量に消費するため、完了までに数時間かかる場合があります。
+ **オフピーク時間にレポートをスケジュール**する - システムアクティビティが低い時間帯にスケジュールされたレポートを実行して、パフォーマンスへの影響を最小限に抑えます。バックアップウィンドウやその他のメンテナンスタスク中にレポートを実行しないでください。
+ **妥当なしきい値を設定する** - しきい値パラメータを使用して、レポート出力を実用的なデータに制限します。例えば、 `LargeFileMinimum`を 1 1MB を超えるすべてのファイルではなく、調査する価値のあるファイルを識別する値に設定します。
+ **RunDuration の制限**を使用する - `RunDuration`パラメータを設定して、レポートの実行時間が長すぎてシステムパフォーマンスに影響を与えないようにします。レポートが時間制限内に完了しない場合、次回のスケジュールされた実行中に再開されます。
+ **レポートのパフォーマンスをモニタリング**する - レポートの完了にかかる時間をチェック[Get-FSxFSRMStorageReport](#get-fsxfsrmstoragereport)するために使用します。レポートが一貫して長すぎる場合は、範囲を狭めるか、実行頻度を低くすることを検討してください。
### レポート設計
+ **わかりやすい名前を使用する** - 「毎週の大きなファイル - 財務共有」や「毎月の重複ファイル - すべての共有」など、分析内容と実行時期を示すわかりやすい名前をレポートに付けます。
+ **関連する分析を組み合わせる** - 同じ名前空間に対して複数のレポートタイプを生成する場合は、個別のレポートではなく、複数の`ReportType`値を持つ単一のレポートを作成します。これは、FSRM がディレクトリ構造を 1 回スキャンするだけで済むため、より効率的です。
+ **ファイルパターンでフィルタリング** - ファイルパターンパラメータを使用して、特定のファイルタイプにレポートに焦点を当てます。たとえば、大きなファイルを分析する際に、ストレージの消費パターンをよりよく理解するために、ビデオファイル、データベースファイル、アーカイブファイルの個別のレポートを作成できます。
+ **分類プロパティを活用する** - `FilesByProperty`レポートを使用して、分類に基づいてファイルを分析します。これにより、より有意義なインサイトが得られます。
### レポート管理
+ **レポートを定期的に確認する** - レポート結果を確認し、結果に対してアクションを実行する時間をスケジュールします。レポートは、ストレージ管理の決定に使用する場合にのみ役立ちます。
+ **古いレポートをアーカイブ** - レポートファイルは時間の経過とともに蓄積され、ストレージ領域を消費します。レポートファイルの保持ポリシーを確立し、不要になった古いレポートを削除またはアーカイブします。
+ **スケジュール前にレポートをテスト**する - インタラクティブレポートを作成してレポート設定をテストし、スケジュールされたバージョンを作成する前に期待される結果が得られることを確認します。
## ストレージレポート管理コマンド
ストレージレポートを管理するために、FSx リモート PowerShell コマンドの 2 つのファミリーにアクセスできます。
1. **レポート定義コマンド** - 分析するデータ、レポートを実行するタイミング、生成する形式を指定するストレージレポート設定を作成、取得、変更、削除します。
1. **レポート実行コマンド** - ストレージレポートの生成を開始、停止、モニタリング、待機します。これらのコマンドを使用して、レポートをオンデマンドで実行したり、長時間実行されるレポートジョブを管理したりできます。
### Storage Report FSx リモート PowerShell コマンドのリスト
**注記**
このページのすべての例では、ファイルシステムの Windows Remote PowerShell エンドポイントで ` $FSxWindowsRemotePowerShellEndpoint`変数が定義されていることを前提としています。このエンドポイントは、ファイルシステムの詳細ページの Amazon FSx コンソール、または コマンドを使用して AWS CLI `describe-file-systems`確認できます。
### レポート定義コマンド
#### New-FSxFSRMStorageReport
**New-FSxFSRMStorageReport**: 指定されたディレクトリを分析して 1 つ以上のレポートタイプを生成するストレージレポートを作成します。
**パラメータ :**
+ `Name (string)` - 必須。ストレージレポートの名前。
+ `Namespace (array)` - 必須。分析するパスまたはフォルダタイプの配列。パスは複数の形式で指定できます。
+ フォルダパス
+ [フォルダ分類](fsrm-file-classification.md#fsrm-management-properties)。例: [FolderUsage\$1MS"User Files"]
+ `ReportType (array)` - 必須。生成するレポートタイプの配列。次の値を指定できます。
+ `DuplicateFiles`: ファイルサイズとコンテンツに基づいて重複ファイルを識別します
+ `FilesByFileGroup`: ファイルグループメンバーシップでファイルをグループ化する
+ `FilesByOwner`: 所有者別にファイルをグループ化する
+ `FilesByProperty`: 分類プロパティでファイルをグループ化する
+ `FileScreenAuditFiles`: ファイルスクリーニング違反を一覧表示します
+ `FoldersByProperty`: 管理プロパティでフォルダをグループ化する
+ `LargeFiles`: 指定されたサイズしきい値を超えるファイルを一覧表示します
+ `LeastRecentlyAccessed`: 最近アクセスされていないファイルを一覧表示します
+ `MostRecentlyAccessed`: 最近アクセスされたファイルを一覧表示します
+ `QuotaUsage`: クォータ使用状況統計を表示します
+ `ReportFormat (array)` - オプション。出力形式の配列。次の値を指定できます。
+ `DHTML`: 動的 HTML 形式
+ `HTML`: 静的 HTML 形式
+ `XML`: XML 形式
+ `CSV`: カンマ区切り値形式
+ `Text`: プレーンテキスト形式
+ `Interactive (boolean)` - オプション。true に設定すると、 はインタラクティブレポートを生成します。インタラクティブレポートは、作成後に変更することはできません。
+ `ScheduleConfigurations (hashtable)` - レポートがインタラクティブでない限り必要です。次のプロパティを持つスケジュール設定を含むハッシュテーブル。
+ `Time (datetime)`: タスクを実行するタイミングを指定する DateTime オブジェクト (必須)
+ `RunDuration (number)`: タスクを実行する時間数 (オプション)
+ `Weekly (array)`: 平日の配列 (オプション)
+ `Monthly (array)`: 曜日の配列、最終日`-1`に使用します (オプション)
**レポート固有のパラメータ:**
+ `FileScreenAuditDaysSince (number)` - オプション。FileScreenAuditFiles レポートの場合、監査イベントを含めるまでの日数を指定します。
+ `FileScreenAuditUser (array)` - オプション。FileScreenAuditFiles レポートの場合、レポートに含めるユーザーアカウントの配列を指定します。これらのユーザーによるファイルスクリーニング違反のみが含まれます。
+ `FileGroupIncluded (array)` - オプション。FilesByFileGroup レポートの場合、含めるファイルグループを指定します。
+ `FileOwnerFilePattern (string)` - オプション。FilesByOwner レポートの場合、結果をフィルタリングするファイルパターンを指定します。
+ `PropertyName (string)` - オプション。FilesByProperty レポートの場合、グループ化する分類プロパティを指定します。
+ `FolderPropertyName (string)` - オプション。FoldersByProperty レポートの場合、グループ化するフォルダプロパティを指定します。
+ `PropertyFilePattern (string)` - オプション。FilesByProperty および FoldersByProperty の場合、結果をフィルタリングするファイルパターンを指定します。
+ `LargeFileMinimum (number)` - オプション。LargeFiles レポートの場合、最小ファイルサイズをバイト単位で指定します。
+ `LargeFilePattern (string)` - オプション。LargeFiles レポートの場合、結果をフィルタリングするファイルパターンを指定します。
+ `LeastAccessedMinimum (number)` - オプション。LeastRecentlyAccessed レポートの場合、前回のアクセスからの最小日数を指定します。
+ `LeastAccessedFilePattern (string)` - オプション。LeastRecentlyAccessed レポートの場合、結果をフィルタリングするファイルパターンを指定します。
+ `MostAccessedMaximum (number)` - オプション。MostRecentlyAccessed レポートの場合、前回のアクセスからの最大日数を指定します。
+ `MostAccessedFilePattern (string)` - オプション。MostRecentlyAccessed レポートの場合、結果をフィルタリングするファイルパターンを指定します。
+ `QuotaMinimumUsage (number)` - オプション。QuotaUsage レポートの場合、含める最小クォータ使用率を指定します。
**例:**
1. 毎月のラージファイルレポートを作成します。
```
$schedule = @{
Time = ("3:00 AM")
Monthly = @(1) # Run on first day
}
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList $schedule -ScriptBlock {
param($schedule)
New-FSxFSRMStorageReport -Name "Monthly Large Files" -Namespace "share\data" -ReportType "LargeFiles" -LargeFileMinimum 100MB -ReportFormat "HTML" -ScheduleConfigurations $schedule
}
```
2. 複数の名前空間と形式で毎週重複ファイルレポートを作成します。
```
$schedule = @{
Time = ("12:00 AM")
Weekly = @('Sunday')
RunDuration = 4
}
$namespaces = @("share\docs", "[FolderUsage_MS=User Files]")
$reportFormats = @("HTML", "CSV")
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList @($schedule, $namespaces, $reportFormats) -ScriptBlock {
param($schedule, $namespaces, $reportFormats)
New-FSxFSRMStorageReport -Name "Weekly Duplicates" -Namespace $namespaces -ReportType "DuplicateFiles" -ReportFormat $reportFormats -ScheduleConfigurations $schedule
}
```
3. すぐに実行されるインタラクティブレポートを作成します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMStorageReport -Name "Find large files" -Namespace "share" -Interactive $true -ReportType "QuotaUsage"
}
```
#### Get-FSxFSRMStorageReport
**Get-FSxFSRMStorageReport**: ファイルシステムから 1 つ以上のストレージレポートを取得します。レポートの設定とステータスに関する詳細を返します。
**パラメータ :**
+ `Name (array)` - オプション。取得するレポート名の配列。名前を指定しない場合、コマンドはファイルシステム上のすべてのストレージレポートを返します。
**例:**
1. ファイルシステム上のすべてのストレージレポートを取得します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMStorageReport
}
```
#### Remove-FSxFSRMStorageReport
**Remove-FSxFSRMStorageReport**: ファイルシステムから 1 つ以上のストレージレポートを削除します。現在実行中のレポートは削除できません。
**パラメータ :**
+ `Name (array)` - 必須。削除するレポート名の配列。
+ `PassThru (boolean)` - オプション。true に設定すると、削除されたレポートオブジェクトが返されます。
**例:**
1. 1 つのストレージレポートを削除します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Remove-FSxFSRMStorageReport -Name "Monthly Report" -PassThru
}
```
#### Set-FSxFSRMStorageReport
##### パラメータ
+ `Name (array)` - 必須。変更するレポート名の配列。
+ `Namespace (array)` - オプション。分析するパスまたはフォルダタイプの配列。パスは複数の形式で指定できます。
+ フォルダパス
+ [フォルダ分類](fsrm-file-classification.md#fsrm-management-properties)。例: [FolderUsage\$1MS"User Files"]
+ `ReportType (array)` - オプション。生成するレポートタイプの配列。次の値を指定できます。
+ `DuplicateFiles`: ファイルサイズとコンテンツに基づいて重複ファイルを識別します
+ `FilesByFileGroup`: ファイルグループメンバーシップでファイルをグループ化する
+ `FilesByOwner`: 所有者別にファイルをグループ化する
+ `FilesByProperty`: 分類プロパティでファイルをグループ化する
+ `FileScreenAuditFiles`: ファイルスクリーニング違反を一覧表示します
+ `FoldersByProperty`: 管理プロパティでフォルダをグループ化する
+ `LargeFiles`: 指定されたサイズしきい値を超えるファイルを一覧表示します
+ `LeastRecentlyAccessed`: 最近アクセスされていないファイルを一覧表示します
+ `MostRecentlyAccessed`: 最近アクセスされたファイルを一覧表示します
+ `QuotaUsage`: クォータ使用状況統計を表示します
+ `ReportFormat (array)` - オプション。出力形式の配列。次の値を指定できます。
+ `DHTML`: 動的 HTML 形式
+ `HTML`: 静的 HTML 形式
+ `XML`: XML 形式
+ `CSV`: カンマ区切り値形式
+ `Text`: プレーンテキスト形式
+ `ScheduleConfigurations (hashtable)` - レポートがインタラクティブでない限り必要です。次のプロパティを持つスケジュール設定を含むハッシュテーブル。
+ `Time (datetime)`: タスクを実行するタイミングを指定する DateTime オブジェクト (必須)
+ `RunDuration (number)`: タスクを実行する時間数 (オプション)
+ `Weekly (array)`: 平日の配列 (オプション)
+ `Monthly (array)`: 曜日の配列、最終日`-1`に使用します (オプション)
+ `PassThru (boolean)` - オプション。true に設定すると、変更されたレポートオブジェクトが返されます。
##### レポート固有のパラメータ
+ `FileScreenAuditDaysSince (number)` - オプション。FileScreenAuditFiles レポートの場合、監査イベントを含めるまでの日数を指定します。
+ `FileScreenAuditUser (array)` - オプション。FileScreenAuditFiles レポートの場合、レポートに含めるユーザーアカウントの配列を指定します。これらのユーザーによるファイルスクリーニング違反のみが含まれます。
+ `FileGroupIncluded (array)` - オプション。FilesByFileGroup レポートの場合、含めるファイルグループを指定します。
+ `FileOwnerFilePattern (string)` - オプション。FilesByOwner レポートの場合、結果をフィルタリングするファイルパターンを指定します。
+ `PropertyName (string)` - オプション。FilesByProperty レポートの場合、グループ化する分類プロパティを指定します。
+ `FolderPropertyName (string)` - オプション。FoldersByProperty レポートの場合、グループ化するフォルダプロパティを指定します。
+ `PropertyFilePattern (string)` - オプション。FilesByProperty および FoldersByProperty の場合、結果をフィルタリングするファイルパターンを指定します。
+ `LargeFileMinimum (number)` - オプション。LargeFiles レポートの場合、最小ファイルサイズをバイト単位で指定します。
+ `LargeFilePattern (string)` - オプション。LargeFiles レポートの場合、結果をフィルタリングするファイルパターンを指定します。
+ `LeastAccessedMinimum (number)` - オプション。LeastRecentlyAccessed レポートの場合、前回のアクセスからの最小日数を指定します。
+ `LeastAccessedFilePattern (string)` - オプション。LeastRecentlyAccessed レポートの場合、 は結果をフィルタリングするファイルパターンを指定します。
+ `MostAccessedMaximum (number)` - オプション。MostRecentlyAccessed レポートでは、前回のアクセスからの最大日数を指定します。
+ `MostAccessedFilePattern (string)` - オプション。MostRecentlyAccessed レポートの場合、結果をフィルタリングするファイルパターンを指定します。
+ `QuotaMinimumUsage (number)` - オプション。QuotaUsage レポートの場合、含める最小クォータ使用率を指定します。
##### 例:
1. 既存のレポートのスケジュールと形式を更新します。
```
$schedule = @{
Time = ("3:00 AM")
Monthly = @(1)
}
$reportFormats = @("HTML", "CSV")
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList @($schedule, $reportFormats) -ScriptBlock {
param($schedule, $reportFormats)
Set-FSxFSRMStorageReport -Name "Monthly Report" -ScheduleConfigurations $schedule -ReportFormat $reportFormats -PassThru
}
```
### レポート実行コマンド
#### Start-FSxFSRMStorageReport
##### パラメータ
+ `Name (array)` - 必須。開始するレポート名の配列。
+ `Queue (boolean)` - オプション。true に設定すると、 はレポートをキューに追加し、5 分以内に実行します。この期間中にキューに入れられたレポートは一緒に実行されます。false に設定するか、指定しない場合、レポートはすぐに開始されます。
+ `RunDuration (number)` - オプション。キャンセルされるまでにレポートを実行する時間を指定します。有効な値: `-1` から `2147483`。特殊な値:
+ `0`: 完了まで実行
+ `-1`: キャンセルされるまで実行
指定しない場合、 は完了まで実行されます。
##### 例
1. ストレージレポートをすぐに開始します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Start-FSxFSRMStorageReport -Name "Monthly Report"
}
```
2. 期間制限のあるストレージレポートをキューに入れます。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Start-FSxFSRMStorageReport -Name "Quarterly Report" -Queue: $true -RunDuration 4
}
```
#### Stop-FSxFSRMStorageReport
##### パラメータ
+ `Name (array)` - 必須。停止するレポート名の配列。
##### 例:
1. 1 つのストレージレポートを停止します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Stop-FSxFSRMStorageReport -Name "Monthly Report"
}
```
#### Wait-FSxFSRMStorageReport
##### パラメータ
+ `Name (array)` - 必須。待機するレポート名の配列。
+ `Timeout (number)` - オプション。レポートが完了するまでの待機時間を秒単位で指定します。レポートが終了する前にタイムアウトが期限切れになった場合、コマンドは を返しますが、レポート生成はバックグラウンドで実行され続けます。有効な値: `-1` から `2147483`。特殊な値:
+ `-1`: レポートが完了するまで無期限に待機する (デフォルト)
+ `0`: 現在のステータスを確認し、待たずにすぐに戻る
##### 例:
1. ストレージレポートが完了するまで無期限に待ちます。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Wait-FSxFSRMStorageReport -Name "Monthly Report"
}
```
# ファイル管理タスク
Amazon FSx for Windows File Server は、FSRM ファイル管理タスクをサポートしていません。ただし、ファイルシステムへのネットワークアクセスを持つクライアントマシンからのネイティブ PowerShell コマンドを使用することで、データアーカイブや保持ポリシーなどの一般的なユースケースを実現できます。
例えば、クライアントマシンで PowerShell スクリプトを使用して以下を行うことができます。
+ 経過時間または最終アクセス時間に基づいてファイルを移動またはアーカイブする
+ 保持期間を超える分類されたファイルを削除する
+ 分類プロパティに基づいてファイルをアーカイブストレージにコピーする
`Get-FsrmClassification` コマンドを使用してファイルのプロパティにアクセスし、値に基づいてアクションを実行できます。
クライアント側の PowerShell スクリプトから FSRM 分類プロパティまたは他の FSRM メタデータにアクセスするには、クライアントマシンに FSRM もインストールされている必要があります。
# FSRM 設定
FSRM 設定は、動作をカスタマイズし、機能管理を合理化できるシステム全体の設定を提供します。これらの設定を使用して、ファイルシステム全体で FSRM の動作を制御し、ストレージレポートやファイルスクリーニングなどの機能の作成と設定を簡素化するデフォルト値を設定します。
## 設定カテゴリ
FSRM 設定は 3 つのカテゴリに分類されます。
### ファイル画面の監査
ユーザーがアクティブなファイル画面によってブロックされているファイルを保存しようとしたときに、ファイル画面の監査が記録します。この情報は、ファイルスクリーニングポリシーへの準拠をモニタリングし、不正なファイルタイプの保存を頻繁に試みるユーザーを特定するために不可欠です。
+ `ReportFileScreenAuditEnable` - この設定は、FSRM がファイルスクリーニング違反をまったくログに記録するかどうかを制御します。無効にすると、FSRM はファイル画面違反を記録せず、`FileScreenAuditFiles`レポートには表示するデータがありません。ファイル画面の監査レポートを使用するには、この設定を有効にする必要があります。
+ `ReportFileScreenAuditDaysSince` - この設定は、ファイル画面監査レポートのデフォルトの時間範囲を提供します。どこまで遡るかを指定せずに`FileScreenAuditFiles`レポートを作成すると、FSRM はこの値を使用します。適切なデフォルト (30 日間など) を設定すると、過剰な履歴データを含めずに、レポートが最近の違反に集中できるようになります。
+ `ReportFileScreenAuditUser` - この設定は、ファイル画面の監査レポートに含めるユーザーのデフォルトリストを提供します。含めるユーザーを指定せずに`FileScreenAuditFiles`レポートを作成すると、FSRM はこのリストを使用します。空の場合、レポートにはデフォルトですべてのユーザーが含まれます。この設定を使用して、特定のユーザーグループまたは部門にレポートを集中させることができます。
### デフォルトのレポートフィルター
デフォルトのレポートフィルター設定は、特定のパラメータを指定せずにストレージレポートを作成するときに使用される値を提供します。これらのデフォルトは、レポートの作成を簡素化し、同様のレポート間の一貫性を確保します。
各レポートタイプには、デフォルト設定が関連付けられています。
+ 大きなファイルレポート - デフォルトの最小ファイルサイズ`ReportLargeFileMinimum`を設定し、デフォルトのファイルパターンフィルター`ReportLargeFilePattern`を設定します。
+ 最小アクセスファイルレポート - 前回のアクセスからのデフォルトの日数`ReportLeastAccessedMinimum`を設定し、デフォルトのファイルパターンフィルター`ReportLeastAccessedFilePattern`を設定します。
+ 最もアクセスされたファイルレポート - は、前回のアクセスからのデフォルトの最大日数`ReportMostAccessedMaximum`を設定し、デフォルトのファイルパターンフィルター`ReportMostAccessedFilePattern`を設定します。
+ 所有者別ファイルレポート - デフォルトのファイルパターンフィルター`ReportFileOwnerFilePattern`を設定し、含めるユーザーのデフォルトのリスト`ReportFileOwnerUser`を設定します。
+ プロパティレポートによるファイル - 分析するデフォルトの分類プロパティ`ReportPropertyName`を設定し、デフォルトのファイルパターンフィルター`ReportPropertyFilePattern`を設定します。
+ ファイルグループレポート別のファイル - 含めるファイルグループのデフォルトリスト`ReportFileGroupIncluded`を設定します。
+ クォータ使用状況レポート - デフォルトの最小クォータ使用率`ReportQuotaMinimumUsage`を設定します。
レポートを作成するときは、レポート設定で パラメータを明示的に指定することで、これらのデフォルトを上書きできます。グローバルデフォルトは、値を指定しない場合にのみ適用されます。
### レポートの制限
レポート制限設定は、ストレージレポートに含める項目の最大数を制御します。これらの制限は 2 つの目的を果たします。
1. パフォーマンス管理 - レポート内の項目数を制限すると、レポートが過剰なシステムリソースを生成または消費するのに時間がかかりすぎなくなります。数百万のファイルを分析する大規模なレポートでは、システムのパフォーマンスを完了して影響するまでに数時間かかることがあります。
1. レポートのユーザビリティ - 数千のエントリを含むレポートは、確認と分析が困難です。レポートの制限により、レポートは最も関連性の高いデータに集中し続けることができます。
レポート制限をきめ細かく制御できます。
+ 全体的な制限 - タイプに関係なく、レポート内のファイルの合計数`ReportLimitMaxFile`を制限します。
+ Per-report-type制限 - `ReportLimitMaxFileGroup`、` ReportLimitMaxOwner`、 などの設定では、特定のレポートタイプに含めるグループ、所有者、またはプロパティ値の数`ReportLimitMaxPropertyValue`を制限します。
+ グループごとの制限 - `ReportLimitMaxFilesPerFileGroup`、` ReportLimitMaxFilesPerOwner`、 などの設定では、レポート内の各グループ内に表示するファイル数` ReportLimitMaxFilesPerPropertyValue`を制限します。
レポートが制限に達すると、FSRM は最もストレージ領域を消費する項目、またはレポートタイプに最も関連性の高い項目を含め、制限に達したことをレポートに示します。
## FSRM 設定コマンド
グローバル設定を取得および変更するためのコマンドにアクセスできます。これらのコマンドを使用して、システム全体の FSRM 動作を設定します。
### FSRM 設定 FSx リモート PowerShell コマンドのリスト
**注記**
このページのすべての例では、ファイルシステムの Windows Remote PowerShell エンドポイントで ` $FSxWindowsRemotePowerShellEndpoint`変数が定義されていることを前提としています。このエンドポイントは、ファイルシステムの詳細ページの Amazon FSx コンソール、または コマンドを使用して AWS CLI `describe-file-systems`確認できます。
### Get-FSxFSRMSetting
`Get-FSxFSRMSetting`: ファイルシステムの現在の File Server Resource Manager 設定を取得します。Set-FSxFSRMSetting を使用して変更できる設定のみを返します。
**パラメータ :**
なし
**例:**
1. 現在の FSRM 設定をすべて取得します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMSetting
}
```
### Set-FSxFSRMSetting
`Set-FSxFSRMSetting`: ファイルシステムのグローバル File Server Resource Manager 設定を変更します。これらの設定は、ストレージレポートのデフォルト値を提供し、FSRM の動作を制御します。
**パラメータ :**
**ファイル画面の監査設定:**
+ `ReportFileScreenAuditEnable (boolean)` - オプション。ファイルスクリーニング監査イベントを FSRM レポートに含めるかどうかを制御します。
+ `ReportFileScreenAuditDaysSince (number)` - オプション。FileScreenAuditFiles レポートの生成時にファイルスクリーニング違反をさかのぼるデフォルトの日数。
+ `ReportFileScreenAuditUser (array)` - オプション。FileScreenAuditFiles レポートに含めるユーザーアカウントのデフォルトリストの配列。
**デフォルトのレポートフィルター設定:**
+ `ReportFileGroupIncluded (array)` - オプション。デフォルトでは、レポートに含めるファイルグループ名の配列。
+ `ReportFileOwnerFilePattern (string)` - オプション。所有者レポート別のファイルのデフォルトのファイルパターン。ワイルドカード (`*` および `?`) をサポートします。
+ `ReportFileOwnerUser (array)` - オプション。所有者レポート別のファイルの Domain\$1User 形式のユーザーの配列。
+ `ReportLargeFileMinimum (number)` - オプション。大きなファイルレポートのデフォルトの最小ファイルサイズ。
+ `ReportLargeFilePattern (string)` - オプション。大きなファイルレポートのデフォルトのファイルパターン。ワイルドカード (`*` および `?`) をサポートします。
+ `ReportLeastAccessedFilePattern (string)` - オプション。アクセスが最も少ないファイルレポートのデフォルトのファイルパターン。ワイルドカード (`*` および `?`) をサポートします。
+ `ReportLeastAccessedMinimum (number)` - オプション。最小アクセスファイルレポートの最終アクセスからのデフォルトの最小日数。
+ `ReportMostAccessedFilePattern (string)` - オプション。アクセスが最も多いファイルレポートのデフォルトのファイルパターン。ワイルドカード (`*` および `?`) をサポートします。
+ `ReportMostAccessedMaximum (number)` - オプション。最もアクセス頻度の高いファイルレポートの最終アクセスからのデフォルトの最大日数。
+ `ReportPropertyFilePattern (string)` - オプション。プロパティレポートのデフォルトのファイルパターン。ワイルドカード (`*` および `?`) をサポートします。
+ `ReportPropertyName (string)` - オプション。プロパティレポートのデフォルトのプロパティ名。
+ `ReportQuotaMinimumUsage (number)` - オプション。クォータ使用状況レポートのデフォルトの最小クォータ使用率。
**レポート制限設定:**
+ `ReportLimitMaxDuplicateGroup (number)` - オプション。重複ファイルレポートに含める重複ファイルグループの最大数。
+ `ReportLimitMaxFile (number)` - オプション。ストレージレポートに含めるファイルの最大数。
+ `ReportLimitMaxFileGroup (number)` - オプション。レポートに含めるファイルグループの最大数。
+ `ReportLimitMaxFileScreenEvent (number)` - オプション。ファイル画面監査レポートに含めるファイル画面イベントの最大数。
+ `ReportLimitMaxFilesPerDuplicateGroup (number)` - オプション。重複ファイルレポート内の重複グループあたりのファイルの最大数。
+ `ReportLimitMaxFilesPerFileGroup (number)` - オプション。ファイルグループレポート別のファイル内のファイルグループあたりのファイルの最大数。
+ `ReportLimitMaxFilesPerOwner (number)` - オプション。所有者レポート別のファイル内の所有者あたりのファイルの最大数。
+ `ReportLimitMaxFilesPerPropertyValue (number)` - オプション。プロパティレポート別のファイル内のプロパティ値あたりのファイルの最大数。
+ `ReportLimitMaxOwner (number)` - オプション。所有者レポートごとにファイルに含める所有者の最大数。
+ `ReportLimitMaxPropertyValue (number)` - オプション。プロパティレポートごとにファイルに含めるプロパティ値の最大数。
+ `ReportLimitMaxQuota (number)` - オプション。クォータ使用状況レポートに含めるクォータの最大数。
**その他の設定:**
+ `PassThru (boolean)` - オプション。true に設定すると、 は変更された設定オブジェクトを返します。
**例:**
1. デフォルトのファイル画面監査を 30 日間の履歴で設定します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Set-FSxFSRMSetting -ReportFileScreenAuditDaysSince 30 -PassThru
}
```
1. デフォルトのラージファイルレポート設定を構成します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Set-FSxFSRMSetting -ReportLargeFileMinimum 100MB -ReportLargeFilePattern "*.iso" -PassThru
}
```
# イベントログ
ファイルシステムで FSRM を有効にすると、 AWS FSx for Windows File Server はファイル管理アクティビティのイベントログを生成し、設定した送信先 (AWS CloudWatch Logs または AWS Kinesis Data Firehose) に送信します。これらのログは、FSRM オペレーションのモニタリング、問題のトラブルシューティング、ファイル管理アクティビティの監査証跡の維持に役立ちます。
## FSRM がログに記録する内容
ファイルシステムで FSRM を有効にすると、 AWS FSx for Windows File Server はイベントをログに記録し、設定した送信先に送信します。次のイベントがログに記録されます。
+ ファイルスクリーニング違反 - イベント通知アクションを持つファイル画面によってモニタリングされるファイルを保存しようとする場合
+ クォータしきい値通知 - クォータの使用量が、イベント通知アクションを持つ設定されたしきい値に達した場合
+ FSRM サービスイベント – 通知設定、サービスエラー、運用障害の確認
## FSRM ログへのアクセス
FSRM ログにアクセスする場所は、FSRM を有効にするときに設定した送信先によって異なります。
CloudWatch ログ
指定したロググループに移動して、CloudWatch Logs コンソールでログを表示します。CloudWatch Logs Insights を使用してログを検索、フィルタリング、分析し、CloudWatch アラームを設定して特定のイベントを通知することができます。
Kinesis Data Firehose
ログは、Amazon S3、Redshift、OpenSearch Service など、Kinesis Data Firehose 配信ストリームで設定された送信先に配信されます。 AWS AWS OpenSearch 配信ストリームと統合されたツールとサービスを使用して、ログを処理および分析できます。
# 一般的なユースケース
このトピックでは、一般的な File Server Resource Manager タスクのstep-by-stepの例を示します。これらの例は、FSRM 機能を使用して実装し、一般的なファイル管理の課題を解決する方法を示しています。
**注記**
このページのすべての例では、ファイルシステムの Windows Remote PowerShell エンドポイントで ` $FSxWindowsRemotePowerShellEndpoint`変数が定義されていることを前提としています。このエンドポイントは、Amazon FSx コンソールのファイルシステムの詳細ページ、または コマンドを使用して AWS CLI `describe-file-systems`確認できます。
## フォルダにハードクォータを設定する
この例では、ユーザーが「department」フォルダに 10 GB 以上を保存できないようにハードクォータを作成する方法を示します。
**フォルダにクォータを設定するには:**
1. 10 GB の制限でハードクォータを作成します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMQuota -Folder "share\department" -Size 10GB -Description "10 GB hard limit for department folder"
}
```
1. (オプション) クォータを変更して、使用量が 85% のしきい値通知を追加します。
```
$thresholds = [System.Collections.ArrayList]@()
$threshold = @{
ThresholdPercentage = 85
Action = @(
@{
ActionType = "Event"
EventType = "Warning"
MessageBody = "Department folder has reached 85% of quota limit"
}
)
}
$null = $thresholds.Add($threshold)
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList ($thresholds) -ScriptBlock {
param($thresholds)
Set-FSxFSRMQuota -Folder "share\department" -ThresholdConfigurations $Using:thresholds
}
```
1. クォータが作成されたことを確認します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMQuota -Folder "share\department"
}
```
## ファイルグループを使用した特定のファイルタイプの制限
この例では、デフォルトの`Audio and Video Files`「」ファイルグループを使用して、ユーザーがオーディオファイルとビデオファイルをビジネスドキュメントフォルダに保存することをブロックする方法を示します。
**ファイルグループを使用してファイルタイプを制限するには:**
1. オーディオファイルとビデオファイルをブロックするアクティブなファイル画面を作成します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMFileScreen -Folder "share\business-documents" -IncludeGroup "Audio and Video Files" -Description "Block media files in business documents folder"
}
```
1. (オプション) ファイル画面を更新して、ユーザーがブロックされたファイルを保存しようとしたときに通知を追加します。
```
$notifications = [System.Collections.ArrayList]@()
$eventNotification = @{
ActionType = "Event"
EventType = "Warning"
MessageBody = "User attempted to save blocked media file"
}
$null = $notifications.Add($eventNotification)
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList $notifications -ScriptBlock {
param($notifications)
Set-FSxFSRMFileScreen -Folder "share\business-documents" -NotificationConfigurations $Using:notifications
}
```
1. ファイル画面が作成されていることを確認します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMFileScreen -Folder "share\business-documents"
}
```
## PII データの特定と分類
この例では、社会保障番号を含むファイルを自動的に識別し、個人を特定できる情報 (PII) を含むものとして分類する方法を示します。
**PII データを識別して分類するには:**
1. PII の分類プロパティを作成します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMClassificationPropertyDefinition -Name "ContainsPII" -Type OrderedList -PossibleValueConfigurations @(
@{ Name = "Yes" },
@{ Name = "No" })
}
```
1. 社会保障番号を検出する分類ルールを作成します。
**注記**
次の正規表現は、パターン XXX-XX-XXXX のテキストを検索します。本番稼働用には、より高度なパターンを使用するか、複数の検出方法を組み合わせることを検討してください。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMClassificationRule -Name "Detect_SSN" -Property "ContainsPII" -PropertyValue "Yes" -Namespace "share" -ClassificationMechanism "Content Classifier" -ContentRegularExpression "\b\d{3}-\d{2}-\d{4}\b"
}
```
1. 実行分類:
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Start-FSxFSRMClassification
}
```
1. (オプション) 新しいファイルを自動的に分類するように連続分類を設定します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Set-FSxFSRMClassification -Continuous $true
}
```
1. ステータスを確認します (1 は完了を意味します）。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMClassification
}
```
1. 分類が完了したら、Windows File Explorer でファイルを右クリックし、プロパティを選択し、分類タブを選択することで、ファイルに割り当てられた**分類****プロパティ**を表示できます。このタブには、ファイルのすべての分類プロパティとその値が表示されます。
## ファイルの保持ポリシーの作成
この例では、フォルダの場所に基づいて保持期間でファイルを分類する方法を示します。このファイルは、クライアント側の PowerShell スクリプトで使用して、ファイルをアーカイブまたは削除できます。
**ファイルの保持ポリシーを作成するには:**
1. 保持期間の分類プロパティを作成します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMClassificationPropertyDefinition -Name "RetentionPeriod" -Type String -Description "File retention period"
}
```
1. さまざまな保持期間の分類ルールを作成します。
+ 法的文書フォルダ内の**法的文書の** 7 年間の保持:
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMClassificationRule -Name "Legal_7Year" -Property "RetentionPeriod" -PropertyValue "7 years" -Namespace "share/Legal Documents" -ClassificationMechanism "Folder Classifier"
}
```
+ **Finance** フォルダの財務記録の 3 年間の保持:
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxFSRMClassificationRule -Name "Finance_3Year" -Property "RetentionPeriod" -PropertyValue "3 years" -Namespace "share/Finance" -ClassificationMechanism "Folder Classifier"
}
```
ファイルコンテンツで分類し、「保持期間 7 年」などの文字列を検索することもできます。これを実現するには、 `ClassificationMechanism "Content Classifier"`と を使用します`ContentString "Retention seven years"`。
1. 分類を実行して保持プロパティを適用します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Start-FSxFSRMClassification
}
```
1. (オプション) 新しいファイルを自動的に分類するように連続分類を設定します。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Set-FSxFSRMClassification -Continuous $true
}
```
1. ステータスを確認します (1 は完了を意味します）。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMClassification
}
```
1. 分類が完了したら、Windows File Explorer でファイルを右クリックし、プロパティを選択し、分類タブを選択することで、ファイルに割り当てられた**分類****プロパティ**を表示できます。このタブには、ファイルのすべての分類プロパティとその値が表示されます。
1. ファイルが保持期間で分類されたら、クライアント側の PowerShell スクリプトを使用して、`RetentionPeriod`プロパティと経過時間に基づいてファイルをアーカイブまたは削除できます。たとえば、ファイルシステムをスキャンして、ファイルの経過時間と保持期間の分類を比較できます。詳細については、「[ファイル管理タスク](fsrm-file-management.md)」を参照してください。
## 一般的なストレージレポートの設定
このセクションでは、一般的に使用される 2 つのストレージレポートを作成する方法を示します。1 つは大きなファイルレポートで、もう 1 つは所有者別レポートです。
### 大きなファイルレポート
この例では、200 MB を超えるファイルを識別する月次レポートを作成します。
**大きなファイルレポートを作成するには:**
1. スケジュールされた大きなファイルレポートを作成します。
```
$schedule = @{
Time = "2:00 AM"
Monthly = @(1) # Run on the 1st of each month
}
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList $schedule -ScriptBlock {
param($schedule)
New-FSxFSRMStorageReport -Name "Monthly Large Files Report" -Namespace "share" -ReportType "LargeFiles" -LargeFileMinimum 200MB -ReportFormat "HTML","CSV" -ScheduleConfigurations $schedule
}
```
1. (オプション) レポートをすぐに実行してテストします。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Start-FSxFSRMStorageReport -Name "Monthly Large Files Report"
}
```
### 所有者別ファイルレポート
この例では、ユーザーごとのストレージ消費量を示す週次レポートを作成します。
**所有者レポートでファイルを作成するには:**
1. 所有者レポートでスケジュールされたファイルを作成します。
```
$schedule = @{
Time = "3:00 AM"
Weekly = @('Sunday')
}
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList $schedule -ScriptBlock {
param($schedule)
New-FSxFSRMStorageReport -Name "Weekly Files by Owner Report" -Namespace "share" -ReportType "FilesByOwner" -ReportFormat "HTML","CSV" -ScheduleConfigurations $schedule
}
```
1. (オプション) レポートをすぐに実行してテストします。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Start-FSxFSRMStorageReport -Name "Weekly Files by Owner Report"
}
```
生成されたレポートにアクセスするには、管理 D\$1 共有をマッピングします。詳細については、「[ストレージレポートへのアクセス](fsrm-storage-reports.md#fsrm-storage-reports-accessing)」を参照してください。
# FSx for Windows File Server でのストレージの管理
ファイルシステムのストレージ設定には、プロビジョニングされたストレージ容量、ストレージタイプ、ストレージタイプがソリッドステートドライブ (SSD) の場合は SSD IOPS の量が含まれます。ファイルシステムの作成中および作成後に、これらのリソースをスループットキャパシティとともに設定して、ワークロードに望ましいパフォーマンスを達成できます。および PowerShell でのリモート管理用の Amazon FSx CLI を使用して AWS マネジメントコンソール AWS CLI、ファイルシステムのストレージとストレージ関連のパフォーマンスを管理する方法について説明します。
**Topics**
+ [ストレージコストの最適化](#optimize-storage-costs)
+ [ストレージ容量の管理](#managing-storage-capacity)
+ [ファイルシステムのストレージタイプの管理](#managing-storage-type)
+ [SSD IOPS の管理](#managing-provisioned-ssd-iops)
+ [データ重複排除によるストレージコストの削減](#using-data-dedup)
+ [ストレージクォータの管理](managing-user-quotas.md)
+ [ファイルシステムのストレージ容量の増加](increase-storage-capacity.md)
+ [ストレージ容量の拡張をモニタリングする](monitoring-storage-capacity-increase.md)
+ [FSx for Windows ファイルサーバーファイルシステムのストレージ容量の動的な拡張](automate-storage-capacity-increase.md)
+ [FSx for Windows ファイルシステムのストレージタイプの更新](updating-storage-type.md)
+ [ストレージタイプの更新をモニタリング](monitoring-storage-type-updates.md)
+ [ファイルシステムの SSD IOPS の更新](how-to-provision-ssd-iops.md)
+ [プロビジョニングされた SSD IOPS 更新のモニタリング](monitoring-provisioned-ssd-iops.md)
+ [データ重複除外の管理](managing-data-dedup.md)
+ [データ重複排除のトラブルシューティング](data-dedup-ts.md)
## ストレージコストの最適化
FSx for Windows で使用できるストレージ設定オプションを使用して、ストレージコストを最適化できます。
**ストレージタイプオプション** - FSx for Windows ファイルサーバーは、ハードディスクドライブ (HDD) およびソリッドステートドライブ (SSD) の 2 種類のストレージを用意しており、お客様のワークロードのニーズに合わせてコストおよびパフォーマンスを最適化することができます。HDD ストレージは、ホームディレクトリ、ユーザーおよび部門の共有、コンテンツ管理システムなど、幅広いワークロード向けに設計されています。SSD ストレージは、データベース、メディア処理ワークロード、データ分析アプリケーションなど、最もパフォーマンスが高く、レイテンシーの影響を受けやすいワークロード向けに設計されています。ストレージタイプとファイルシステムのパフォーマンスに関する詳細については、「[FSx for Windows File Server のパフォーマンスパフォーマンス](performance.md)」を参照してください。
**データの重複排除** - 大規模なデータセットには冗長データが含まれていることが多く、データストレージのコストが増加します。例えば、ユーザーのファイル共有には、複数のユーザーによって保存された同じファイルのコピーが複数存在する場合があります。ソフトウェア開発共有には、ビルドごとに変更されないままの多くのバイナリを含めることができます。ファイルシステムの *データ重複排除* を有効にすることで、データストレージのコストを削減することができます。重複排除機能を有効にすると、データセットの重複した部分を一度だけ保存することで、冗長データを自動的に削減または排除します。データ重複排除の詳細、および Amazon FSx ファイルシステムで簡単にそれを有効にする方法については、「[データ重複排除によるストレージコストの削減](#using-data-dedup)」を参照してください。
## ストレージ容量の管理
ストレージ要件の変化に応じて、FSx for Windows ファイルシステムのストレージ容量を増やすことができます。これを行うには、Amazon FSx コンソール、Amazon FSx API、または AWS Command Line Interface (AWS CLI) を使用します。ストレージ容量の増加を計画する際に考慮すべき要因には、ストレージ容量を増やす必要があるタイミングを把握すること、Amazon FSx がストレージ容量の増加を処理する方法を理解すること、ストレージの増加リクエストの進行状況を追跡することなどがあります。ファイルシステムのストレージ容量は増加のみが可能で、ストレージ容量を減らすことはできません。
**注記**
2019 年 6 月 23 日より前に作成されたファイルシステムや、2019 年 6 月 23 日より前に作成されたファイルシステムに属するバックアップから復元されたファイルシステムでは、ストレージ容量を増やすことはできません。
Amazon FSx ファイルシステムのストレージ容量を増やすと、Amazon FSx は裏でファイルシステムに新しい大きなディスクセットを追加します。その後、Amazon FSx は、ストレージ最適化プロセスをバックグラウンドで実行し、古いディスクから新しいディスクにデータを透過的に移行します。ストレージタイプとその他の要因によってストレージの最適化には数時間から数日かかることがありますが、ワークロードのパフォーマンスに及ぼす影響は最小限です。この最適化では、古いストレージボリュームと新しいストレージボリュームの両方がファイルシステムレベルのバックアップに含まれるため、バックアップの使用量が一時的に高くなります。両方のストレージボリュームのセットが含まれているので、ストレージの拡張作業中にも Amazon FSx がバックアップを正常に取得して復元することができます。以前のストレージボリュームがバックアップ履歴に含まれていない場合、バックアップの使用量は、以前のベースラインレベルに戻ります。新しいストレージ容量が利用可能になると、新しいストレージ容量に対してのみ請求されます。
次の図は、Amazon FSx がファイルシステムのストレージ容量を増やすときに使用するプロセスの、4 つの主要ステップを示しています。
![\[ストレージスケーリングプロセスの 4 つのステップを示す図。\]](http://docs.aws.amazon.com/ja_jp/fsx/latest/WindowsGuide/images/storage-scaling-flow.png)
Amazon FSx コンソール、CLI、または API を使用して、ストレージ最適化、SSD ストレージ容量の増加、SSD IOPS の更新の進捗状況をいつでも追跡できます。詳細については、「[ストレージ容量の拡張をモニタリングする](monitoring-storage-capacity-increase.md)」を参照してください。
### ファイルシステムのストレージ容量を増やす方法について知っておくべきこと
ストレージ容量を増やすときに考慮すべき重要な事項をいくつか挙げます:
+ **増加のみ** - ファイルシステムのストレージ容量は*増加*することのみ可能で、ストレージ容量は減らせません。
+ **増加最小値** - 各ストレージ容量の増加は、ファイルシステムの現在のストレージ容量の最低 10% で、最大許容値 65,536 GiB までである必要があります。
+ **最小スループットキャパシティ** - ストレージ容量を増やすには、ファイルシステムの最小スループットキャパシティが 16 MBps である必要があります。これは、ストレージの最適化ステップがスループットを大量に消費するプロセスであるためです。
+ **拡張するまでの時間** - 最後の拡張がリクエストされてから 6 時間経過するか、ストレージの最適化プロセスが完了するか、どちらが長い方は終わるまでは、ファイルシステムのストレージ容量をさらに増やすことはできません。ストレージの最適化には数時間から数日かかります。ストレージの最適化が完了するまでの時間を最小限に抑えるには、ストレージ容量を増やす前にファイルシステムのスループットキャパシティを増やし (ストレージのスケーリング完了後にスループットキャパシティは元に戻せます)、ファイルシステムのトラフィックが最小である場合はストレージ容量を増やすことをお勧めします。
**注記**
特定のファイルシステムイベントは、次の例のように、ディスク I/O のパフォーマンスリソースを消費する可能性があります:
ストレージ容量のスケーリングの最適化フェーズでは、ディスクスループットが向上し、パフォーマンス警告が発生する可能性があります。詳細については、「[パフォーマンスの警告と推奨事項](monitoring-cloudwatch.md#performance-insights-FSxW)」を参照してください。
### ストレージ容量を増やすタイミングを知る
空きストレージ容量が不足している場合は、ファイルシステムのストレージ容量を増やします。`FreeStorageCapacity` CloudWatch メトリクスを使用して、ファイルシステム上で利用可能な空きストレージ容量をモニタリングします。このメトリクスで Amazon CloudWatch アラームを作成し、特定のしきい値を下回ったときに通知を受け取ることができます。詳細については、「[Amazon CloudWatch を使用したモニタリング](monitoring-cloudwatch.md)」を参照してください。
ファイルシステム上で常に 20% 以上の空きストレージ容量を維持することをお勧めします。ストレージ容量をすべて使用するとパフォーマンスに悪影響が生じ、データの不整合が生じる可能性があります。
空きストレージ容量が定義済みしきい値を下回った際にファイルシステムのストレージ容量を自動的に増やすことができます。 AWS開発済みのカスタム CloudFormation テンプレートを使用して、自動化ソリューションの実装に必要なすべてのコンポーネントをデプロイします。詳細については、「[ストレージ容量を動的に増やす](automate-storage-capacity-increase.md)」を参照してください。
### ストレージ容量の拡張とファイルシステムのパフォーマンス
ほとんどのワークロードでは、パフォーマンスへの影響は最小限に抑えられますが、Amazon FSx は新しいストレージ容量が利用可能になった後、バックグラウンドでストレージ最適化プロセスを実行します。ただし、HDD ストレージタイプを持つファイルシステムや、多数のエンドユーザー、高レベルの I/O、または多数の小さなファイルを持つデータセットを含むワークロードでは、一時的にパフォーマンスが低下する可能性があります。このような場合には、ストレージ容量を増やす前に、まずファイルシステムのスループットキャパシティを増やすことをお勧めします。これらのタイプのワークロードでは、ファイルシステムの負荷が最小限であるアイドル期間中におけるスループットキャパシティの変更も推奨します。これにより、アプリケーションのパフォーマンスニーズを満たすために、同じレベルのスループットを提供し続けることができます。詳細については、「[スループット容量の管理](managing-throughput-capacity.md)」を参照してください。
## ファイルシステムのストレージタイプの管理
ファイルシステムのストレージタイプは、 AWS マネジメントコンソール と を使用して HDD から SSD に変更できます AWS CLI。ストレージタイプを SSD に変更する場合、最後の更新がリクエストされてから 6 時間後、またはストレージ最適化プロセスが完了するまでのどちらか長い方までは、ファイルシステム構成を再び更新できないことに注意してください。ストレージの最適化には数時間から数日かかります。この時間を最小限に抑えるために、ファイルシステムのトラフィックが最小のときにストレージタイプを更新することをお勧めします。詳細については、「[FSx for Windows ファイルシステムのストレージタイプの更新](updating-storage-type.md)」を参照してください。
ファイルシステムのストレージタイプは SSD から HDD には変更できません。ファイルシステムのストレージタイプを SSD から HDD に変更する場合は、HDD ストレージを使用するように設定した新しいファイルシステムにファイルシステムのバックアップを復元する必要があります。詳細については、「[新しいファイルシステムへのバックアップの復元](using-backups.md#restoring-backups)」を参照してください。
### ストレージタイプについて
FSx for Windows File Server ファイルシステムは、ソリッドステートドライブ (SSD) または磁気ハードディスクドライブ (HDD) ストレージタイプを使用するように設定できます。
**SSD ストレージ**は、高いパフォーマンス要件とレイシンシーセンシティブを持つほとんどのプロダクション ワークロードに適します。これらのワークロードの例には、データベース、データ分析、メディア処理、ビジネスアプリケーションなどがあります。また、多数のエンドユーザー、高レベルの I/O、またはデータセットに多数の小さなファイルが含まれるユースケースには、SSD をお勧めします。最後に、シャドウコピーを有効にする場合は SSD ストレージの使用をお勧めします。SSD ストレージを使用するファイルシステムの SSD IOPS は構成およびスケールできますが、HDD ストレージでは構成およびスケールできません。
**HDD ストレージ**は、ホームディレクトリ、ユーザーおよび部門のファイル共有、コンテンツ管理システムなど、幅広いワークロードに対応するように設計されています。HDD ストレージは SSD ストレージに比べて低コストですが、レイテンシーが高く、ストレージ単位あたりのディスクスループットとディスク IOPS のレベルが低くなります。I/O 要件の低い汎用のユーザー共有やホームディレクトリ、データの取得頻度が低い大規模なコンテンツ管理システム (CMS)、またはサイズの大きいファイルの数が少ないデータセットに適する場合があります。
詳細については、「[ストレージ構成とパフォーマンス](performance.md#storage-capacity-and-performance)」を参照してください。
## SSD IOPS の管理
SSD ストレージで設定されたファイルシステムの場合、SSD IOPS の量は、キャッシュにあるデータではなく、ファイルシステムがディスクとの間でデータを読み取り、ディスクにデータを書き込む必要があるときに使用可能なディスク I/O の量を決定します。ストレージ容量とは別に SSD IOPS の量を選択してスケーリングできます。プロビジョニングできる最大 SSD IOPS は、ファイルシステムに選択したストレージ容量とスループットキャパシティによって異なります。SSD IOPS をスループットキャパシティでサポートされる制限を超えて増やそうとすると、その SSD IOPS のレベルに達するようにスループットキャパシティを増やす必要が生じる場合があります。詳細については、「[FSx for Windows File Server のパフォーマンスパフォーマンス](performance.md)」および「[スループット容量の管理](managing-throughput-capacity.md)」を参照してください。
ファイルシステムのプロビジョニングされた SSD IOPS の更新について知っておくべき重要な項目を以下に示します:
+ IOPS モードの選択 – 次の 2 つの IOPS モードから選択できます:
+ **[自動]** - このモードと Amazon FSx を選択すると、SSD IOPS を自動的にスケーリングして、ストレージ容量の GiB ごとに 3 つの SSD IOPS、ファイルシステムごとに最大 400,000 SSD IOPS を維持します。
+ **[ユーザープロビジョニング]** — このモードを選択すると、SSD IOPS の数を 96 ～ 400,000 の範囲で指定できます。 AWS リージョン Amazon FSx が利用可能なすべての のストレージ容量 1 GiB あたり 3～50 IOPS、または米国東部 (バージニア北部）、米国西部 (オレゴン）、米国東部 (オハイオ）、欧州 (アイルランド）、アジアパシフィック (東京）、アジアパシフィック (シンガポール) のストレージ容量 1 GiB あたり 3～500 IOPS の数を指定します。ユーザープロビジョンドモードを選択すると、指定した SSD IOPS の量が GiB あたり少なくとも 3 IOPS でない場合、リクエストは失敗します。プロビジョニングされた SSD IOPS のレベルが高い場合は、ファイルシステムごとに GiB あたり 3 IOPS を超える平均 IOPS に対して料金が発生します。
+ **ストレージ容量の更新** – ファイルシステムのストレージ容量を増やし、デフォルトで現在のユーザープロビジョニング SSD IOPS レベルを超える SSD IOPS 量を必要とする場合、Amazon FSx はファイルシステムを自動的に自動モードに切り替え、ファイルシステムにはストレージ容量の GiB あたり少なくとも 3 つの SSD IOPS があります。
+ **スループットキャパシティの更新** – スループットキャパシティを増やし、新しいスループット容量でサポートされる最大 SSD IOPS がユーザープロビジョニングの SSD IOPS レベルよりも高い場合、Amazon FSx は自動的にファイルシステムを自動モードに切り替えます。
+ **SSD IOPS 増加の時間間隔** – 最後に増加がリクエストされてから 6 時間後まで、またはストレージの最適化プロセスが完了するまでのどちらか長い期間は、SSD IOPS の増加も、スループットキャパシティの増加も、ファイルシステム上のストレージタイプの更新も、さらに行うことはできません。ストレージの最適化には数時間から数日かかります。ストレージの最適化が完了するまでの時間を最小限に抑えるために、ファイルシステムのトラフィックが最小限のときに SSD IOPS をスケーリングすることをお勧めします。
**注記**
4,608 MBps 以上のスループットキャパシティレベルは、 AWS リージョン米国東部 (バージニア北部）、米国西部 (オレゴン）、米国東部 (オハイオ）、欧州 (アイルランド）、アジアパシフィック (東京）、アジアパシフィック (シンガポール) でのみサポートされることに注意してください。
FSx for Windows File Server ファイルシステムのプロビジョニングされた SSD IOPS の量を更新する方法の詳細については、「[ファイルシステムの SSD IOPS の更新](how-to-provision-ssd-iops.md)」を参照してください。
## データ重複排除によるストレージコストの削減
データ重複排除は、Dedup for Short とも呼ばれ、ストレージ管理者が重複データに関連するコストを削減するのに役立ちます。FSx for Windows File Server を使用すると、Microsoft Data Deduplication を使用して冗長データを特定して排除できます。大規模なデータセットは冗長なデータを持つことが多く、データストレージのコストが増加します。例えば、次のようになります。
+ ユーザーファイル共有には、同じファイルまたは同様のファイルのコピーが多数ある場合があります。
+ ソフトウェア開発共有には、ビルドごとに変更されないままの多くのバイナリを含めることができます。
ファイルシステムのデータ重複排除を有効にすることで、データストレージのコストを削減できます。*データ重複除外* はデータセットの重複した部分を 1 回のみ保存することで、冗長データを削減または排除します。データ重複除外を有効にすると、重複除外後のデータ圧縮がデフォルトで有効になり、さらに節約ができます。重複排除は、データの忠実度や整合性を損なうことなく冗長性を最適化します。データ重複除外は、ファイルシステムを継続的に自動的にスキャンして最適化するバックグラウンドプロセスとして実行され、ユーザーや接続されたクライアントに対して透過的に実行されます。
データ重複除外によって達成できるストレージの節約は、ファイル間で重複する量など、データセットの性質によって異なります。一般的な汎用ファイル共有では、平均 50～60% 削減されます。共有内では、ユーザードキュメントの 30～50% からソフトウェア開発データセットの 70～80% が節約範囲です。重複除外による節約の可能性を測定するには、以下に説明する `Measure-FSxDedupFileMetadata` リモート PowerShell コマンドを使用します。
また、特定のストレージニーズに合わせてデータ重複除外をカスタマイズすることもできます。例えば、特定のファイルタイプでのみ実行するように重複除外を設定したり、カスタムジョブスケジュールを作成したりできます。重複除外ジョブはファイルサーバリソースを消費することがあるため、`Get-FSxDedupStatus` を使用して重複除外ジョブのステータスをモニタリングすることをお勧めします。
ファイルシステムでのデータ重複排除の設定については、「[データ重複除外の管理](managing-data-dedup.md)」を参照してください。
データ重複排除に関連する問題の解決については、「[ データ重複排除のトラブルシューティング FSx for Windows File Server ファイルシステムでデータ重複排除を使用する際に発生する問題を特定し、解決する方法について説明します。 データ重複除外メモリ不足powershell 以下の情報を使用して、データ重複排除を設定および使用する際の一般的な問題のトラブルシューティングにお役立てください。 データ重複排除が機能していない データ重複排除の現在のステータスを確認するには、`Get-FSxDedupStatus` PowerShell コマンドを実行し、最新の重複排除ジョブの完了ステータスを表示します。1 つ以上のジョブが失敗している場合、ファイルシステム上で空きストレージ容量の増加が見られない場合があります。 重複排除ジョブが失敗する最も一般的な理由は、メモリ不足です。 Microsoft は、1 TB の論理的なデータあたり 1 GB のメモリが最適にあることを[推奨](https://docs.microsoft.com/en-us/windows-server/storage/data-deduplication/install-enable#faq)します (または、1 TB の論理的なデータあたり少なくとも 350 MB)。[Amazon FSx パフォーマンステーブル](performance.md#performance-table) を使用して、ファイルシステムのスループットキャパシティに関連付けられているメモリを特定し、メモリリソースがデータのサイズに対して十分であることを確認します。そうでない場合は、[ファイルシステムのスループットキャパシティを、論理データの 1 TB あたり 1 GB のメモリ要件を満たすレベルまで増やす](managing-throughput-capacity.md)必要があります。 重複排除ジョブは、Windows が推奨するデフォルトの 25％ のメモリ割り当てで設定されます。つまり、32 GB のメモリを備えたファイルシステムの場合、8 GB が重複排除に使用できます。メモリ割り当ては設定可能です (パラメータ `–Memory` で `Set-FSxDedupSchedule` コマンドを使用します)。重複排除にメモリ割り当てを増やすと、ファイルシステムのパフォーマンスに影響する可能性があることに注意してください。 重複排除のジョブの設定を変更して、必要なメモリ量を削減できます。例えば、特定のファイルタイプまたはフォルダーで実行するように最適化を制限したり、最適化のための最小ファイルサイズと経過時間を設定したりできます。また、ファイルシステムのロードが最小限であるアイドル期間中に重複排除ジョブが実行されるように設定することをお勧めします。 重複排除ジョブを完了するのに十分な時間がない場合にも、エラーが表示されることがあります。[データ重複除外スケジュールの変更](managing-data-dedup.md#set-dedup-sched) で説明されているように、ジョブの最大期間を変更する必要がある場合があります。 重複排除ジョブが長期間失敗していて、この期間中にファイルシステム上のデータに変更があった場合、後続の重複排除ジョブを初めて正常に完了するには、より多くのリソースが必要になる場合があります。 重複排除の値が予期せず 0 に設定されている データ重複排除を設定したファイルシステムでは、`SavedSpace` と `OptimizedFilesSavingsRate` の値が予期せず 0 になります。 これは、ファイルシステムのストレージ容量を増やす際、ストレージ最適化プロセス中に発生する可能性があります。ファイルシステムのストレージ容量を増やすと、Amazon FSx は、ストレージ最適化プロセス中に既存のデータ重複排除ジョブをキャンセルします。これにより、以前のディスクから新しくより大きなディスクにデータが移行されます。ストレージ最適化ジョブが完了すると、Amazon FSx はファイルシステムでのデータ重複排除を再開します。ストレージ容量の増加とストレージの最適化の詳細については、「[ストレージ容量の管理](managing-storage-configuration.md#managing-storage-capacity)」を参照してください。 ファイルを削除した後、ファイルシステムのスペースが解放されません データ重複排除の予想される動作は、重複排除がスペースを節約したデータが削除されたデータであった場合、ガベージコレクションのジョブが実行されるまでファイルシステムでスペースは解放されません。 役立つと思われるプラクティスとして、多数のファイルを削除した直後にガベージコレクションのジョブを実行するようにスケジュールを設定することができます。ガベージコレクションのジョブが終了したら、ガベージコレクションのスケジュールを元の設定に戻すことができます。これにより、削除により解放された容量をすぐに確認できます。 次の手順を使用して、ガベージコレクションジョブを 5 分で実行するように設定します。 データ重複排除が有効になっていることを確認するには、`Get-FSxDedupStatus` コマンドを使用します。コマンドとその期待される出力の詳細については、「[保存スペースの量の表示](managing-data-dedup.md#get-dedup-status)」を参照してください。 以下を使用して、5 分後にガベージコレクションのジョブを実行するスケジュールを設定します。
```
$FiveMinutesFromNowUTC = ((get-date).AddMinutes(5)).ToUniversalTime()
$DayOfWeek = $FiveMinutesFromNowUTC.DayOfWeek
$Time = $FiveMinutesFromNowUTC.ToString("HH:mm")
Invoke-Command -ComputerName ${RPS_ENDPOINT} -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Set-FSxDedupSchedule -Name "WeeklyGarbageCollection" -Days $Using:DayOfWeek -Start $Using:Time -DurationHours 9
}
``` ガベージコレクションのジョブが実行され、スペースが解放されたら、スケジュールを元の設定に戻します。 ](data-dedup-ts.md#data-dedup-ts.title)」を参照してください。
データ重複除外の詳細については、Microsoft の「[データ重複除外について](https://docs.microsoft.com/en-us/windows-server/storage/data-deduplication/understand)」ドキュメントを参照してください。
**警告**
特定の Robocopy コマンドをデータ重複除外で実行することは推奨されません。これらのコマンドはチャンクストアのデータ整合性に影響を与える可能性があるためです。詳細については、Microsoft の[データ重複除外の相互運用性](https://docs.microsoft.com/en-us/windows-server/storage/data-deduplication/interop)に関するドキュメントを参照してください。
### データ重複排除を使用する際のベストプラクティス
ここでは、Data Deduplication を使用するためのいくつかのベストプラクティスを以下に示します:
+ **ファイルシステムがアイドル状態のときに実行するように Data Deduplication ジョブをスケジュールする**: デフォルトのスケジュールには、毎週土曜日の 2:45 UTC に実行される `GarbageCollection` ジョブが含まれています。ファイルシステムで大量のデータが流出している場合、完了するまでに数時間かかることがあります。この時間がワークロードにとって理想的でない場合は、ファイルシステムのトラフィックが少ないと予想される時間にこのジョブを実行するようにスケジュールします。
+ **Data Deduplication を完了するのに十分なスループットキャパシティを設定する**: スループットキャパシティが大きいほど、メモリのレベルが高くなります。Microsoft では、Data Deduplication を実行するには、論理データの 1 TB あたり 1 GB のメモリを用意することを推奨します。[Amazon FSx パフォーマンステーブル](performance.md#impact-throughput-cap-performance)を使用して、ファイルシステムのスループットキャパシティに関連付けられているメモリを特定し、メモリリソースがデータのサイズに対して十分であることを確認します。
+ **Data Deduplication の設定をカスタマイズして、特定のストレージのニーズを満たし、パフォーマンス要件を緩和する**: 特定のファイルタイプまたはフォルダーで実行するように最適化を制限したり、最適化のための最小ファイルサイズと経過時間を設定したりできます。詳細については[データ重複排除によるストレージコストの削減](#using-data-dedup)を参照してください。
# ストレージクォータの管理
ファイルシステム上でユーザーストレージクォータを設定して、ユーザーが消費できるデータストレージの量を制限できます。クォータを設定した後、クォータの状態を追跡して使用状況をモニタリングし、ユーザーがクォータを上回るタイミングを確認できます。
また、クォータに達したユーザーがストレージに書き込むのを停止して、クォータを強制することもできます。クォータを強制すると、クォータを超えるユーザーに「ディスク容量が不十分です」というエラーメッセージが表示されます。
クォータ設定には、次のしきい値を設定できます:
+ 警告 – ユーザーまたはグループがクォータ制限に近づいているかどうかを追跡するなど、追跡関連にのみ使用されます。
+ 制限 – ユーザーまたはグループのストレージクォータ制限。
ファイルシステムにアクセスする新しいユーザーに適用されるデフォルトのクォータと、特定のユーザーまたはグループに適用されるクォータを設定できます。また、各ユーザーまたはグループが消費しているストレージの量、およびクォータを超えているかどうかについてのレポートを表示することもできます。
ユーザーレベルでのストレージ消費は、ファイルの所有権に基づいて追跡されます。ストレージ消費量は、ファイルが占める実際の物理ストレージ領域ではなく、論理的なファイルサイズを使用して計算されます。ユーザーストレージクォータは、データがファイルに書き込まれる時点で追跡されます。
複数のユーザーのクォータを更新するには、各ユーザーに対して更新コマンドを 1 回実行するか、ユーザーをグループに編成してそのグループのクォータを更新する必要があります。
PowerShell でのリモート管理の Amazon FSx CLI を使用して、ファイルシステム上のユーザーストレージクォータを管理できます。この CLI を使用する方法については、「[PowerShell での Amazon FSx CLI の使用](administering-file-systems.md#remote-pwrshell)」を参照してください。
ユーザーストレージクォータを管理するために使用できるコマンドは次のとおりです。
| ユーザーストレージクォータコマンド | 説明 |
| --- | --- |
| **Enable-FSxUserQuotas** | ユーザーストレージクォータの追跡または強制、またはその両方を開始します。 |
| **Disable-FSxUserQuotas** | ユーザーストレージクォータの追跡と強制を停止します。 |
| **Get-FSxUserQuotaSettings** | ファイルシステムの現在のユーザーストレージクォータ設定を取得します。 |
| **Get-FSxUserQuotaEntries** | ファイルシステム上の個々のユーザーおよびグループの現在のユーザーストレージクォータエントリを取得します。 |
| **Set-FSxUserQuotas** | 個々のユーザーまたはグループのユーザーストレージクォータを設定します。クォータ値はバイト単位で指定します。 |
各コマンドのオンラインヘルプには、すべてのコマンドオプションのリファレンスが記載されています。このヘルプにアクセスするには、**-?** (例えば、**Enable-FSxUserQuotas -?**) コマンドを実行します。
# ファイルシステムのストレージ容量の増加
ストレージ要件の変更に応じて、FSx for Windows File Server ファイルシステムのストレージ容量を増やせます。次の手順で説明するように、Amazon FSx コンソール AWS CLI、、または Amazon FSx API を使用して、ファイルシステムのストレージ容量を増やします。詳細については、「[ストレージ容量の管理](managing-storage-configuration.md#managing-storage-capacity)」を参照してください。
## ファイルシステムのストレージ容量を増やすには (コンソール)
1. [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/) で Amazon FSx コンソールを開きます。
1. **[File systems]** (ファイルシステム) に移動して、ストレージ容量を増やしたい Windows ファイルシステムを選択します。
1. **[Action]** (アクション) で **[Update storage]** (ストレージの更新) を選択します。または **[Summary]** (概要) パネルで、ファイルシステムの **[Storage capacity]** (ストレージ容量) の横にある **[Update]** (更新) を選択します。
**[Update storage capacity]** (ストレージ容量の更新) ウィンドウが表示されます。
1. **[Input type]** (入力タイプ) には、**[Percentage]** (割合) を選択して現在値からの変化率として新しいストレージ容量を入力するか、**[Absolute]** (絶対) を選択して新しい値を GiB 単位で入力します。
1. **希望するストレージ容量** を入力します。
**注記**
希望する容量値は、現在値よりも最低 10% 以上である必要があり、最大 65,536 GiB まで可能です。
1. **[Update]** (更新) を選択して、ストレージ容量の更新を開始します。
1. **[Update]** (更新)タブの **ファイルシステム** 詳細ページで、更新の進捗状況をモニタリングすることができます。
## ファイルシステムのストレージ容量を増やすには (CLI)
FSx for Windows ファイルサーバーファイルシステムのストレージ容量を増やすには、 AWS CLI コマンド [update-file-system](https://docs.aws.amazon.com/cli/latest/reference/fsx/update-file-system.html) を使用します。以下のパラメータを設定します:
+ 更新するファイルシステムの ID への `--file-system-id`。
+ 現在の値より少なくとも 10 パーセント大きい値への `--storage-capacity`。
AWS CLI コマンド [describe-file-systems](https://docs.aws.amazon.com/cli/latest/reference/fsx/describe-file-systems.html) を使用して、更新の進行状況をモニタリングできます。出力で `administrative-actions` を探します。
詳細については、「[AdministrativeAction](https://docs.aws.amazon.com/fsx/latest/APIReference/API_AdministrativeAction.html)」を参照してください。
# ストレージ容量の拡張をモニタリングする
ファイルシステムのストレージ容量を増やしたら、次の手順で説明 AWS CLI するように、Amazon FSx コンソール、 API、または を使用してストレージ容量の増加の進行状況をモニタリングできます。
## コンソールで拡張をモニタリングする
**File system details** (ファイルシステムの詳細) ウィンドウの **[Update]** (更新) タブでは、更新の種類ごとに最新の更新プログラムを 10 個表示できます。
ストレージ容量の更新については、次の情報を表示できます。
****更新タイプ****
可能な値は、**[ストレージ容量]** です。
****ターゲット値****
ファイルシステムのストレージ容量を更新する希望値です。
****ステータス****
更新の現在のステータス。ストレージ容量の更新では、指定できる値は次のとおりです。
+ **保留中** - Amazon FSx は更新リクエストを受信しましたが、処理を開始していません。
+ **進行中** - Amazon FSx が更新リクエストを処理しています。
+ **最適化の更新** - Amazon FSx により、ファイルシステムのストレージ容量が拡張しました。ストレージ最適化プロセスでは、ファイルシステムデータを新しい大きなディスクに移動しています。
+ **Completed** - ストレージ容量の拡張は正常に完了しました。
+ **失敗** - ストレージ容量の拡張に失敗しました。疑問符 (**?**) を選択し、ストレージの更新が失敗した理由の詳細を確認します。
****進行 %****
ストレージ最適化プロセスの進行状況を、完了率として表示します。
****リクエスト時間****
Amazon FSx が更新アクションリクエストを受信した時刻。
## AWS CLI と API によるモニタリングの増加
[describe-file-systems](https://docs.aws.amazon.com/cli/latest/reference/fsx/describe-file-systems.html) AWS CLI コマンドと [DescribeFileSystems](https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeFileSystems.html) API アクションを使用して、ファイルシステムのストレージ容量の増加リクエストを表示およびモニタリングできます。`AdministrativeActions` 配列には、管理アクションタイプごとに最新の更新アクションが 10 個表示されます。ファイルシステムのストレージ容量を増やすと、`FILE_SYSTEM_UPDATE` および `STORAGE_OPTIMIZATION` アクションの 2 つの `AdministrativeActions` が生成されます。
次の例は、**describe-file-systems** CLI コマンドのレスポンスの抜粋を示しています。ファイルシステムのストレージ容量は 300 GB で、ストレージ容量を 1000 GB に増やすための保留中の管理アクションがあります。
```
{
"FileSystems": [
{
"OwnerId": "111122223333",
.
.
.
"StorageCapacity": 300,
"AdministrativeActions": [
{
"AdministrativeActionType": "FILE_SYSTEM_UPDATE",
"RequestTime": 1581694764.757,
"Status": "PENDING",
"TargetFileSystemValues": {
"StorageCapacity": 1000
}
},
{
"AdministrativeActionType": "STORAGE_OPTIMIZATION",
"RequestTime": 1581694764.757,
"Status": "PENDING",
}
]
```
Amazon FSx はまず `FILE_SYSTEM_UPDATE` アクションを処理し、新しい大きなストレージディスクをファイルシステムに追加します。新しいストレージがファイルシステムで使用可能になると、`FILE_SYSTEM_UPDATE` ステータスが `UPDATED_OPTIMIZING` に変わります。ストレージ容量は新しい大きな値を示し、Amazon FSx は `STORAGE_OPTIMIZATION` 管理アクションの処理を開始します。これは、**describe-file-systems** CLI コマンドのレスポンスの次の抜粋を示しています。
`ProgressPercent` プロパティには、ストレージ最適化プロセスの進行状況が表示されます。ストレージ最適化プロセスが正常に完了すると、`FILE_SYSTEM_UPDATE` アクションが `COMPLETED` に変更され、`STORAGE_OPTIMIZATION` アクションは表示されなくなります。
```
{
"FileSystems": [
{
"OwnerId": "111122223333",
.
.
.
"StorageCapacity": 1000,
"AdministrativeActions": [
{
"AdministrativeActionType": "FILE_SYSTEM_UPDATE",
"RequestTime": 1581694764.757,
"Status": "UPDATED_OPTIMIZING",
"TargetFileSystemValues": {
"StorageCapacity": 1000
}
},
{
"AdministrativeActionType": "STORAGE_OPTIMIZATION",
"RequestTime": 1581694764.757,
"Status": "IN_PROGRESS",
"ProgressPercent": 50,
}
]
```
ストレージ容量の拡張に失敗した場合、`FILE_SYSTEM_UPDATE` アクションが `FAILED` に変更されます。`FailureDetails` プロパティは、次の例に示すように、障害に関する情報を提供します。
```
{
"FileSystems": [
{
"OwnerId": "111122223333",
.
.
.
"StorageCapacity": 300,
"AdministrativeActions": [
{
"AdministrativeActionType": "FILE_SYSTEM_UPDATE",
"FailureDetails": {
"Message": "string"
},
"RequestTime": 1581694764.757,
"Status": "FAILED",
"TargetFileSystemValues":
"StorageCapacity": 1000
}
]
```
失敗したアクションのトラブルシューティングについては、「[ストレージまたはスループットキャパシティの更新が失敗する](admin-actions-ts.md)」を参照してください。
# FSx for Windows ファイルサーバーファイルシステムのストレージ容量の動的な拡張
FSx for Windows File Server ファイルシステムのストレージ容量を手動で増やす代わりに、テンプレートを使用してストレージを自動的に CloudFormation 増やすことができます。このセクションのソリューションを使用すると、空きストレージ容量が指定したしきい値を下回った場合に、ファイルシステムのストレージ容量を動的に増やすことができます。
この AWS CloudFormation テンプレートは、空きストレージ容量のしきい値、このしきい値に基づく Amazon CloudWatch アラーム、ファイルシステムのストレージ容量を増やす AWS Lambda 関数を定義するために必要なすべてのコンポーネントを自動的にデプロイします。
このソリューションは以下のパラメータを使用します。
+ ファイルシステム ID
+ 空きストレージ容量のしきい値 (数値)
+ 測定単位 (パーセンテージ [デフォルト] または GiB)
+ ストレージ容量の増加率 (%)
+ SNS サブスクリプションの電子メールアドレス
+ アラームしきい値の調整 (はい / いいえ)
**Topics**
+ [アーキテクチャの概要](#storage-inc-architecture)
+ [CloudFormation テンプレート](#storage-capacity-CFN-template)
+ [を使用した自動デプロイ CloudFormation](#fsx-dynamic-storage-increase-deployment)
## アーキテクチャの概要
このソリューションをデプロイすると、 AWS クラウドに次のリソースが構築されます。
![\[FSx for Windows ファイルサーバーファイルシステムのストレージ容量を自動的に増やすソリューションのアーキテクチャ図表。\]](http://docs.aws.amazon.com/ja_jp/fsx/latest/WindowsGuide/images/auto-storage-increase-architecture.png)
この図表は以下のステップを示しています。
1. CloudFormation テンプレートは、CloudWatch アラーム、 AWS Lambda 関数、Amazon Simple Notification Service (Amazon SNS) キュー、およびすべての必須 AWS Identity and Access Management (IAM) ロールをデプロイします。IAM ロールは、Amazon FSx API オペレーションを呼び出すためのアクセス許可を Lambda 関数に付与します。
1. CloudWatch は、ファイルシステムの空きストレージ容量が指定されたしきい値を下回るとアラームをトリガーし、Amazon SNS キューにメッセージを送信します。
1. ソリューションによって、この Amazon SNS トピックに登録されている Lambda 関数がトリガーされます。
1. Lambda 関数は、指定された増加率の値に基づいて新しいファイルシステムのストレージ容量を計算し、新しいファイルシステムのストレージ容量を設定します。
1. Lambda 関数はオプションで、ファイルシステムの新しいストレージ容量の指定された割合に等しくなるように、空きストレージ容量しきい値を調整できます。
1. 元の CloudWatch アラームの状態と Lambda 関数オペレーションの結果は、Amazon SNS キューに送信されます。
CloudWatch アラームへのレスポンスとして実行されるアクションに関する通知を受信するには、**サブスクリプションの確認** 電子メールに記載されているリンクに従って Amazon SNS トピックのサブスクリプションを確認する必要があります。
## CloudFormation テンプレート
このソリューションでは CloudFormation 、 を使用して、FSx for Windows File Server ファイルシステムのストレージ容量を自動的に増やすために使用されるコンポーネントのデプロイを自動化します。このソリューションを使用するには、 [IncreaseFSxSize](https://s3.amazonaws.com/solution-references/fsx/DynamicScaling/IncreaseFSxSize.yaml) CloudFormation テンプレートをダウンロードします。
テンプレートは、次のように説明されている **パラメータ** を使用します。テンプレートパラメータとそのデフォルト値を確認し、ファイルシステムのニーズに合わせて変更します。
**FileSystemId**
デフォルト値はありません。ストレージ容量を自動的に拡張したいファイルシステムの ID。
**LowFreeDataStorageCapacityThreshold**
デフォルト値はありません。アラームがトリガーされ、ファイルシステムのストレージ容量が自動的に拡張される空きストレージ容量の初期しきい値を、GiB で指定するか、ファイルシステムの現在のストレージ容量のパーセンテージ (%) で指定します。パーセンテージで表すと、CloudFormation テンプレートは CloudWatch アラーム設定と一致するように GiB に再計算されます。
**LowFreeDataStorageCapacityThresholdUnit**
デフォルトは **%** です。`LowFreeDataStorageCapacityThreshold` の単位を GiB、または現在のストレージ容量に対するパーセンテージで指定します。
**AlarmModificationNotification**
デフォルトは **[Yes]** (はい) です。[はい] に設定すると、初期 `LowFreeDataStorageCapacityThreshold` は、後続のアラームしきい値の `PercentIncrease` の値に比例して増加します。
例えば、`PercentIncrease` が 20 に設定され、AlarmModificationNotification が Yes に設定されている場合、GiB で指定された使用可能な空き領域のしきい値 (`LowFreeDataStorageCapacityThreshold`) は、後続のストレージ容量増加イベントのために 20％ 増加します。
**EmailAddress**
デフォルト値はありません。SNS サブスクリプションに使用するメールアドレスを指定して、ストレージ容量のしきい値アラートを受信します。
**PercentIncrease**
デフォルト値はありません。現在のストレージ容量のパーセンテージとして表される、ストレージ容量を増やす量を指定します。
## を使用した自動デプロイ CloudFormation
次の手順では、FSx for Windows File Server ファイルシステムのストレージ容量を自動的に増やすように CloudFormation スタックを設定およびデプロイします。デプロイには約 5 分かかります。
**注記**
このソリューションを実装すると、関連する AWS サービスの請求が発生します。詳細については、それらのサービスの料金詳細ページを参照してください。
開始する前に、 AWS アカウントの Amazon Virtual Private Cloud (Amazon VPC) で実行されている Amazon FSx ファイルシステムの ID が必要です。Amazon FSx リソースの作成の詳細については、「[Amazon FSx for Windows File Server の開始方法](getting-started.md)」を参照してください。
**自動ストレージ容量拡張ソリューションスタックを起動するには**
1. [IncreaseFSxSize](https://s3.amazonaws.com/solution-references/fsx/DynamicScaling/IncreaseFSxSize.yaml) CloudFormation テンプレートをダウンロードします。CloudFormation スタックの作成の詳細については、 *AWS CloudFormation ユーザーガイド*の[AWS CloudFormation コンソールでのスタックの作成](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html)」を参照してください。
**注記**
Amazon FSx は現在、特定の AWS リージョンでのみ使用できます。このソリューションは、Amazon FSx が利用可能な AWS リージョンで起動する必要があります。詳細については、「*AWS 全般のリファレンス*」の「[Amazon FSx エンドポイントとクォータ](https://docs.aws.amazon.com/general/latest/gr/fsxn.html)」を参照してください。
1. **[Specify stack details]** (スタック詳細の指定) では、自動ストレージ容量増加ソリューションの値を入力します。
![\[CloudFormation テンプレートのスタック詳細の指定ページに入力した値を示すスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/fsx/latest/WindowsGuide/images/dynamic-storage-capacity-increase-cfn-stack.png)
1. **[Stack name]** (スタック名) を入力します。
1. **[Parameters]** (パラメータ) では、テンプレートのパラメータを確認し、ファイルシステムのニーズに合わせて変更します。次に、**[Next]** (次へ) を選択します。
1. カスタムソリューションに必要な **[Options]** (オプション) 設定を入力し、**[Next]** (次へ) を選択します。
1. **[Review]** (確認) では、ソリューション設定を確認して確定します。テンプレートが IAM リソースを作成することを認めるチェックボックスを選択します。
1. **[Create]** (作成) を選択してスタックをデプロイします。
スタックのステータスは、 CloudFormation コンソールの **Status **列で表示できます。約 5 分で **CREATE\$1COMPLETE** のステータスが表示されます。
### スタックの更新
スタックの作成後、同じテンプレートを使用してパラメータに新しい値を指定することで、スタックを更新できます。詳細については、「*AWS CloudFormation ユーザーガイド*」の「[スタックの直接更新](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-direct.html)」を参照してください。
# FSx for Windows ファイルシステムのストレージタイプの更新
HDD ストレージを使用して SSD ストレージを使用するファイルシステムのストレージタイプを変更できます。次の手順に示すように、Amazon FSx コンソール AWS CLI、、または Amazon FSx API を使用して、ファイルシステムのストレージタイプを変更できます。詳細については、「[ファイルシステムのストレージタイプの管理](managing-storage-configuration.md#managing-storage-type)」を参照してください。
## ファイルシステムのストレージタイプを更新するには (コンソール)
1. [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/) で Amazon FSx コンソールを開きます。
1. **[ファイルシステム]** に移動し、ストレージタイプを更新する Windows ファイルシステムを選択します。
1. **[アクション]** で **[ストレージの更新]** を選択します。または、**[サマリー]** パネルで、**[HDD]** の横にある **[更新]** ボタン選択します。**[ストレージタイプの更新]** ウィンドウが表示されます。
1. **[希望するストレージタイプ]** で、**[SSD]** を選択します。ストレージタイプの更新を開始するには、**[更新]** を選択します。
コンソールと CLI を使用し、ストレージタイプの更新の[進捗状況をモニタリング](monitoring-storage-type-updates.md)できます。
## ファイルシステムのストレージタイプを更新するには (CLI)
FSx for Windows File Server ファイルシステムのストレージタイプを更新するには、 AWS CLI コマンド [update-file-system](https://docs.aws.amazon.com/cli/latest/reference/fsx/update-file-system.html) を使用します。以下のパラメータを設定します:
+ `--file-system-id` を更新するファイル システムの ID に。
+ `--storage-type` から SSD へ。SSD ストレージタイプから HDD ストレージタイプには切り替えられません。
AWS CLI コマンド [describe-file-systems](https://docs.aws.amazon.com/cli/latest/reference/fsx/describe-file-systems.html) を使用して、更新の進行状況をモニタリングできます。出力で `administrative-actions` を探します。
詳細については、「[AdministrativeAction](https://docs.aws.amazon.com/fsx/latest/APIReference/API_AdministrativeAction.html)」を参照してください。
# ストレージタイプの更新をモニタリング
ファイルシステムのストレージタイプを HDD から SSD ストレージに更新した後、次の手順で説明するように、Amazon FSx コンソール、、 AWS CLIまたは API を使用してストレージタイプの更新の進行状況をモニタリングできます。
## コンソールでファイルシステムの更新をモニタリングする
**[ファイルシステムの詳細]** ウィンドウの **[更新]** タブに、更新の種類ごとに最近の 10 件の更新プログラムが表示されます。
ストレージタイプの更新については、次の情報を表示できます。
****[Update type]** (更新タイプ)**
可能な値は、**[ストレージタイプ]** です。
****[Target value]** (ターゲット値)**
**[SSD]**
****[Status]** (ステータス)**
更新の現在のステータス。ストレージタイプの更新では、可能な値は次のとおりです。
+ **[保留中]** – Amazon FSx は更新リクエストを受信しましたが、処理を開始していません。
+ **[In progress]** (進行中) - Amazon FSx が更新リクエストを処理しています。
+ **[最適化の更新]** – SSD ストレージのパフォーマンスを書き込みオペレーションに利用できます。更新は、**[最適化の更新状態]** に入りますが、通常は数時間かかり、その間の読み取りオペレーションは HDD と SSD の間のパフォーマンスレベルになります。更新処理が完了すると、新しい SSD パフォーマンスは読み取りと書き込みの両方に利用できるようになります。
+ **[完了]** - ストレージタイプの更新が正常に完了しました。
+ **[失敗]** — ストレージタイプの更新に失敗しました。詳細を見るには、疑問符 (**[?]**) を選択します。
****[Progress %]** (進行 %)**
ストレージ最適化プロセスの進行状況を、完了率として表示します。
****[Request time]** (リクエスト時間)**
Amazon FSx が更新アクションリクエストを受信した時刻。
## AWS CLI および API を使用した更新のモニタリング
[describe-file-systems](https://docs.aws.amazon.com/cli/latest/reference/fsx/describe-file-systems.html) AWS CLI コマンドと [DescribeFileSystems](https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeFileSystems.html) API アクションを使用して、ファイルシステムのストレージタイプの更新リクエストを表示およびモニタリングできます。`AdministrativeActions` 配列には、管理アクションタイプごとに最新の更新アクションが 10 件を表示されます。ファイルシステムの SSD IOPS を増やすと、`FILE_SYSTEM_UPDATE` および `STORAGE_TYPE_OPTIMIZATION` アクションの 2 つの `AdministrativeActions` が生成されます。
# ファイルシステムの SSD IOPS の更新
SSD ストレージで設定されたファイルシステムでは、プロビジョニングされた SSD IOPS のレベルによって、キャッシュにあるデータの読み取りまたは書き込みではなく、ファイルシステムがディスクとの間でデータを読み取り、ディスクに書き込む必要があるときに使用可能なディスク I/O の量を決定します。次の手順で説明するように、Amazon FSx コンソール、、 AWS CLIまたは Amazon FSx API を使用して、ファイルシステムの SSD IOPS を更新できます。SSD IOPS の管理の詳細については、「[SSD IOPS の管理](managing-storage-configuration.md#managing-provisioned-ssd-iops)」を参照してください。
## ファイルシステムの SSD IOPS を更新するには (コンソール)
1. [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/) で Amazon FSx コンソールを開きます。
1. **[ファイルシステム]** に移動して、SSD IOPS を更新する Windows ファイルシステムを選択します。
1. **[アクション]** で、**[SSD IOPS の更新]** を選択します。または、**[サマリー]** パネルで、**[プロビジョニングされた SSD IOPS]** の横にある **[更新]** ボタンを選択します。**[IOPS プロビジョニングを更新]** ウィンドウが開きます。
1. **[モード]** で、**[自動]** または **[ユーザープロビジョニング]** を選択します。**[自動]** を選択した場合、Amazon FSx はファイルシステムのストレージ容量 1 GiB あたり 3 つの SSD IOPS を自動的にプロビジョニングします。**[ユーザープロビジョニング]** を選択した場合は、96 ～ 400,000 の範囲の任意の整数を入力します。
1. **[更新]** を選択して、プロビジョニングされた SSD IOPS の更新を開始します。
1. 更新の進捗状況は、**[Updates]** (更新) タブの **[File systems]** (ファイルシステム) 詳細ページでモニタリングできます。
## ファイルシステムの SSD IOPS を更新するには (CLI)
FSx for Windows File Server ファイルシステムの SSD IOPS を更新するには、`--windows-configuration DiskIopsConfiguration` プロパティを使用します。このプロパティには、`Iops` と `Mode` の 2 つのパラメータがあります:
+ SSD IOPS の数を指定する場合は、 を使用します。サポートされている AWS リージョンと では`Iops=number_of_IOPS`最大 400,000 です`Mode=USER_PROVISIONED`。
+ Amazon FSx で SSD IOPS を自動的に増加させたい場合は、`Mode=AUTOMATIC` を使用し、`Iops` パラメータは使用しないでください。Amazon FSx は、ファイルシステムのストレージ容量 1 GiB あたり 3 SSD IOPS を自動的に維持し、サポートされている AWS リージョンでは最大 400,000 まで維持します。
AWS CLI コマンド [describe-file-systems](https://docs.aws.amazon.com/cli/latest/reference/fsx/describe-file-systems.html) を使用して、更新の進行状況をモニタリングできます。出力で `administrative-actions` を探します。
詳細については、「[AdministrativeAction](https://docs.aws.amazon.com/fsx/latest/APIReference/API_AdministrativeAction.html)」を参照してください。
# プロビジョニングされた SSD IOPS 更新のモニタリング
ファイルシステムのプロビジョニングされた SSD IOPS の量を更新する AWS CLIと、次の手順で説明するように、Amazon FSx コンソール、、および API を使用して SSD IOPS の更新の進行状況をモニタリングできます。
## コンソールで更新をモニタリングする
**ファイルシステムの詳細** ウィンドウの **[Updates]** (更新) タブでは、更新の種類ごとに最新の更新プログラムを 10 個表示できます。
プロビジョニングされた SSD IOPS の更新については、次の情報を表示できます。
****[Update type]** (更新タイプ)**
可能な値は、**[IOPS モード]** および **[SSD IOPS]** です。
****[Target value]** (ターゲット値)**
ファイルシステムの IOPS モードと SSD IOPS へ更新するのに必要な値です。
****[Status]** (ステータス)**
更新の現在のステータス。SSD IOPS 更新の場合、可能な値は以下の通りです:
+ **[Pending]** (保留中) - Amazon FSx は更新リクエストを受信しましたが、処理を開始していません。
+ **[In progress]** (進行中) - Amazon FSx が更新リクエストを処理しています。
+ **最適化の更新** – 新しい IOPS レベルをワークロードの書き込み操作に使用できます。更新は、**最適化の更新** 状態に入り、通常数時間続き、その間、ワークロードの読み取りオペレーションは、以前のレベルと新しいレベル間の IOPS パフォーマンスになります。更新処理が完了すると、新しい IOPS レベルは読み取りと書き込みの両方に使用できるようになります。
+ **[完了]** - SSD IOPS の更新が正常に完了しました。
+ **[失敗]** — SSD IOPS の更新に失敗しました。疑問符 (**?**) を選択し、ストレージの更新が失敗した理由の詳細を確認します。
****進行 %****
ストレージ最適化プロセスの進行状況を、完了率として表示します。
****リクエスト時間****
Amazon FSx が更新アクションリクエストを受信した時刻。
## AWS CLI および API を使用した更新のモニタリング
[describe-file-systems](https://docs.aws.amazon.com/cli/latest/reference/fsx/describe-file-systems.html) AWS CLI コマンドと [DescribeFileSystems](https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeFileSystems.html) API アクションを使用して、ファイルシステム SSD IOPS 更新リクエストを表示およびモニタリングできます。`AdministrativeActions` 配列には、管理アクションタイプごとに最新の更新アクションが 10 件を表示されます。ファイルシステムの SSD IOPS を増やすと、`FILE_SYSTEM_UPDATE` および `IOPS_OPTIMIZATION` アクションの 2 つの `AdministrativeActions` が生成されます。
# データ重複除外の管理
PowerShell でのリモート管理用の Amazon FSx CLI を使用して、ファイルシステムの[データ重複除外設定](managing-storage-configuration.md#using-data-dedup)を管理できます。PowerShell での Amazon FSx CLI リモート管理の使用の詳細については、「[PowerShell での Amazon FSx CLI の使用](administering-file-systems.md#remote-pwrshell)」を参照してください。
データ重複除外に使用できるコマンドは次のとおりです。
| データ重複除外コマンド | 説明 |
| --- | --- |
| **[Enable-FSxDedup](#enable-dedup)** | ファイル共有でデータ重複除外を有効にします。データ重複除外を有効にすると、重複除外後のデータ圧縮がデフォルトで有効になります。 |
| **Disable-FSxDedup** | ファイル共有のデータ重複除外を無効にします。 |
| **Get-FSxDedupConfiguration** | 最適化の最小ファイルサイズと保存期間、圧縮設定、除外されたファイルタイプとフォルダなど、重複除外設定情報を取得します。 |
| **Set-FSxDedupConfiguration** | 最適化の最小ファイルサイズと保存期間、圧縮設定、除外されたファイルタイプとフォルダなど、重複除外の設定を変更します。 |
| **[Get-FSxDedupStatus](#get-dedup-status)** | 重複除外ステータスを取得し、ファイルシステムの最適化の節約とステータス、時間、ファイルシステム上の最後の重複排除ジョブの完了ステータスを説明する読み取り専用プロパティを含めます。 |
| **Get-FSxDedupMetadata** | 重複除外最適化メタデータを取得します。 |
| **Update-FSxDedupStatus** | 更新されたデータ重複除外の節約情報を計算して取得します。 |
| **Measure-FSxDedupFileMetadata** | フォルダのグループを削除した場合に、ファイルシステム上で再利用できる潜在的なストレージ領域を測定および取得します。多くの場合、ファイルには他のフォルダ間で共有されるチャンクがあり、重複除外エンジンは一意で削除されるチャンクを計算します。 |
| **Get-FSxDedupSchedule** | 現在定義されている重複除外スケジュールを取得します。 |
| **[New-FSxDedupSchedule](#new-dedup-sched)** | データ重複除外スケジュールを作成およびカスタマイズします。 |
| **[Set-FSxDedupSchedule](#set-dedup-sched)** | 既存のデータ重複除外スケジュールの設定を変更します。 |
| **Remove-FSxDedupSchedule** | 重複除外スケジュールを削除します。 |
| **Get-FSxDedupJob** | 現在実行中またはキューに入っているすべての重複除外ジョブのステータスと情報を取得します。 |
| **Stop-FSxDedupJob** | 指定したデータ重複除外ジョブを 1 つ以上キャンセルします。 |
各コマンドのオンラインヘルプには、すべてのコマンドオプションのリファレンスが記載されています。このヘルプにアクセスするには、**-?** (例えば、**Enable-FSxDedup -?**) コマンドを実行します。
## データ重複除外の有効化
Amazon FSx for Windows File Server ファイル共有でデータ重複除外を有効にするには、次のように `Enable-FSxDedup` コマンドを使用します。
```
PS C:\Users\Admin> Invoke-Command -ComputerName amznfsxzzzzzzzz.corp.example.com -ConfigurationName FSxRemoteAdmin -ScriptBlock {Enable-FsxDedup }
```
データ重複除外を有効にすると、デフォルトのスケジュールと設定が作成されます。以下のコマンドを使用して、スケジュールと設定を作成、変更、削除できます。
`Disable-FSxDedup` コマンドを使用して、ファイルシステムのデータ重複除外を完全に無効化できます。
## データ重複除外スケジュールの作成
デフォルトのスケジュールはほとんどの場合うまく機能しますが、次のように `New-FsxDedupSchedule` コマンドを使用して、新しい重複除外スケジュールを作成することができます。データ重複除外スケジュールでは UTC 時間が使用されます。
```
PS C:\Users\Admin> Invoke-Command -ComputerName amznfsxzzzzzzzz.corp.example.com -ConfigurationName FSxRemoteAdmin -ScriptBlock {
New-FSxDedupSchedule -Name "CustomOptimization" -Type Optimization -Days Mon,Wed,Sat -Start 08:00 -DurationHours 7
}
```
このコマンドは `CustomOptimization` という名前のスケジュールを作成します。これは、月曜日、水曜日、土曜日に実行され、毎日午前 8:00 (UTC) にジョブを開始し、最大期間は 7 時間で、ジョブがまだ実行されている場合はジョブを停止します。
新しいカスタム重複除外ジョブスケジュールを作成しても、既存のデフォルトスケジュールが上書きされたり、削除されたりすることはありません。デフォルトのジョブが不要な場合は、カスタム重複除外ジョブを作成する前に無効にすることができます。
以下に示すように、`Set-FsxDedupSchedule` コマンドを使用して、デフォルトの重複除外付けジュールを無効化できます。
```
PS C:\Users\Admin> Invoke-Command -ComputerName amznfsxzzzzzzzz.corp.example.com -ConfigurationName FSxRemoteAdmin -ScriptBlock {Set-FSxDedupSchedule -Name “BackgroundOptimization” -Enabled $false}
```
重複排除スケジュールは、`Remove-FSxDedupSchedule -Name "ScheduleName"` コマンドを使用して削除できます。デフォルトの `BackgroundOptimization` 重複排除スケジュールは変更または削除できないため、無効にする必要があります。
## データ重複除外スケジュールの変更
次のように `Set-FsxDedupSchedule` コマンドを使用して、既存の重複除外スケジュールを変更できます。
```
PS C:\Users\Admin> Invoke-Command -ComputerName amznfsxzzzzzzzz.corp.example.com -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Set-FSxDedupSchedule -Name "CustomOptimization" -Type Optimization -Days Mon,Tues,Wed,Sat -Start 09:00 -DurationHours 9
}
```
このコマンドは、既存の `CustomOptimization` スケジュールを修正します。これは、月曜日から水曜日と土曜日の日に実行され、毎日午前 9:00 (UTC) にジョブを開始し、最大期間は 9 時間で、ジョブがまだ実行されている場合はジョブを停止します。
最適化前のファイルの最小保存期間を変更するには、`Set-FSxDedupConfiguration` コマンドを使用します。
## 保存スペースの量の表示
データ重複除外を実行することで節約するディスク容量を表示するには、次のように `Get-FSxDedupStatus` コマンドを使用します。
```
PS C:\Users\Admin> Invoke-Command -ComputerName amznfsxzzzzzzzz.corp.example.com -ConfigurationName FsxRemoteAdmin -ScriptBlock {
Get-FSxDedupStatus } | select OptimizedFilesCount,OptimizedFilesSize,SavedSpace,OptimizedFilesSavingsRate
OptimizedFilesCount OptimizedFilesSize SavedSpace OptimizedFilesSavingsRate
------------------- ------------------ ---------- -------------------------
12587 31163594 25944826 83
```
**注記**
Capacity、FreeSpace、UsedSpace、UnoptimizedSize、SavingsRate のパラメータに対するコマンドレスポンスに表示される値は信頼できないため、使用しないでください。
# データ重複排除のトラブルシューティング
以下の情報を使用して、データ重複排除を設定および使用する際の一般的な問題のトラブルシューティングにお役立てください。
**Topics**
+ [データ重複排除が機能していない](#data-dedup-not-working)
+ [重複排除の値が予期せず 0 に設定されている](#data-dedup-stopped)
+ [ファイルを削除した後、ファイルシステムのスペースが解放されません](#data-dedup-freed-space)
## データ重複排除が機能していない
データ重複排除の現在のステータスを確認するには、`Get-FSxDedupStatus` PowerShell コマンドを実行し、最新の重複排除ジョブの完了ステータスを表示します。1 つ以上のジョブが失敗している場合、ファイルシステム上で空きストレージ容量の増加が見られない場合があります。
重複排除ジョブが失敗する最も一般的な理由は、メモリ不足です。
+ Microsoft は、1 TB の論理的なデータあたり 1 GB のメモリが最適にあることを[推奨](https://docs.microsoft.com/en-us/windows-server/storage/data-deduplication/install-enable#faq)します (または、1 TB の論理的なデータあたり少なくとも 350 MB)。[Amazon FSx パフォーマンステーブル](performance.md#performance-table) を使用して、ファイルシステムのスループットキャパシティに関連付けられているメモリを特定し、メモリリソースがデータのサイズに対して十分であることを確認します。そうでない場合は、[ファイルシステムのスループットキャパシティを、論理データの 1 TB あたり 1 GB のメモリ要件を満たすレベルまで増やす](managing-throughput-capacity.md)必要があります。
+ 重複排除ジョブは、Windows が推奨するデフォルトの 25％ のメモリ割り当てで設定されます。つまり、32 GB のメモリを備えたファイルシステムの場合、8 GB が重複排除に使用できます。メモリ割り当ては設定可能です (パラメータ `–Memory` で `Set-FSxDedupSchedule` コマンドを使用します)。重複排除にメモリ割り当てを増やすと、ファイルシステムのパフォーマンスに影響する可能性があることに注意してください。
+ 重複排除のジョブの設定を変更して、必要なメモリ量を削減できます。例えば、特定のファイルタイプまたはフォルダーで実行するように最適化を制限したり、最適化のための最小ファイルサイズと経過時間を設定したりできます。また、ファイルシステムのロードが最小限であるアイドル期間中に重複排除ジョブが実行されるように設定することをお勧めします。
重複排除ジョブを完了するのに十分な時間がない場合にも、エラーが表示されることがあります。[データ重複除外スケジュールの変更](managing-data-dedup.md#set-dedup-sched) で説明されているように、ジョブの最大期間を変更する必要がある場合があります。
重複排除ジョブが長期間失敗していて、この期間中にファイルシステム上のデータに変更があった場合、後続の重複排除ジョブを初めて正常に完了するには、より多くのリソースが必要になる場合があります。
## 重複排除の値が予期せず 0 に設定されている
データ重複排除を設定したファイルシステムでは、`SavedSpace` と `OptimizedFilesSavingsRate` の値が予期せず 0 になります。
これは、ファイルシステムのストレージ容量を増やす際、ストレージ最適化プロセス中に発生する可能性があります。ファイルシステムのストレージ容量を増やすと、Amazon FSx は、ストレージ最適化プロセス中に既存のデータ重複排除ジョブをキャンセルします。これにより、以前のディスクから新しくより大きなディスクにデータが移行されます。ストレージ最適化ジョブが完了すると、Amazon FSx はファイルシステムでのデータ重複排除を再開します。ストレージ容量の増加とストレージの最適化の詳細については、「[ストレージ容量の管理](managing-storage-configuration.md#managing-storage-capacity)」を参照してください。
## ファイルを削除した後、ファイルシステムのスペースが解放されません
データ重複排除の予想される動作は、重複排除がスペースを節約したデータが削除されたデータであった場合、ガベージコレクションのジョブが実行されるまでファイルシステムでスペースは解放されません。
役立つと思われるプラクティスとして、多数のファイルを削除した直後にガベージコレクションのジョブを実行するようにスケジュールを設定することができます。ガベージコレクションのジョブが終了したら、ガベージコレクションのスケジュールを元の設定に戻すことができます。これにより、削除により解放された容量をすぐに確認できます。
次の手順を使用して、ガベージコレクションジョブを 5 分で実行するように設定します。
1. データ重複排除が有効になっていることを確認するには、`Get-FSxDedupStatus` コマンドを使用します。コマンドとその期待される出力の詳細については、「[保存スペースの量の表示](managing-data-dedup.md#get-dedup-status)」を参照してください。
1. 以下を使用して、5 分後にガベージコレクションのジョブを実行するスケジュールを設定します。
```
$FiveMinutesFromNowUTC = ((get-date).AddMinutes(5)).ToUniversalTime()
$DayOfWeek = $FiveMinutesFromNowUTC.DayOfWeek
$Time = $FiveMinutesFromNowUTC.ToString("HH:mm")
Invoke-Command -ComputerName ${RPS_ENDPOINT} -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Set-FSxDedupSchedule -Name "WeeklyGarbageCollection" -Days $Using:DayOfWeek -Start $Using:Time -DurationHours 9
}
```
1. ガベージコレクションのジョブが実行され、スペースが解放されたら、スケジュールを元の設定に戻します。
# DFS 名前空間の使用
DFS 名前空間は、異なるサーバーにある共有フォルダを 1 つ以上の論理的に構造化された名前空間にグループ化するために使用する Windows Server ロールサービスです。これにより、次の図に示すように、共有フォルダの仮想ビューをユーザーに付与できます。1 つのパスから複数のファイルシステムにあるファイルに移動できます。複数のファイルシステム間でファイル共有へのアクセスを整理および統合することに加えて、
## 複数の FSx for Windows File Server のファイルシステムと DFS 名前空間のグループ化
Microsoft 分散ファイルシステム (DFS) 名前空間を使用して、複数の FSx for Windows File Server ファイルシステム上のファイル共有を 1 つの一般的なフォルダ構造または名前空間にグループ化できます。DFS 名前空間を使用すると、大きなファイルデータセットの単一ファイルシステム (64 TiB) の最大ストレージ容量を超えて、数百ペタバイトまでのファイルストレージを拡張できます。このセクションでは、複数の FSx for Windows File Server ファイルシステムに DFS 名前空間を設定する方法を示します。
DFS 名前空間は、異なるサーバーにある共有フォルダを 1 つ以上の論理的に構造化された名前空間にグループ化するために使用する Windows Server ロールサービスです。これにより、次の図に示すように、共有フォルダの仮想ビューをユーザーに付与できます。1 つのパスから複数のファイルシステムにあるファイルに移動できます。複数のファイルシステム間でファイル共有へのアクセスを整理および統合することに加えて、
![\[2 つの名前空間サーバーに 1 つの名前空間を作成するプロセスを示す図。\]](http://docs.aws.amazon.com/ja_jp/fsx/latest/WindowsGuide/images/FSx-common-namespace.png)
DFS 名前空間を使用して FSx for Windows ファイルシステムをグループ化するステップバイステップの手順については、「[単一の名前空間で複数のファイルシステムをグループ化する](group-fsx-namespace.md)」を参照してください。
## シャードによるパフォーマンスの向上
Amazon FSx for Windows File Server は、Microsoft 配信ファイルシステム (DFS) の使用をサポートしています。DFS 名前空間を使用すると、ファイルデータを複数の Amazon FSx ファイルシステムに分散させて、入出力の負荷の高い I / O ワークロードに対応するためのパフォーマンス (読み取りと書き込みの両方) をスケールアウトすることができます。同時に、共通の名前空間下で統一されたビューをアプリケーションに表示することもできます。このソリューションには、ファイルデータをより小さなデータセットまたは *シャード* に分割したり、それらを異なるファイルシステム間に保存することが含まれています。複数のインスタンスからデータにアクセスするアプリケーションは、これらのシャードに対して並行して読み取りと書き込みを行うことで、高いレベルのパフォーマンスを設定できます。
[スケールアウトパフォーマンスのための DFS 名前空間を使用したデータのシャーディング](scaleout-performance.md) で提供されているソリューションを使用して、複数の FSx for Windows File Server ファイルシステムにデータへの読み取り/書き込みアクセスを均一に分散できます。
# 単一の名前空間で複数のファイルシステムをグループ化する
この手順では、複数の FSx for Windows ファイルシステム (財務、マーケティング、販売、home\$1directories) に保存されているファイル共有を統合するために、2 つの名前空間サーバーに 1 つのドメインベースの名前空間 (`example.com\corp`) を作成します。また、名前空間の下に 4 つのファイル共有を設定し、それぞれ別々の FSx for Windows ファイルシステムでホストされている共有に、ユーザーを透過的にリダイレクトさせます。これにより、ユーザーは、ファイル共有をホストする各ファイルシステムの DNS 名を指定しなくても、共通の名前空間を使用してファイル共有にアクセスできます。
**注記**
Amazon FSx を DFS 共有パスのルートに追加することはできません。
**複数のファイルシステムを共通の DFS 名前空間にグループ化するには**
1. DFS 名前空間サーバーをまだ実行していない場合は、[setup-DFSN-servers.template](https://solution-references.s3.amazonaws.com/fsx/dfs/setup-DFSN-servers.template) CloudFormation テンプレートを使用して、高可用性 DFS 名前空間サーバーのペアを起動できます。CloudFormation スタックの作成の詳細については、「*AWS CloudFormation ユーザーガイド*」の「[AWS CloudFormation コンソールでスタックを作成する](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html)」を参照してください。
1. 前のステップで起動した DFS 名前空間サーバーの 1 つに、**AWS 委任管理者** グループのユーザーとして接続します。詳細については、*Amazon EC2 ユーザーガイド* の [Windows インスタンスへの接続](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/connecting_to_windows_instance.html) を参照してください。
1. DFS 管理コンソールを開いてアクセスします。**[Start]** (スタート) メニューを開き、**dfsmgmt.msc** を実行します。これにより DFS 管理 GUI ツールが開きます。
1. **[Action]** (アクション)、それから **[New Namespace]** (新規名前空間) を選択し、**[Server]** (サーバー) で最初に起動した DFS 名前空間サーバーのコンピュータ名を入力し、**[Next]** (次へ) を選択します。
1. **[Name]** (名前) に、作成する名前空間を入力します (例えば、**Corp**)。
1. **[Edit Settings]** (設定の編集) を選択して、要件に応じて適切な許可を設定します。**[Next]** (次へ) を選択します。
1. デフォルトの**[Domain-based namespace]** (ドメインベースの名前空間) オプションが選択されたままにします。**[Enable Windows Server 2008 mode]** (Windows サーバー 2008 モードを有効化) オプションも選択したままで、**[Next]** (次へ) を選択します。
**注記**
Windows Server 2008 モードは、名前空間で使用可能な最新のオプションです。
1. 名前空間の設定を確認し、**[Create]** (作成) を選択します。
1. ナビゲーションバーの**[Namespaces]** (名前空間) で新規作成した名前空間が選択された状態で、**[Action]** (アクション)、**[Add Namespace Server]** (名前空間サーバーの追加) の順に選択します。
1. **名前空間サーバー** に起動した 2 つ目の DFS 名前空間サーバーのコンピュータ名を入力します。
1. **[Edit Settings]** (設定の編集) を選択し、要件に基づいて適切な許可を設定し、**[OK]** を選択します。
1. 作成した名前空間のコンテキスト (右クリック) メニューを開き、**[New Folder]** (新しいフォルダ) を選択し、フォルダ名を入力し (例えば **名前** に `finance`)、**[OK]** を選択します。
1. **フォルダーターゲットへのパス** のために、DFS 名前空間フォルダを指定するファイル共有の DNS 名を UNC 形式で入力して (例えば `\\fs-0123456789abcdef0.example.com\finance`)、**[OK]** を選択します。
1. 共有が存在しない場合。
1. **[Yes]** (はい) を選択して共有を作成します。
1. **[Create Share]** (共有の作成) ダイアログから、**[Browse]** (参照) を選択します。
1. 既存のフォルダを選択するか、**[D\$1]** の下に新しいフォルダを作成して、**[OK]** 選択します。
1. 適切な共有許可を設定し、**[OK]** を選択します。
1. **[New Folder]** (新しいフォルダ) ダイアログで、**[OK]** を選択します。新しいフォルダーが名前空間の下に作成されます。
1. 最後の 4 つのステップを繰り返して、同じ名前空間で共有したい他のフォルダを作成します。
# スケールアウトパフォーマンスのための DFS 名前空間を使用したデータのシャーディング
以下の手順では、スケールアウトパフォーマンスを実現するために、Amazon FSx 上で DFS ソリューションを作成する方法について説明します。この例では、*corp* 名前空間に保存されているデータがアルファベット順にシャードされています。データファイル「A-F」、「G-M」、「N-Z」はすべて異なるファイル共有に保存されます。データの種類、入出力 I / O サイズ、および入出力 I / O アクセスパターンに基づいて、複数のファイル共有間でデータをシャードさせる最適な方法を決定する必要があります。使用する予定のすべてのファイル共有に、入出力 I / O を均等に配信するシャーディング方式を選択します。各名前空間は、最大 50,000 のファイル共有と、全体で数百ペタバイトのストレージ容量をサポートすることに注意してください。
![\[スケールアウトパフォーマンスのための Amazon FSx での DFS ソリューションの設定を示す図。\]](http://docs.aws.amazon.com/ja_jp/fsx/latest/WindowsGuide/images/FSx-scale-out-performance.png)
**スケールアウトパフォーマンスに DFS 名前空間を設定するには**
1. DFS 名前空間サーバーがまだ実行されていない場合は、[setup-DFSN-servers.template](https://s3.amazonaws.com/solution-references/fsx/dfs/setup-DFSN-servers.template) CloudFormation テンプレートを使用して、高可用性 DFS 名前空間サーバーのペアを起動することができます。CloudFormation スタックの作成の詳細については、「*AWS CloudFormation ユーザーガイド*」の「[AWS CloudFormation コンソールでスタックを作成する](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html)」を参照してください。
1. 前のステップで起動した DFS 名前空間サーバーの 1 つに、**AWS 委任管理者** グループのユーザーとして接続します。詳細については、*Amazon EC2 ユーザーガイド* の [Windows インスタンスへの接続](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/connecting_to_windows_instance.html) を参照してください。
1. DFS 管理コンソールにアクセスします。**[Start]** (スタート) メニューを開いて **dfsmgmt.msc** を実行します。これにより DFS 管理 GUI ツールが開きます。
1. **[Action]** (アクション)、それから **[New Namespace]** (新規名前空間) を選択し、**[Server]** (サーバー) で最初に起動した DFS 名前空間サーバーのコンピュータ名を入力し、**[Next]** (次へ) を選択します。
1. **[Name]** (名前) に、作成する名前空間を入力します (例えば、**Corp**)。
1. **[Edit Settings]** (設定の編集) を選択して、要件に応じて適切な許可を設定します。**[Next]** (次へ) を選択します。
1. デフォルトの**[Domain-based namespace]** (ドメインベースの名前空間) オプションが選択されたままにします。**[Enable Windows Server 2008 mode]** (Windows サーバー 2008 モードを有効化) オプションも選択したままで、**[Next]** (次へ) を選択します。
**注記**
Windows Server 2008 モードは、名前空間で使用可能な最新のオプションです。
1. 名前空間の設定を確認し、**[Create]** (作成) を選択します。
1. ナビゲーションバーの**[Namespaces]** (名前空間) で新規作成した名前空間が選択された状態で、**[Action]** (アクション)、**[Add Namespace Server]** (名前空間サーバーの追加) の順に選択します。
1. **名前空間サーバー** に起動した 2 つ目の DFS 名前空間サーバーのコンピュータ名を入力します。
1. **[Edit Settings]** (設定の編集) を選択し、要件に応じて適切な許可を設定し、**[OK]** を選択します。
1. 作成した名前空間のコンテキスト (右クリック) メニューを開き、**[New Folder]** (新規フォルダ) を選択し、最初のシャードのフォルダ名 (例えば **[Name]** (名前) に `A-F`) を入力して、**[Add]** (追加) を選択します。
1. **[Path to folder target]** (フォルダーターゲットへのパス) に、このシャードをホストしているファイル共有の DNS 名を UNC 形式 (例えば `\\fs-0123456789abcdef0.example.com\A-F`) で入力し、**[OK]** を選択します。
1. 共有が存在しない場合。
1. **[Yes]** (はい) を選択して共有を作成します。
1. **[Create Share]** (共有の作成) ダイアログから、**[Browse]** (参照) を選択します。
1. 既存のフォルダを選択するか、**[D\$1]** の下に新しいフォルダを作成して、**[OK]** 選択します。
1. 適切な共有許可を設定し、**[OK]** を選択します。
1. このシャードにフォルダーターゲットが追加されたら、**[OK]** を選択します。
1. 同じ名前空間に追加したい他のシャードについても、後半の 4 つのステップを繰り返します。
# スループット容量の管理
ファイルシステムのスループットキャパシティはいつでも増減してパフォーマンスの管理ができます。スループットキャパシティは、FSx for Windows File Server ファイルシステムをホストしているファイルサーバーがデータを提供できる速度を決定する要素の 1 つです。スループットキャパシティでは、秒ごとの I/O オペレーション (IOPS) のレベルが高くなり、ファイルサーバー上のキャッシュメモリの量が増えます。詳細については、「[FSx for Windows File Server のパフォーマンスパフォーマンス](performance.md)」を参照してください。
**Topics**
+ [スループットスケーリングの仕組み](#how-throughput-scaling-works)
+ [スループットキャパシティを変更するタイミングを知る](#when-to-modify-throughput-capacity)
+ [スループットキャパシティの変更](increase-throughput-capacity.md)
+ [スループットキャパシティの更新のモニタリング](monitoring-throughput-capacity-changes.md)
## スループットスケーリングの仕組み
ファイルシステムのスループット容量を変更すると、Amazon FSx は裏側で、より多いまたは少ないスループットを持つファイルサーバーに切り替えます。マルチ AZ ファイルシステムの場合、Amazon FSx が優先ファイルサーバーとセカンダリファイルサーバーを切り替える間、自動フェイルオーバーとフェイルバックをトリガーする新しいファイルサーバーに切り替えます。シングル AZ システムでは、ファイルサーバーがスループットキャパシティのスケーリング中に切り替わる間にファイルシステムが数分間利用できなくなります。ファイルシステムで使用可能になると、新しいスループットキャパシティが課金されます。
**注記**
バックエンドでのメンテナンスオペレーション中に、システムの変更 (スループットキャパシティの変更を含む) が遅れる場合があります。メンテナンスオペレーションでは、システムの変更によってキューに入り、処理される可能性があります。
マルチ AZ ファイルシステムの場合、Amazon FSx が優先ファイルサーバーおよびセカンダリファイルサーバーを切り替える間、スループットキャパシティのスケーリングは自動フェイルオーバーおよびフェイルバックを引き起こします。ファイルサーバーの交換作業中は、スループット容量の拡張時、ファイルシステムのメンテナンス時、および予期せぬサービス中断時に発生しますが、ファイルシステムへの継続的なトラフィックは、稼働中の残りのファイルサーバーによって処理されます。交換したファイルサーバーがオンラインに戻ると、FSx for Windows は再同期ジョブを実行し、データが新しく交換されたファイルサーバーに確実に同期されるようにします。
FSx for Windows は、この再同期アクティビティがアプリケーションとおよびーザーに与える影響を最小限に抑えるように設計されています。ただし、再同期プロセスでは大きなブロックでデータを同期する必要があります。つまり、ごく一部のデータのみが更新された場合でも、データの大きなブロックを同期する必要があります。したがって、再同期の量はデータチャーンの量だけでなく、ファイルシステム上のデータチャーンの性質にも依存します。ワークロードの書き込みと IOPS が多い場合、データ同期処理に時間がかかり、追加のパフォーマンスリソースが必要になることがあります。
この間、ファイルシステムは引き続き使用可能になりますが、データ同期の期間を短縮するために、ファイルシステムの負荷が最小であるアイドル期間中にスループット容量を変更することをお勧めします。データ同期にかかる時間を短縮するため、ファイルシステムには、ワークロードに加えて同期ジョブも実行するために十分なスループットキャパシティがあるか確認することをお勧めします。最後に、ファイルシステムの負荷が軽いうちにフェイルオーバーの影響をテストすることをお勧めします。
## スループットキャパシティを変更するタイミングを知る
Amazon FSx は Amazon CloudWatch と統合され、ファイルシステムの継続的なスループット使用レベルをモニタリングできます。ファイルシステムを介してドライブできるパフォーマンス (スループットと IOPS) は、ファイルシステムのスループットキャパシティ、ストレージ容量、ストレージタイプと共に、特定のワークロードの特性によって異なります。CloudWatch メトリクスを使用して、パフォーマンスを向上させるためにディメンションを決定できます。詳細については、「[Amazon CloudWatch を使用したモニタリング](monitoring-cloudwatch.md)」を参照してください。
FSx for Windows File Server は、Amazon FSx コンソールのファイルシステムの詳細ページのモニタリングとパフォーマンスダッシュボードで、ファイルシステムの CloudWatch メトリクスの値に基づいてパフォーマンスアラートを提供します。これには、スループットキャパシティ、およびスループットキャパシティの増加から恩恵を受ける可能性のあるその他のファイルシステムメトリクスが含まれます。詳細については、「[パフォーマンスの警告と推奨事項](monitoring-cloudwatch.md#performance-insights-FSxW)」を参照してください。
ファイルシステムを構成する際には、ワークロードの予想トラフィックだけでなく、ファイルシステムで有効化する機能をサポートするために必要な追加のパフォーマンスリソースにも対応できる十分なスループット容量を確保してください。例えば、データ重複排除を実行している場合、選択するスループットキャパシティは、使用しているストレージに基づいて重複排除を実行するのに十分なメモリを提供する必要があります。シャドウコピーを使用している場合は、Windows Server がシャドウコピーを削除しないように、スループットキャパシティをワークロードによって駆動されると予想される値の 3 倍以上の値に増やしてください。詳細については、「[スループットキャパシティがパフォーマンスに与える影響](performance.md#impact-throughput-cap-performance)」を参照してください。
# スループットキャパシティの変更
Amazon FSx コンソール、 AWS Command Line Interface (AWS CLI)、または Amazon FSx API を使用して、以下の手順に示すように、ファイルシステムのスループット容量を増減できます。
## ファイルシステムのスループット容量を変更するには (コンソール)
1. [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/) で Amazon FSx コンソールを開きます。
1. **[File systems]** (ファイルシステム) に移動し、スループット容量を拡張する Windows ファイルシステムを選択します。
1. **[Actions]** (アクション) には、**[Update throughput]** (スループットの更新) を選択します。
または、**[Summary]** (概要) パネルでファイルシステムの **[Throughput capacity]** (スループット容量) の横にある **[Update]** (更新) を選択します。
**スループット容量の更新** ウィンドウが表示されます。
1. リストから **[Throughput Capacity]** (スループット容量) の新しい値を選択します。
1. **[Update]** (更新) を選択して、スループット容量の更新を開始します。
**注記**
マルチ AZ ファイルシステムは、スループットスケーリングの更新時にフェイルオーバーしてフェイルバックし、完全に利用可能になります。シングル AZ ファイルシステムは更新中、ごくわずかな期間利用できないことがあります。
1. **[Updates]** (更新) タブの **[File systems]** (ファイルシステム) 詳細ページで、更新の進捗状況をモニタリングできます。
Amazon FSx コンソール、、および API を使用して AWS CLI、更新の進行状況をモニタリングできます。詳細については、「[スループットキャパシティの更新のモニタリング](monitoring-throughput-capacity-changes.md)」を参照してください。
## ファイルシステムのスループット容量を変更するには (CLI)
ファイルシステムのスループットキャパシティを増減するには、 AWS CLI コマンド [update-file-system](https://docs.aws.amazon.com/cli/latest/reference/fsx/update-file-system.html) を使用します。以下のパラメータを設定します。
+ 更新するファイルシステムの ID への `--file-system-id`。
+ `ThroughputCapacity` を目的の値に設定します。有効な値は 8、16、32、64、128、256、512、1024、2048、4608、6144、9216、12288 MBps です。
Amazon FSx コンソール、、および API を使用して AWS CLI、更新の進行状況をモニタリングできます。詳細については、「[スループットキャパシティの更新のモニタリング](monitoring-throughput-capacity-changes.md)」を参照してください。
# スループットキャパシティの更新のモニタリング
Amazon FSx コンソール、API、および AWS CLIを使用して、スループット容量変更プロセスをモニタリングできます。
## コンソールでのスループット容量の変更のモニタリング
**[File system details]** (ファイルシステムの詳細) ウィンドウの **[Updates]** (更新) タブで、更新アクションの種類ごとに最新の 10 件の更新アクションを表示できます。
![\[ファイルシステムの更新ウィンドウを示すコンソールのスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/fsx/latest/WindowsGuide/images/fs-updates-panel.png)
スループット容量の更新アクションでは、次の情報を表示できます。
****[Update type]** (更新タイプ)**
可能な値は、**[スループットキャパシティ]** です。
****[Target value]** (ターゲット値)**
ファイルシステムのスループット容量を変更するのに望ましい値。
****[Status]** (ステータス)**
更新の現在のステータス。スループット容量の更新では、指定できる値は次のとおりです:
+ **[Pending]** (保留中) - Amazon FSx は更新リクエストを受信しましたが、処理を開始していません。
+ **[In progress]** (進行中) - Amazon FSx が更新リクエストを処理しています。
+ **[最適化の更新]** — Amazon FSx は、ファイルシステムのネットワーク I/O、CPU、メモリリソースを更新しました。新しいディスク I/O パフォーマンスレベルを書き込み操作に利用できます。読み取り操作では、ファイルシステムがこの状態ではなくなるまで、前のレベルと新しいレベル間でディスク I/O パフォーマンスが表示されます。
+ **[Completed]** (完了) - スループット容量の更新が正常に完了しました。
+ **[Failed]** (失敗) - スループット容量の更新に失敗しました。疑問符 (**?**) を選択して、スループットの更新が失敗した理由の詳細を確認します。
****[Request time]** (リクエストタイム)**
Amazon FSx が更新リクエストを受信した時刻。
## AWS CLI および API を使用した変更のモニタリング
[describe-file-systems](https://docs.aws.amazon.com/cli/latest/reference/fsx/describe-file-systems.html) CLI コマンドおよび [DescribeFileSystems](https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeFileSystems.html) API アクションを使用して、ファイルシステムのスループット容量変更リクエストを表示し、モニタリングできます。`AdministrativeActions` 配列には、管理アクションタイプごとに最新の更新アクションが 10 件を表示されます。ファイルシステムのスループット容量を変更すると、`FILE_SYSTEM_UPDATE` 管理アクションが生成されます。
次の例は、`describe-file-systems` CLI コマンドのレスポンスの抜粋を示しています。ファイルシステムのスループットキャパシティは 8 MBps、ターゲットスループットキャパシティは 256 MBps です。
```
.
.
.
"ThroughputCapacity": 8,
"AdministrativeActions": [
{
"AdministrativeActionType": "FILE_SYSTEM_UPDATE",
"RequestTime": 1581694764.757,
"Status": "PENDING",
"TargetFileSystemValues": {
"WindowsConfiguration": {
"ThroughputCapacity": 256
}
}
}
]
```
Amazon FSx でアクションの処理が正常に完了すると、ステータスは `COMPLETED` に変更されます。新しいスループット容量がファイルシステムで使用可能になり、`ThroughputCapacity` プロパティで表示されます。これは、**describe-file-systems** CLI コマンドの次のレスポンスの抜粋に示されています。
```
.
.
.
"ThroughputCapacity": 256,
"AdministrativeActions": [
{
"AdministrativeActionType": "FILE_SYSTEM_UPDATE",
"RequestTime": 1581694764.757,
"Status": "COMPLETED",
"TargetFileSystemValues": {
"WindowsConfiguration": {
"ThroughputCapacity": 256
}
}
}
]
```
スループット容量の変更が失敗した場合、ステータスは `FAILED` に代わり、`FailureDetails` プロパティは失敗に関する情報を提供します。失敗したアクションのトラブルシューティングについては、「[ストレージまたはスループットキャパシティの更新が失敗する](admin-actions-ts.md)」を参照してください。
# ネットワークタイプの管理
FSx for Windows ファイルシステムを作成する際には、ネットワークタイプを指定する必要があります。指定できるオプションは以下のいずれかです:
+ `IPv4` を使用すると、ファイルシステムはインターネットプロトコルバージョン 4 (IPv4) のみを使用して通信できます。
+ `Dual-stack` を使用すると、ファイルシステムはインターネットプロトコルバージョン 6 (IPv6) と IPv4 の両方を使用して通信できます。
既存の FSx for Windows ファイルシステムのネットワークタイプは、Amazon FSx マネジメントコンソール、AWS CLI、AWS API、またはいずれかの AWS SDKs を使用していつでも変更できます。例えば、サブネットが IPv4 と IPv6 の両方のアドレス指定をサポートしている場合、既存のファイルシステムを IPv4 専用 モードからデュアルスタックモードに更新できます。また、デュアルスタックファイルシステムを IPv4 専用 に更新することもできます。
## デュアルスタックモードの使用
IPv6 クライアントから Amazon FSx ファイルシステムにネイティブにアクセスして管理する必要がある場合は、デュアルスタックモードを使用する必要があります。デュアルスタックアドレッシングを使用するように Amazon FSx ファイルシステムを設定することで、同じ Amazon VPC、別のAWS アカウントの VPC、またはオンプレミスネットワーク内の IPv6 クライアントおよび IPv4 クライアントからファイルデータにアクセスできます。たとえば、Amazon FSx ファイルシステムがデュアルスタックを使用するように設定されている場合、既存の IPv4 クライアントと新しい IPv6 クライアントがファイルシステムに保存されているファイルデータにアクセスできるようになります。
デフォルトでは、Amazon FSx と Amazon VPC は IPv4 アドレス設定プロトコルを使用します。そのため、IPv6 を使用する前提条件として、Amazon FSx ファイルシステムで IPv6 を使用する前に、まず Amazon が提供する IPv6 クラスレスドメイン間範囲 (CIDR) ブロックを VPC とサブネットに割り当てる必要があります。VPC で IPv6 を有効にする方法については、*Amazon Virtual Private Cloud ユーザーガイド*」の「[VPC の IPv6 サポートを追加する](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-migrate-ipv6-add.html)」を参照してください。
## ネットワークタイプの変更
Amazon FSx コンソール、AWS Command Line Interface (AWS CLI)、または Amazon FSx APIを使用して、ファイルシステムのネットワークタイプを変更できます。
### ファイルシステムのネットワークタイプを変更するには (コンソール)
1. [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/) で Amazon FSx コンソールを開きます。
1. **[ファイルシステム]** に移動し、ネットワークタイプを変更する FSx for Windows ファイルシステムを選択します。
1. **[アクション]** で、**[ネットワークタイプの更新]** を選択します。または、**[ネットワークとセキュリティ]** パネルで、ファイルシステムの **[ネットワークタイプ]** の横にある **[管理]** を選択します。
**[ストレージタイプの更新]** ウィンドウが表示されます。
1. **[希望するネットワークタイプ]** で、**[IPv4]** または **[デュアルスタック]** を選択します。
+ `IPv4` を選択した場合、必要な設定はこれだけです。
+ `Dual-stack` を選択した場合は、ファイルシステムエンドポイントが使用する IPv6 アドレス範囲を指定します:
+ **[VPC からの未割り当ての IP アドレス範囲]** – Amazon FSx は、ファイルシステムのエンドポイント IPv6 アドレス範囲として使用するため、VPC の IPv6 CIDR 範囲から利用可能な/ 118 個の IP アドレスを選択します。
1. **[更新]** を選択します。
### ファイルシステムのネットワークタイプを変更する方法 (CLI)
+ FSx for ONTAP ファイルシステムの設定を更新するには、以下の例に示すように [update-file-system](https://docs.aws.amazon.com/cli/latest/reference/fsx/update-file-system.html) CLI コマンド (または同等のコマンド [UpdateFileSystem](https://docs.aws.amazon.com/fsx/latest/APIReference/API_UpdateFileSystem.html) API オペレーション) を使用します。
```
aws fsx update-file-system \
--file-system-id fs-0123456789abcdef0 \
--network-type DUAL
```
# Amazon FSx リソースのタグ付け
ファイルシステムやその他の FSx for Windows ファイルサーバーリソースを管理しやすくするために、独自のメタデータをタグの形式で各リソースに割り当てることができます。タグを使用すると、例えば用途別、所有者別、環境別などのさまざまな方法で AWS リソースを分類できます。これは同じタイプのリソースが多数ある場合に役立ちます。割り当てたタグに基づいて、特定のリソースをすばやく識別できます。このトピックでは、タグとその作成方法について説明します。
**Topics**
+ [タグの基本](#tag-basics)
+ [リソースのタグ付け](#tagging-your-resources)
+ [タグの制限](#tag-restrictions)
+ [リソースにタグを付けるために必要なアクセス許可](#tags-iam)
## タグの基本
タグとはAWS リソースに割り当てるラベルです。タグはそれぞれ、1 つのキーとオプションの 1 つの値で設定されており、どちらもお客様側が定義します。
タグを使用すると、例えば用途別、所有者別、環境別などのさまざまな方法で AWS リソースを分類できます。たとえば、アカウントの FSx for Windows File Server ファイルシステムに一連のタグを定義して、各インスタンスの所有者とスタックレベルを追跡できます。
各リソースタイプのニーズを満たす一連のタグキーを考案することをお勧めします。一貫性のある一連のタグキーを使用することで、リソースの管理が容易になります。追加したタグに基づいてリソースを検索およびフィルタリングできます。効果的なリソースのタグ付け戦略を実装する方法の詳細については、AWS ホワイトペーパーの [タグ付けのベストプラクティス](https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/welcome.html) を参照してください。
タグは Amazon FSx に対してセマンティックな意味は持たず、文字列として厳密に解釈されます。また、タグは自動的にリソースに割り当てられます。タグのキーと値は編集でき、タグはリソースからいつでも削除できます。タグの値を空の文字列に設定することはできますが、タグの値を null に設定することはできません。特定のリソースについて既存のタグと同じキーを持つタグを追加した場合、以前の値は新しい値によって上書きされます。リソースを削除すると、リソースのタグも削除されます。
FSx for Windows ファイルサーバー API、AWSCLI、またはAWS SDK を使用している場合は、`TagResource`API アクションを使用して既存のリソースにタグを適用できます。ースに適用できます。さらに、リソース作成アクションによってはリソースの作成時にリソースのタグを指定できます。リソースの作成時にタグを適用できない場合はリソース作成プロセスがロールバックされます。これにより、リソースがタグ付きで作成されるか、まったく作成されないようになるため、タグ付けされていないリソースが存在することがなくなります。作成時にリソースにタグ付けすることで、リソース作成後にカスタムタグ付けスクリプティングを実行する必要がなくなります。作成時にユーザーがリソースにタグ付けできるようにする方法については、「[リソース作成時にタグ付けするアクセス許可の付与](using-tags-fsx.md#supported-iam-actions-tagging)」を参照してください。
## リソースのタグ付け
アカウントに存在する FSx for Windows File Server リソースにタグ付けさせることができます。Amazon FSx コンソールを使用している場合は、関連するリソース画面のタグタブを使用して、リソースにタグを適用できます。リソースを作成するときは、Name キーに値を適用できます。また、新しいファイルシステムを作成するときに、選択したタグを適用できます。コンソールは Name タグに従ってリソースを整理できますが、このタグは FSx for Windows File Server サービスに対して意味を持ちません。
IAM ポリシーのタグベースのリソースレベルのアクセス権限を、作成時のタグ付けをサポートする FSx for Windows File Server API アクションに適用して、作成時にリソースにタグ付けできるユーザーとグループをきめ細かく制御できます。リソースは作成時から適切に保護されます。タグはリソースに即座に適用されるため、リソースの使用を制御するタグベースのリソースレベルアクセス権限がただちに有効になります。リソースはより正確に追跡および報告されます。新しいリソースにタグ付けの使用を適用し、リソースで設定されるタグキーと値をコントロールできます。
また、IAM ポリシーの`TagResource`および`UntagResource`FSx for Windows File Server API アクションにリソースレベルのアクセス許可を適用して、既存のリソースに設定するタグキーと値を制御することもできます。
請求用リソースへのタグ付けの詳細については*AWS Billing ユーザーガイド*の「[コスト配分タグの使用](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)」を参照してください。
## タグの制限
タグには以下のような基本制限があります。
+ リソースあたりのタグの最大数 - 50 件
+ タグキーはリソースごとにそれぞれ一意である必要があります。また、各タグキーに設定できる値は 1 つのみです。
+ キーの最大長 - UTF-8 の 128 Unicode 文字
+ 値の最大長 - UTF-8 の 256 Unicode 文字
+ FSx for Windows File Server タグで使用できる文字は、UTF-8 で表現可能な文字、数字、スペース、および\$1-=.\$1:/@です。
+ タグのキーと値は大文字と小文字が区別されます。
+ `aws:` プレフィックスは AWS 用に限定されています。タグにこのプレフィックスが付いたタグキーがある場合、タグのキーまたは値を編集、削除することはできません。`aws:` プレフィックスを持つタグは、リソースあたりのタグ数の制限にはカウントされません。
タグのみに基づいてリソースを削除することはできません。削除するには、リソース識別子を指定する必要があります。例えば、`DeleteMe` というタグキーでタグ付けされたファイルシステムを削除するには、fs-1234567890abcdef0 などのファイルシステムリソース識別子で `DeleteFileSystem` アクションを使用する必要があります。
公開リソースまたは共有リソースにタグを付ける場合、割り当てるタグは AWS アカウント でのみ使用できます。他の AWS アカウント はタグにアクセスできません。共有リソースへのタグベースのアクセスコントロールの場合、各 AWS アカウント は、リソースへのアクセスをコントロールするために独自のタグのセットを割り当てる必要があります。
## リソースにタグを付けるために必要なアクセス許可
作成時に Amazon FSx リソースにタグ付けする際に必要なアクセス許可の詳細については、「[リソース作成時にタグ付けするアクセス許可の付与](using-tags-fsx.md#supported-iam-actions-tagging)」を参照してください。タグを使用して IAM ポリシーで Amazon FSx リソースへのアクセスを制限する方法の詳細については、「[タグを使用した Amazon FSx リソースへのアクセスのコントロール](using-tags-fsx.md#restrict-fsx-access-tags)」を参照してください。
# を使用してファイルシステムを更新する AWS CLI
このチュートリアルの手順を使用して更新できる 3 つの要素があります。これら以外の更新可能なファイルシステムの要素は、すべてコンソールから更新できます。これらの手順は、ローカルコンピュータに AWS CLI がインストールされ、設定されていることを前提としています。詳細については、「*AWS Command Line Interface ユーザーガイド*」の「[インストール](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)と[設定](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)」を参照してださい。
+ **AutomaticBackupRetentionDays** - ファイルシステムの自動バックアップを保持する日数。
+ **DailyAutomaticBackupStartTime** - 日次自動バックアップ時間枠をスタートする協定世界時 (UTC) の時刻。期間はこの指定時刻から 30 分間です。この期間は、週 1 回のメンテナンスバックアップ時間枠と重複させることはできません。
+ **WeeklyMaintenanceStartTime** - メンテナンス時間枠をスタートする週の時刻。1 日目は月曜日、2 日目は火曜日というように続きます。この指定された時刻から 30 分間がウインドウになります。このウィンドウは毎日の自動バックアップ時間と重複させることはできません。
以下の手順では、ファイルシステムを AWS CLIで更新する方法を説明しています。
**ファイルシステムの自動バックアップ保持期間を更新するには**
1. コンピュータでコマンドプロンプトまたはターミナルを開きます。
1. 次のコマンドを実行し、ファイルシステム ID をユーザーのファイルシステムの ID に、そして自動バックアップを保持したい日数に置き換えます。
```
aws fsx update-file-system --file-system-id fs-0123456789abcdef0 --windows-configuration AutomaticBackupRetentionDays=30
```
**ファイルシステムの日次バックアップ期間を更新するには**
1. コンピュータでコマンドプロンプトまたはターミナルを開きます。
1. 次のコマンドを実行し、ファイルシステム ID をユーザーのファイルシステムの ID に置き換え、時刻をバックアップ期間を開始させたい時刻に置き換えます。
```
aws fsx update-file-system --file-system-id fs-0123456789abcdef0 --windows-configuration DailyAutomaticBackupStartTime=01:00
```
**ファイルシステムの毎週のメンテナンス期間を更新するには**
1. コンピュータでコマンドプロンプトまたはターミナルを開きます。
1. 次のコマンドを実行し、ファイルシステム ID をユーザーのファイルシステムの ID に、日時をメンテナンス期間を開始する日時に置き換えます。
```
aws fsx update-file-system --file-system-id fs-0123456789abcdef0 --windows-configuration WeeklyMaintenanceStartTime=1:01:30
```