本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 儲存報告
<a name="fsrm-storage-reports"></a>

儲存報告提供檔案系統用量的詳細分析，協助您了解儲存的使用方式、識別可封存或刪除的檔案，以及監控檔案管理政策的合規性。您可以產生多種類型的報告，以分析檔案所有權、檔案類型、重複檔案、大型檔案、檔案篩選和配額用量。

## 報告類型
<a name="fsrm-storage-reports-types"></a>

您可以建立下列報告類型：
+ `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)用量統計資料。使用此報告來監控配額合規性，並識別接近配額限制的資料夾。

## 報告格式
<a name="fsrm-storage-reports-formats"></a>

您可以產生多種格式的報告，以符合不同的使用案例：
+ `DHTML` - 動態 HTML 格式，具有排序和篩選等互動式功能。
+ `HTML` - 適合封存或傳送電子郵件的靜態 HTML 格式。
+ `XML` - 用於程式設計處理的結構化資料格式。
+ `CSV` - 用於匯入試算表應用程式的逗號分隔值格式。
+ `Text` - 用於簡單檢視或處理的純文字格式。

您可以為單一報告指定多種格式。

## 互動式和排程報告
<a name="fsrm-storage-reports-interactive-scheduled"></a>

您可以建立兩種類型的儲存報告：

1. **互動式報告** - 建立時立即執行，且僅執行一次。使用互動式報告進行臨機操作分析或故障診斷。互動式報告沒有排程，無法在建立後修改。若要執行另一個互動式報告，您必須使用不同的名稱建立新的報告。

1. **排程報告** - 根據設定的排程自動執行。使用排程報告進行定期監控和合規報告。您可以排定報告在特定時間每週或每月執行。排程報告可以修改以變更其組態，您也可以使用 [Start-FSxFSRMStorageReport](#start-fsxfsrmstoragereport)命令隨需執行，而無需等待排程時間。

## 執行報告
<a name="fsrm-storage-reports-running"></a>

建立排程報告之後，您可以透過多種方式執行報告：
+ **自動執行** - 排程報告會在設定的排程時間自動執行。
+ **手動執行** - [Start-FSxFSRMStorageReport](#start-fsxfsrmstoragereport)用於隨需執行排程報告，而無需等待排程時間。

您可以使用 監控報告執行，[Get-FSxFSRMStorageReport](#get-fsxfsrmstoragereport)以檢查狀態。

## 存取儲存報告
<a name="fsrm-storage-reports-accessing"></a>

FSRM 產生儲存報告後，報告檔案會儲存到檔案系統的預設位置。若要存取這些報告，您需要映射檔案系統的管理 D\$1 共用。

**存取儲存報告**

1. 使用下列路徑格式映射管理 D\$1 共用：

   ```
   \\file-system-dns-name\D$
   ```

   例如：

   ```
   \\amznfsxaa11bb22.corp.example.com\D$
   ```

1. 導覽至 StorageReports 資料夾。此資料夾包含依報告類型和執行日期整理的子資料夾。

**注意**  
存取管理 D\$1 共享需要管理員登入資料。

## 儲存報告最佳實務
<a name="fsrm-storage-reports-best-practices"></a>

遵循這些最佳實務，以確保有效率且有效的儲存報告：

### 效能考量
<a name="fsrm-storage-reports-performance"></a>

儲存報告產生需要大量資源，因為 FSRM 必須掃描大量檔案。
+ **限制報告範圍** - 使用 `Namespace` 參數將報告限制在特定資料夾，而不是掃描整個檔案系統。掃描大型目錄結構需要大量資源，可能需要數小時才能完成。
+ **在離峰時間排程報告** - 在低系統活動期間執行排程報告，以將對效能的影響降至最低。避免在備份時段或其他維護任務期間執行報告。
+ **設定合理的閾值** - 使用閾值參數將報告輸出限制為可操作的資料。例如，將 `LargeFileMinimum`設定為可識別值得調查的檔案的值，而不是每個超過 1MB 的檔案。
+ **使用 RunDuration 限制** - 設定 `RunDuration` 參數以防止報告執行太長並影響系統效能。如果報告未在時間限制內完成，則會在下一次排定的執行期間繼續。
+ **監控報告效能** - [Get-FSxFSRMStorageReport](#get-fsxfsrmstoragereport)用於檢查報告完成所需的時間。如果報告持續需要太長時間，請考慮縮小範圍或減少執行頻率。

### 報告設計
<a name="fsrm-storage-reports-design"></a>
+ **使用描述性名稱** - 提供報告清晰的描述性名稱，指出它們分析的內容和執行時間，例如「每週大型檔案 - 財務共享」或「每月重複檔案 - 所有共享」。
+ **合併相關分析** - 為相同的命名空間產生多個報告類型時，請使用多個`ReportType`值建立單一報告，而非個別的報告。這更有效率，因為 FSRM 只需要掃描目錄結構一次。
+ **依檔案模式篩選** - 使用檔案模式參數來專注於特定檔案類型的報告。例如，分析大型檔案時，您可以為影片檔案、資料庫檔案和封存檔案建立個別報告，以進一步了解儲存體使用模式。
+ **利用分類屬性** - 使用`FilesByProperty`報告根據檔案的分類來分析檔案。這可提供更有意義的洞見。

### 報告管理
<a name="fsrm-storage-reports-management"></a>
+ **定期檢閱報告** - 排定時間檢閱報告結果並對問題清單採取動作。報告只有在您使用它們來做出儲存管理決策時才有價值。
+ **封存舊報告** - 報告檔案會隨著時間累積並耗用儲存空間。為報告檔案建立保留政策，並刪除或封存不再需要的舊報告。
+ **排程前測試報告** - 建立互動式報告以測試報告組態，並在建立排程版本之前驗證它們產生預期的結果。

## 儲存報告管理命令
<a name="fsrm-storage-reports-commands"></a>

您可以存取兩個 FSx 遠端 PowerShell 命令系列來管理儲存報告：

1. **報告定義命令** - 建立、擷取、修改和移除儲存報告組態，以指定要分析哪些資料、何時執行報告，以及要產生的格式。

1. **報告執行命令** - 開始、停止、監控和等待產生儲存報告。使用這些命令可隨需執行報告，或管理長時間執行的報告任務。

### Storage Report FSx 遠端 PowerShell 命令的清單
<a name="fsrm-storage-reports-powershell-commands"></a>

**注意**  
此頁面中的所有範例都假設您已使用檔案系統的 Windows Remote PowerShell 端點定義 ` $FSxWindowsRemotePowerShellEndpoint`變數。您可以在檔案系統的詳細資訊頁面上的 Amazon FSx 主控台中找到此端點，或使用 AWS CLI `describe-file-systems`命令。

### 報告定義命令
<a name="fsrm-storage-reports-definition-commands"></a>

#### New-FSxFSRMStorageReport
<a name="new-fsxfsrmstoragereport"></a>

**New-FSxFSRMStorageReport**：建立儲存報告，分析指定的目錄以產生一或多個報告類型。

 **參數：**
+ `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
<a name="get-fsxfsrmstoragereport"></a>

**Get-FSxFSRMStorageReport**：從您的檔案系統擷取一或多個儲存報告。傳回報告組態和狀態的詳細資訊。

 **參數：**
+ `Name (array)` - 選用。要擷取的報告名稱陣列。如果您未指定名稱，命令會傳回檔案系統上的所有儲存報告。

 **範例**：

1. 擷取檔案系統上的所有儲存報告。

```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Get-FSxFSRMStorageReport
}
```

#### Remove-FSxFSRMStorageReport
<a name="remove-fsxfsrmstoragereport"></a>

**Remove-FSxFSRMStorageReport**：從您的檔案系統移除一或多個儲存報告。您無法移除目前正在執行的報告。

 **參數：**
+ `Name (array)` - 必要。要移除的報告名稱陣列。
+ `PassThru (boolean)` - 選用。如果設定為 true， 會傳回移除的報告物件。

 **範例**：

1. 移除單一儲存報告。

```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Remove-FSxFSRMStorageReport -Name "Monthly Report" -PassThru 
}
```

#### Set-FSxFSRMStorageReport
<a name="set-fsxfsrmstoragereport"></a>

##### Parameters
<a name="set-fsxfsrmstoragereport-parameters"></a>
+ `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， 會傳回修改的報告物件。

##### 報告特定參數
<a name="report-specific-parameters"></a>
+ `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 報告，指定要包含的最低配額用量百分比。

##### 範例：
<a name="set-fsxfsrmstoragereport-example"></a>

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 
}
```

### 報告執行命令
<a name="report-execution-commands"></a>

#### Start-FSxFSRMStorageReport
<a name="start-fsxfsrmstoragereport"></a>

##### Parameters
<a name="start-fsxfsrmstoragereport-parameters"></a>
+ `Name (array)` - 必要。要啟動的報告名稱陣列。
+ `Queue (boolean)` - 選用。如果設定為 true， 會將報告新增至佇列，以便在接下來的 5 分鐘內執行。在此期間排入佇列的任何報告都會一起執行。如果設定為 false 或未指定，則報告會立即開始。
+ `RunDuration (number)` - 選用。指定報告在取消之前應執行多少小時。有效值：`-1` 到 `2147483`。特殊值：
  + `0`：執行 以完成
  + `-1`：執行 直到取消

  如果未指定， 會執行 直到完成。

##### 範例
<a name="start-fsxfsrmstoragereport-examples"></a>

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
<a name="stop-fsxfsrmstoragereport"></a>

##### Parameters
<a name="stop-fsxfsrmstoragereport-parameters"></a>
+ `Name (array)` - 必要。要停止的報告名稱陣列。

##### 範例：
<a name="stop-fsxfsrmstoragereport-example"></a>

1. 停止單一儲存報告。

```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Stop-FSxFSRMStorageReport -Name "Monthly Report"
}
```

#### Wait-FSxFSRMStorageReport
<a name="wait-fsxfsrmstoragereport"></a>

##### Parameters
<a name="wait-fsxfsrmstoragereport-parameters"></a>
+ `Name (array)` - 必要。要等待的報告名稱陣列。
+ `Timeout (number)` - 選用。指定報告完成的等待時間，以秒為單位。如果逾時在報告完成之前過期，命令會傳回 ，但報告產生會在背景中繼續執行。有效值：`-1` 到 `2147483`。特殊值：
  + `-1`：無限期等待直到報告完成 （預設）
  + `0`：檢查目前狀態並立即傳回，無需等待

##### 範例：
<a name="wait-fsxfsrmstoragereport-example"></a>

1. 無限期等待儲存報告完成。

```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Wait-FSxFSRMStorageReport -Name "Monthly Report"
}
```