本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 文件分类
文件分类根据文件的内容、位置或其他属性自动为文件分配元数据属性。分类可以识别包含敏感信息、属于特定业务类别或需要保留期的文件，从而帮助您整理文件、强制执行数据管理策略并满足合规性要求。
## 文件分类的工作原理
文件分类使用三个步骤的过程：
1. **定义属性**-创建分类属性定义来指定要分配给文件的元数据类型，例如`"Data Sensitivity"`或`"ContainsPII"`。
1. **创建规则**-配置分类规则，根据您指定的标准（例如文件内容模式或文件夹位置）自动为文件分配属性值。例如，包含诸如社会安全号码之类的模式的文件`(XXX-XX-XXXX)`可以自动归类为`ContainsPII=Yes`。
1. **运行分类**-执行分类过程以扫描文件并应用规则。您可以按需手动运行分类，也可以按计划运行分类，也可以在后台连续运行分类。
分类完成后，您可以使用分配的属性来生成存储报告[文件管理任务](fsrm-file-management.md)、应用或搜索具有特定特征的文件。
## 分类属性定义
分类属性定义指定可以分配给文件的元数据类型。每个属性定义都有一个名称、一个属性类型和一个允许值的列表（可选）。例如，您可以创建一个名为的属性，`"Data Sensitivity"`其`OrderedList`类型和可能的值为：`Public``Internal`、`Confidential`、和`Restricted`。
支持以下属性类型：
+ `OrderedList`-一个有序列表，其中值具有特定的序列（例如，低、中、高）。当值的顺序对报告或政策决策很重要时，请使用此类型。
+ `MultiChoice`-允许从列表中选择多个值（例如，文件可能同时标有 “财务” 和 “法律” 类别）。
+ `SingleChoice`-仅允许从列表中选择一个值。
+ `String`-没有预定义选项的单个文本值。
+ `MultiString`-多个文本值，没有预定义选项。
+ `Integer`-一个数值。
+ `YesNo`-布尔值（真或假）。
+ `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`-将新值与现有值合并（适用于多值属性）
## 管理属性
管理属性是应用于文件夹而不是文件的分类属性。您可以使用管理属性来组织和分类文件系统层次结构中的文件夹。与通过分类规则自动分配的文件属性不同，您可以使用` 设置-FSx FSRMMgmt 属性`命令手动设置管理属性。
要对文件夹进行分类，请使用`FolderUsage_MS`属性。可以指定以下值：
+ `User Files`
+ `Group Share`
+ `Application Files`
+ `Backup and Archival`
## 跑步分类
您可以通过三种方式运行文件分类：
1. **手动分类**-[开始-FSx FSRMClassification](#start-fsxfsrmclassification) 用于立即运行分类。这种方法对于测试新规则或执行一次性分类任务非常有用。
1. **计划分类**-[Set-FSx FSRMClassification](#set-fsxfsrmclassification) 用于配置自动分类的时间表。您可以将分类安排为每周或每月在特定时间运行。计划分类适用于大多数需要定期、可预测的分类运行的生产环境。
1. **连续分类**-与`Continuous`参数[Set-FSx FSRMClassification](#set-fsxfsrmclassification)一起使用可启用连续运行的背景分类。连续分类会在新文件和修改文件创建或更改后不久自动对其进行分类。这种方法提供的 up-to-date分类最多，但会消耗更多的系统资源。
开始分类时，可以指定 a `RunDuration` 来限制该过程的运行时间。如果分类未在指定时间内完成，则分类将在下次计划运行期间或您再次手动启动时停止并恢复。
分类完成后，您可以在 Windows 文件资源管理器中右键单击文件，选择 “属性”，然后选择 “分类” 选项卡，来查看分配给文件的**分类****属性**。此选项卡显示文件的所有分类属性及其值。
## 分类流程管理
您可以使用以下命令监视和控制分类过程：
+ [Get-FSx FSRMClassification](#get-fsxfsrmclassification)-查看分类的当前状态（`Running``Queued`、`NotRunning`、或`Unknown`）
+ [停下来-FSx FSRMClassification](#stop-fsxfsrmclassification)-停止正在运行或排队的分类作业
+ [等等-FSx FSRMClassification](#wait-fsxfsrmclassification)-暂停脚本执行，直到分类完成或超时到期
使用这些命令将分类与其他任务协调起来。例如，您可以等待分类完成后再生成依赖于保密文件属性的存储报告。
## 分类最佳实践
请遵循这些最佳实践，以确保高效和有效的文件分类。
### 1. 性能注意事项
基于内容的分类是资源密集型的，因为 FSRM 必须读取和扫描文件内容。
+ **首先在小型数据集上测试规则**-在将分类规则应用于整个文件系统之前，请在具有代表性的文件样本上对其进行测试，以验证它们是否按预期工作，并估计分类需要多长时间。
+ **限制内容扫描范围**-基于内容的分类是资源密集型的，因为它需要读取文件内容。使用`Namespace`参数将规则限制在特定的文件夹，而不是扫描整个文件系统。
+ **尽可能使用文件夹分类**-文件夹分类器比内容分类器快得多，因为它不需要读取文件内容。当可以根据文件位置对文件进行分类时，请使用文件夹分类器而不是内容分类器。
+ **在非高峰时段安排分类**-在系统活动较少的时段运行计划分类，以最大限度地减少对用户性能的影响。避免在备份窗口或其他维护任务期间运行分类。
+ **设置适当的 RunDuration 限制**-使用`RunDuration`参数可防止分类运行时间过长并影响系统性能。如果分类未在时限内完成，则将在下一次计划运行期间恢复。
+ **监控分类性能**-` Get-FSxFSRMClassification` 用于检查分类状态并确定分类所需的时间是否超过预期。长期运行的分类可能表明需要优化规则或系统需要更多资源。
### 2. 规则设计
+ **使用特定的正则表达式**-使用时`ContentRegularExpression`，写出尽可能具体的模式以避免错误匹配。在生产环境中部署正则表达式之前，请对其进行全面测试。
+ **有效地组合多个模式**-与其为相似的模式创建单独的规则，不如将它们组合成具有多个`ContentString`或`ContentRegularExpression`值的单个规则。这减少了 FSRM 需要扫描每个文件的次数。
+ **排除不必要的文件夹**-`Set-FSxFSRMClassification` 使用中的`ExcludeNamespace`参数排除临时目录和其他不需要分类的位置。
### 3. 物业管理
+ **规划您的属性架构**-在创建规则之前设计您的分类属性。考虑报告、合规性和文件管理策略需要哪些属性。
+ **文档属性定义**-使用 “描述” 字段解释每个属性的含义以及应如何使用。这可以帮助其他管理员了解您的分类架构。
### 4. 持续维护
+ **定期查看分类结果**-生成存储报告，以验证分类是否按预期运行，以及文件接收的属性值是否正确。
+ **根据需要更新规则**-随着组织数据管理要求的变化，更新分类规则以反映新的政策或合规性要求。
+ **清理未使用的属性**-删除不再需要的属性定义和规则，以保持分类配置的可管理性。
## 分类管理命令
您可以访问四个系列的 FSx 远程 PowerShell 命令来管理文件分类：
1. **属性定义命令**-创建和管理分类属性定义，用于指定可以分配给文件的元数据类型。
1. **分类规则命令**-创建和管理根据文件内容或位置分配属性值的自动分类规则。
1. **管理属性命令**-设置和检索文件夹（而不是文件）的分类属性。
1. **分类过程命令**-启动、停止、监控和配置分类过程。
### 文件分类 FSx 远程 PowerShell 命令列表
**注意**
本页中的所有示例都假设您已经使用文件系统的 Windows Remote PowerShell 端点定义了该` $FSxWindowsRemotePowerShellEndpoint`变量。您可以在文件系统的详细信息页面上的 Amazon FSx 控制台中找到此终端节点，也可以使用 AWS CLI `describe-file-systems`命令找到此终端节点。
### 属性定义命令
#### 新-FSx FSRMClassification PropertyDefinition
`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" }
)
}
```
#### 获取-FSx FSRMClassification PropertyDefinition
`Get-FSxFSRMClassificationPropertyDefinition`：从您的文件系统中检索一个或多个分类属性定义。
**参数：**
+ `Name (array)` – 可选。要检索的属性定义名称数组。如果未指定名称，则该命令将返回文件系统上的所有属性定义。
**示例：**
**1。检索文件系统上的所有分类属性定义。**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMClassificationPropertyDefinition
}
```
#### 套装-FSx FSRMClassification PropertyDefinition
修改现有分类属性定义的属性。
##### 参数
+ `Name (array)` – 必需。要修改的属性名称数组。
+ `DisplayName (string)` – 可选。属性定义的新显示名称。
+ `Description (string)` – 可选。属性定义的新描述。
+ `PossibleValueConfigurations (array)` – 可选。 OrderedList、 MultiChoice或 SingleChoice 属性的新配置阵列。每种配置都具有以下属性：
+ `Name (string)`: 值的名称（必填）
+ `Description (string)`: 值的描述（可选）
+ `Parameters (array)` – 可选。“名称=值” 格式的新字符串数组。
+ `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
}
```
#### 删除-FSx FSRMClassification PropertyDefinition
从文件系统中移除一个或多个分类属性定义。只能删除本地定义的属性定义。
##### 参数
+ `Name (array)` – 必需。要删除的属性名称数组。
+ `PassThru (boolean)` – 可选。如果设置为 true，则返回已删除的属性定义对象。
**示例：**
1. 移除单个属性定义。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Remove-FSxFSRMClassificationPropertyDefinition -Name "RiskLevel" -PassThru
}
```
### 分类规则命令
#### 新-FSx FSRMClassification 规则
创建自动分类规则，根据指定的标准为文件分配属性值。每条规则都为单个属性设置一个值。
##### 参数
+ `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-FSx FSRMClassification 规则
从您的文件系统中检索一个或多个分类规则。
##### 参数
+ `Name (array)` – 可选。要检索的分类规则名称数组。如果您未指定名称，则该命令将返回文件系统上的所有规则。
**示例：**
1. 检索文件系统上的所有分类规则。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMClassificationRule
}
```
##### 设定-FSx FSRMClassification 规则
修改现有分类规则的属性。
##### 参数
+ `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"
}
```
##### 移除-FSx FSRMClassification 规则
从您的文件系统中移除一条或多条分类规则。
##### 参数
+ `Name (array)` – 必需。要删除的分类规则名称数组。
+ `PassThru (boolean)` – 可选。如果设置为 true，则返回已删除的规则对象。
**示例：**
1. 移除单个分类规则。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Remove-FSxFSRMClassificationRule -Name "Find Confidential Files" -PassThru
}
```
### 管理属性命令
#### 获取-FSx FSRMMgmt 属性
从指定文件夹检索管理属性。管理属性是应用于文件夹而不是文件的分类属性。
##### 参数
+ `Namespace (string)` – 可选。文件夹的路径。
+ `Name (string)` – 可选。要检索的管理属性的名称。如果您未指定名称，则该命令将检索所有管理属性。
+ `Recurse (boolean)` – 可选。如果设置为 true，则检索命名空间内所有文件夹的管理属性。需要命名空间参数。
+ `Effective (boolean)` – 可选。如果设置为 true，则检索最近具有指定名称的文件夹的管理属性。搜索包括指定的命名空间及其父层次结构。需要名称参数。
**示例：**
1. 检索文件系统上的所有管理属性。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMMgmtProperty
}
```
2. 检索特定文件夹的管理属性。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMMgmtProperty -Namespace "share\department"
}
```
#### 移除-FSx FSRMMgmt 属性
从指定文件夹中移除管理属性。
##### 参数
+ `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"
}
```
#### 设置-FSx FSRMMgmt 属性
更改指定命名空间的管理属性的值。管理属性是适用于文件夹且未设置 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-FSx FSRMClassification
检索正在运行的文件分类过程的状态。状态可以是以下值之一：
+ `Unknown`: 无法确定分类状态
+ `NotRunning`: 当前未运行任何分类
+ `Queued`: 分类已排队等候启动
+ `Running`: 分类目前正在进行中
##### 参数
无
**示例：**
1. 检索当前的分类状态。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMClassification
}
```
#### 开始-FSx FSRMClassification
启动文件分类过程，该过程将分类规则应用于文件并生成分类报告。
##### 参数
+ `Queue (boolean)` – 可选。如果设置为 true，则将分类任务添加到队列中，以便在接下来的 5 分钟内运行。在此期间排队的所有任务都将一起运行。如果设置为 false 或未指定，则会立即开始分类。
+ `RunDuration (number)` – 可选。指定取消分类过程之前应运行多少小时。有效值：`-1` 到 `2147483`。特殊值：
+ `-1`: 运行直到取消
+ `0`: 运行至完成
+ 如果未指定，则运行直至完成。
**示例：**
1. 开始分类，没有时间限制。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Start-FSxFSRMClassification -RunDuration 0
}
```
#### 停下来-FSx FSRMClassification
停止文件系统上任何正在运行或排队的分类作业。
##### 参数
无
**示例：**
1. 停止正在运行的分类。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Stop-FSxFSRMClassification
}
```
#### 等等-FSx FSRMClassification
等待文件分类过程完成。当您需要执行依赖于分类完成的操作（例如根据保密文件生成报告）时，请使用此命令。
##### 参数
+ `Timeout (number)` – 可选。指定等待分类完成的时间（以秒为单位）。如果超时在分类完成之前过期，则命令会返回，但分类将继续在后台运行。有效值：`-1` 到 `2147483`。特殊值：
+ `-1`: 无限期等待，直到分类完成（默认）
+ `0`: 检查当前状态并立即返回，无需等待
**示例：**
1. 无限期等待分类完成。
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Wait-FSxFSRMClassification
}
```
#### Set-FSx FSRMClassification
修改文件分类的配置设置。
##### 参数
+ `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
}
```