翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# クォータ管理
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
}
```