本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 檔案分類 檔案分類會根據檔案的內容、位置或其他屬性，自動將中繼資料屬性指派給檔案。分類可協助您組織檔案、強制執行資料管理政策，以及識別包含敏感資訊、屬於特定商業類別或需要保留期間的檔案，以符合合規要求。 ## 檔案分類的運作方式 檔案分類使用三個步驟的程序： 1. **定義屬性** - 建立分類屬性定義，以指定您要指派給檔案的中繼資料類型，例如 `"Data Sensitivity"`或 `"ContainsPII"`。 1. **建立規則** - 設定分類規則，根據您指定的條件自動將屬性值指派給檔案，例如檔案內容模式或資料夾位置。例如，包含社會安全號碼等模式的檔案`(XXX-XX-XXXX)`可以自動分類為 `ContainsPII=Yes`。 1. **執行分類** - 執行分類程序以掃描檔案並套用規則。您可以視需要、排程或在背景持續執行分類。 分類完成後，您可以使用指派的屬性來產生儲存報告、套用 [檔案管理任務](fsrm-file-management.md)，或搜尋具有特定特性的檔案。 ## 分類屬性定義 分類屬性定義會指定可指派給檔案的中繼資料類型。每個屬性定義都有名稱、屬性類型，以及選用的允許值清單。例如，您可以使用 `OrderedList` 類型和可能的值來建立名為 `"Data Sensitivity"`的屬性：`Public`、`Confidential`、 `Internal`和 `Restricted`。 支援下列屬性類型： + `OrderedList` - 排序清單，其中值具有特定序列 （例如，低、中、高）。當值的順序對於報告或政策決策很重要時，請使用此類型。 + `MultiChoice` - 允許從清單中選取多個值 （例如，檔案可能同時標記「財務」和「法律」類別）。 + `SingleChoice` - 僅允許從清單中選取一個值。 + `String` - 沒有預先定義選項的單一文字值。 + `MultiString` - 沒有預先定義選項的多個文字值。 + `Integer` - 數值。 + `YesNo` - 布林值 (true 或 false)。 + `DateTime` - 日期和時間值。 屬性定義可在多個分類規則中重複使用。建立屬性定義之後，您可以在需要為該屬性指派值的任何分類規則中參考它。 ## 分類規則 分類規則會定義邏輯，以自動將屬性值指派給檔案。每個規則指定： + 要設定的屬性 + 要指派給該屬性的值 + 套用規則的位置 （哪些資料夾） + 如何識別應該接收屬性值的檔案。您可以使用兩種分類機制： ### 內容分類器 內容分類器會掃描特定文字模式或規則表達式的檔案內容。使用此機制根據檔案所包含的內容來識別檔案。內容分類器提供三種比對檔案內容的方式： + `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` + 電子郵件地址、電話號碼或其他結構化資料 您可以在單一規則中指定多個字串或模式，如果檔案的內容符合任何指定的值，則會分類檔案。 ### 資料夾分類器 資料夾分類器會根據檔案的儲存位置指派屬性值。使用此機制，依檔案在資料夾階層中的位置來分類檔案。例如： + 設定法務文件資料夾中所有檔案的保留期間屬性 + 使用專案識別符標記特定專案資料夾中的所有檔案 此外，您可以使用 `ReevaluateProperty` 參數來控制分類在具有 屬性值的檔案上執行時會發生的情況。您可以選取下列組態： + `Never` - 僅分類沒有此屬性值的檔案 + `Overwrite` - 當檔案變更時取代現有的值 + `Aggregate` - 結合新值與現有值 （適用於多值屬性） ## 管理屬性 管理屬性是套用至資料夾而非檔案的分類屬性。您可以使用管理屬性來整理和分類檔案系統階層中的資料夾。與透過分類規則自動指派的檔案屬性不同，您可以使用 ` Set-FSxFSRMMgmtProperty`命令手動設定管理屬性。 若要分類資料夾，請使用 `FolderUsage_MS` 屬性。您可以指定下列值： + `User Files` + `Group Share` + `Application Files` + `Backup and Archival` ## 執行分類 您可以透過三種方式執行檔案分類： 1. **手動分類** - [Start-FSxFSRMClassification](#start-fsxfsrmclassification)用於立即執行分類。此方法適用於測試新規則或執行一次性分類任務。 1. **排程分類** - [Set-FSxFSRMClassification](#set-fsxfsrmclassification)用來設定自動分類的排程。您可以排定每週或每月在特定時間執行分類。排程分類適用於您想要定期、可預測的分類執行的大多數生產環境。 1. **持續分類** - [Set-FSxFSRMClassification](#set-fsxfsrmclassification)搭配 `Continuous` 參數使用 ，以啟用持續執行的背景分類。持續分類會在新檔案和修改後檔案建立或變更後不久自動分類。此方法提供up-to-date分類，但會耗用更多系統資源。 當您開始分類時，您可以指定 `RunDuration`來限制程序執行的時間長度。如果分類未在指定的時間內完成，它會在下一次排定的執行期間或當您再次手動啟動時停止並繼續。 分類完成後，您可以在 Windows File Explorer 中的檔案上按一下滑鼠右鍵，選取屬性，然後選擇分類索引標籤，以檢視指派給檔案的**分類****屬性**。此索引標籤會顯示檔案的所有分類屬性及其值。 ## 分類程序管理 您可以使用下列命令來監控和控制分類程序： + [Get-FSxFSRMClassification](#get-fsxfsrmclassification) - 檢查分類的目前狀態 (`Running`、`NotRunning`、 `Queued`或 `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 命令系列來管理檔案分類： 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`：可能值的單一選擇 + `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`：從您的檔案系統擷取一或多個分類屬性定義。 **參數：** + `Name (array)` - 選用。要擷取的屬性定義名稱陣列。如果您未指定名稱，命令會傳回檔案系統上的所有屬性定義。 **範例**： **1。擷取檔案系統上的所有分類屬性定義。** ``` Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock { Get-FSxFSRMClassificationPropertyDefinition } ``` #### Set-FSxFSRMClassificationPropertyDefinition 修改現有分類屬性定義的屬性。 ##### Parameters + `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 從檔案系統移除一或多個分類屬性定義。只能移除本機定義的屬性定義。 ##### Parameters + `Name (array)` - 必要。要移除的屬性名稱陣列。 + `PassThru (boolean)` - 選用。如果設定為 true， 會傳回移除的屬性定義物件。 **範例**： 1. 移除單一屬性定義。 ``` Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock { Remove-FSxFSRMClassificationPropertyDefinition -Name "RiskLevel" -PassThru } ``` ### 分類規則命令 #### New-FSxFSRMClassificationRule 建立自動分類規則，根據指定的條件將屬性值指派給檔案。每個規則都會為單一屬性設定值。 ##### Parameters + `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`：掃描特定字串或規則表達式模式的檔案內容。當您指定內容分類器時，您可以使用 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 從檔案系統擷取一或多個分類規則。 ##### Parameters + `Name (array)` - 選用。要擷取的分類規則名稱陣列。如果您未指定名稱，命令會傳回檔案系統上的所有規則。 **範例**： 1. 擷取檔案系統上的所有分類規則。 ``` Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock { Get-FSxFSRMClassificationRule } ``` ##### Set-FSxFSRMClassificationRule 修改現有分類規則的屬性。 ##### Parameters + `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`：掃描特定字串或規則表達式模式的檔案內容。當您指定內容分類器時，您可以使用 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 從您的檔案系統移除一或多個分類規則。 ##### Parameters + `Name (array)` - 必要。要移除的分類規則名稱陣列。 + `PassThru (boolean)` - 選用。如果設定為 true， 會傳回移除的規則物件。 **範例**： 1. 移除單一分類規則。 ``` Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock { Remove-FSxFSRMClassificationRule -Name "Find Confidential Files" -PassThru } ``` ### 管理屬性命令 #### Get-FSxFSRMMgmtProperty 從指定的資料夾擷取管理屬性。管理屬性是套用至資料夾而非檔案的分類屬性。 ##### Parameters + `Namespace (string)` - 選用。資料夾的路徑。 + `Name (string)` - 選用。要擷取的管理屬性名稱。如果您未指定名稱，命令會擷取所有管理屬性。 + `Recurse (boolean)` - 選用。如果設定為 true， 會擷取命名空間內所有資料夾的管理屬性。需要 命名空間參數。 + `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 從指定的資料夾移除管理屬性。 ##### Parameters + `Namespace (string)` - 選用。資料夾的路徑。 + `Name (string)` - 必要。要移除的管理屬性名稱。 + `Recurse (boolean)` - 選用。如果設定為 true， 會移除命名空間內所有資料夾的管理屬性。需要 命名空間參數。 **範例**： 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 變更指定命名空間的管理屬性值。管理屬性是套用至資料夾的分類屬性，且未設定安全旗標。 ##### Parameters + `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`：分類目前正在進行中 ##### Parameters 無 **範例**： 1. 擷取目前的分類狀態。 ``` Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock { Get-FSxFSRMClassification } ``` #### Start-FSxFSRMClassification 啟動檔案分類程序，將分類規則套用至檔案並產生分類報告。 ##### Parameters + `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 停止檔案系統上任何執行中或已排入佇列的分類任務。 ##### Parameters 無 **範例**： 1. 停止執行中的分類。 ``` Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock { Stop-FSxFSRMClassification } ``` #### Wait-FSxFSRMClassification 等待檔案分類程序完成。當您需要執行取決於分類完成的動作時，例如根據分類檔案產生報告時，請使用此命令。 ##### Parameters + `Timeout (number)` - 選用。指定分類完成的等待時間，以秒為單位。如果逾時在分類完成之前過期，則命令會傳回 ，但分類會在背景中繼續執行。有效值：`-1` 到 `2147483`。特殊值： + `-1`：無限期等待分類完成 （預設） + `0`：檢查目前狀態並立即傳回，無需等待 **範例**： 1. 無限期等待分類完成。 ``` Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock { Wait-FSxFSRMClassification } ``` #### Set-FSxFSRMClassification 修改檔案分類的組態設定。 ##### Parameters + `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 } ```