儲存報告

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

報告類型

您可以建立下列報告類型：

• DuplicateFiles

  根據檔案大小和雜湊比較，識別具有相同內容的檔案。使用此報告來尋找耗用不必要的儲存空間的備援檔案。報告會將重複的檔案分組在一起，並顯示可透過移除重複項目來復原的總空間。

• FilesByFileGroup

  依檔案群組成員資格將檔案分組，並顯示每個檔案群組的儲存使用量。使用此報告來了解哪些類型的檔案 （文件、媒體、可執行檔等） 會耗用最多的儲存空間。

• FilesByOwner

  依擁有者分組檔案，並顯示每個使用者或群組使用的儲存空間。使用此報告來識別耗用最多儲存空間的使用者，並適當地配置儲存成本或配額。

• FilesByProperty

  依屬性值分類檔案，並顯示每個屬性值的檔案計數和儲存體耗用。使用此報告根據檔案的分類進行分析，例如資料敏感程度、部門或保留期。此報告需要使用 分類檔案分類規則。

• FileScreenAuditFiles

  列出使用者嘗試儲存作用中檔案畫面封鎖之檔案的檔案篩選違規。使用此報告來監控檔案篩選政策的合規性，並識別經常嘗試儲存未經授權檔案類型的使用者。

• FoldersByProperty

  依管理屬性值將資料夾分組，並顯示每個屬性值的儲存耗用量。使用此報告依資料夾用途分析儲存體用量，例如使用者檔案、群組共用或應用程式檔案。

• LargeFiles

  列出超過指定大小閾值的檔案。使用此報告來識別耗用大量儲存空間的檔案，這些檔案可能是封存、壓縮或刪除的候選項目。

• LeastRecentlyAccessed

  列出指定天數內未存取的檔案。使用此報告來識別可以封存或移至低成本儲存層的非作用中檔案。

• MostRecentlyAccessed

  列出在指定天數內存取的檔案。

• QuotaUsage

  顯示已設定配額之資料夾的配額用量統計資料。使用此報告來監控配額合規性，並識別接近配額限制的資料夾。

報告格式

您可以產生多種格式的報告，以符合不同的使用案例：

• DHTML - 動態 HTML 格式，具有排序和篩選等互動式功能。

• HTML - 適合封存或傳送電子郵件的靜態 HTML 格式。

• XML - 用於程式設計處理的結構化資料格式。

• CSV - 用於匯入試算表應用程式的逗號分隔值格式。

• Text - 用於簡單檢視或處理的純文字格式。

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

互動式和排程報告

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

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

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

執行報告

建立排程報告之後，您可以透過多種方式執行報告：

• 自動執行 - 排程報告會在設定的排程時間自動執行。

• 手動執行 - Start-FSxFSRMStorageReport用於隨需執行排程報告，而無需等待排程時間。

您可以使用 監控報告執行，Get-FSxFSRMStorageReport以檢查狀態。

存取儲存報告

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

存取儲存報告

1. 使用下列路徑格式對應管理 D$ 共用：

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

   例如：

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

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

注意

存取管理 D$ 共享需要管理員登入資料。

儲存報告最佳實務

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

效能考量

儲存報告產生需要大量資源，因為 FSRM 必須掃描大量檔案。

• 限制報告範圍 - 使用 Namespace 參數將報告限制在特定資料夾，而不是掃描整個檔案系統。掃描大型目錄結構需要大量資源，可能需要數小時才能完成。

• 在離峰時間排程報告 - 在低系統活動期間執行排程報告，將對效能的影響降至最低。避免在備份時段或其他維護任務期間執行報告。

• 設定合理的閾值 - 使用閾值參數將報告輸出限制為可操作的資料。例如，LargeFileMinimum將 設定為識別值得調查的檔案的值，而不是每個超過 1MB 的檔案。

• 使用 RunDuration 限制 - 設定 RunDuration 參數以防止報告執行太長並影響系統效能。如果報告未在時間限制內完成，則會在下一次排定的執行期間繼續。

• 監控報告效能 - Get-FSxFSRMStorageReport用來檢查報告完成所需的時間。如果報告持續需要太長的時間，請考慮縮小範圍或減少執行頻率。

報告設計

• 使用描述性名稱 - 提供報告清晰的描述性名稱，指出它們分析的內容和執行時間，例如「每週大型檔案 - 財務共享」或「每月重複檔案 - 所有共享」。

• 合併相關分析 - 為相同命名空間產生多個報告類型時，請使用多個ReportType值建立單一報告，而非個別的報告。這更有效率，因為 FSRM 只需要掃描目錄結構一次。

• 依檔案模式篩選 - 使用檔案模式參數來專注於特定檔案類型的報告。例如，分析大型檔案時，您可以建立影片檔案、資料庫檔案和封存檔案的個別報告，以進一步了解儲存體耗用模式。

• 利用分類屬性 - 使用FilesByProperty報告根據檔案的分類來分析檔案。這可提供更有意義的洞見。

報告管理

• 定期檢閱報告 - 排定時間檢閱報告結果，並對問題清單採取動作。報告只有在您使用它們來做出儲存管理決策時才有價值。

• 封存舊報告 - 報告檔案會隨著時間累積並耗用儲存空間。為報告檔案建立保留政策，並刪除或封存不再需要的舊報告。

• 排程前測試報告 - 建立互動式報告以測試報告組態，並在建立排程版本之前驗證它們產生預期結果。

儲存報告管理命令

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

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

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

Storage Report FSx 遠端 PowerShell 命令的清單

注意

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

報告定義命令

New-FSxFSRMStorageReport

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

參數：

• Name (string) - 必要。儲存報告的名稱。

• Namespace (array) - 必要。要分析的路徑或資料夾類型的陣列。您可以指定多種格式的路徑：

  • 資料夾路徑

  • 資料夾分類。例如，【FolderUsage_MS="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：從您的檔案系統擷取一或多個儲存報告。傳回報告組態和狀態的詳細資訊。

參數：

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

範例：

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

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

Remove-FSxFSRMStorageReport

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

參數：

• Name (array) - 必要。要移除的報告名稱陣列。

• PassThru (boolean) - 選用。如果設定為 true， 會傳回移除的報告物件。

範例：

1. 移除單一儲存報告。

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

Set-FSxFSRMStorageReport

Parameters

• Name (array) - 必要。要修改的報告名稱陣列。

• Namespace (array) - 選用。要分析的路徑或資料夾類型陣列。您可以指定多種格式的路徑：

  • 資料夾路徑

  • 資料夾分類。例如，【FolderUsage_MS="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

Parameters

• 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

Parameters

• Name (array) - 必要。要停止的報告名稱陣列。

範例：

1. 停止單一儲存報告。

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

Wait-FSxFSRMStorageReport

Parameters

• Name (array) - 必要。要等待的報告名稱陣列。

• Timeout (number) - 選用。指定報告完成的等待時間，以秒為單位。如果逾時在報告完成之前過期，則命令會傳回 ，但報告產生會在背景中繼續執行。有效值：-1 到 2147483。特殊值：

  • -1：無限期等待直到報告完成 （預設）

  • 0：檢查目前狀態並立即傳回，無需等待

範例：

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

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