ファイル分類 - Amazon FSx for Windows File Server
仕組みプロパティ定義分類ルール管理プロパティ分類の実行プロセス管理ベストプラクティス管理コマンド

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ファイル分類

ファイル分類は、コンテンツ、場所、またはその他の属性に基づいて、メタデータプロパティをファイルに自動的に割り当てます。分類は、機密情報を含むファイル、特定のビジネスカテゴリに属するファイル、または保持期間を必要とするファイルを識別することで、ファイルの整理、データ管理ポリシーの適用、コンプライアンス要件を満たすのに役立ちます。

ファイル分類の仕組み

ファイル分類では、3 ステップのプロセスを使用します。

  1. プロパティの定義 - "Data Sensitivity"や などのファイルに割り当てるメタデータのタイプを指定する分類プロパティ定義を作成します"ContainsPII"。

  2. ルールの作成 - ファイルコンテンツパターンやフォルダの場所など、指定した基準に基づいてファイルに自動的にプロパティ値を割り当てる分類ルールを設定します。たとえば、社会保障番号などのパターンを含むファイルは、自動的に として分類(XXX-XX-XXXX)できますContainsPII=Yes。

  3. 分類の実行 - 分類プロセスを実行してファイルをスキャンし、ルールを適用します。分類は、オンデマンドで、スケジュールに従って、またはバックグラウンドで継続的に実行できます。

分類が完了したら、割り当てられたプロパティを使用して、ストレージレポートの生成、 の適用ファイル管理タスク、または特定の特性を持つファイルの検索を行うことができます。

分類プロパティの定義

分類プロパティ定義は、ファイルに割り当てることができるメタデータのタイプを指定します。各プロパティ定義には、名前、プロパティタイプ、およびオプションで許可される値のリストがあります。たとえば、 OrderedList というプロパティを Type と指定できる値 Public、Internal、Confidential、および "Data Sensitivity"で作成できますRestricted。

次のプロパティタイプがサポートされています。

  • OrderedList - 値が特定のシーケンス (低、中、高など) を持つ順序付きリスト。値の順序がレポートまたはポリシーの決定に重要な場合は、このタイプを使用します。

  • MultiChoice - リストから複数の値を選択できるようにします (たとえば、ファイルは「財務」カテゴリと「法的」カテゴリの両方でタグ付けされる場合があります）。

  • SingleChoice - リストから選択できる値は 1 つだけです。

  • String - 事前定義されたオプションのない単一のテキスト値。

  • MultiString - 事前定義されたオプションのない複数のテキスト値。

  • Integer - 数値。

  • YesNo - ブール値 (true または false)。

  • DateTime - 日付と時刻の値。

プロパティ定義は、複数の分類ルールで再利用できます。プロパティ定義を作成したら、そのプロパティの値を割り当てる必要がある任意の分類ルールでそれを参照できます。

分類ルール

分類ルールは、ファイルに自動的にプロパティ値を割り当てるロジックを定義します。各ルールは以下を指定します。

  • 設定するプロパティ

  • そのプロパティに割り当てる値

  • ルールを適用する場所 (フォルダ)

  • プロパティ値を受け取るファイルを識別する方法。次の 2 つの分類メカニズムを使用できます。

コンテンツ分類子

コンテンツ分類子は、特定のテキストパターンまたは正規表現のファイルコンテンツをスキャンします。このメカニズムを使用して、ファイルの内容に基づいてファイルを識別します。コンテンツ分類子には、ファイルコンテンツを一致させる 3 つの方法があります。

  • 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

    • E メールアドレス、電話番号、またはその他の構造化データ

1 つのルールで複数の文字列またはパターンを指定でき、そのコンテンツが指定された値のいずれかと一致するとファイルが分類されます。

フォルダ分類子

フォルダ分類子は、ファイルが保存されている場所に基づいてプロパティ値を割り当てます。このメカニズムを使用して、フォルダ階層内の場所別にファイルを分類します。例えば、次のようになります。

  • 法律文書フォルダ内のすべてのファイルに保持期間プロパティを設定する

  • 特定のプロジェクトフォルダ内のすべてのファイルをプロジェクト識別子でマークする

さらに、 ReevaluatePropertyパラメータを使用して、 プロパティの値がすでにあるファイルで分類が実行されたときの動作を制御できます。次の設定を選択できます。

  • Never - このプロパティの値を持たないファイルのみを分類する

  • Overwrite - ファイルが変更されたときに既存の値を置き換える

  • Aggregate - 新しい値と既存の値を組み合わせる (複数値プロパティの場合)

管理プロパティ

管理プロパティは、ファイルではなくフォルダに適用される分類プロパティです。管理プロパティを使用して、ファイルシステム階層内のフォルダを整理および分類します。分類ルールによって自動的に割り当てられたファイルプロパティとは異なり、 Set-FSxFSRMMgmtProperty コマンドを使用して管理プロパティを手動で設定します。

フォルダを分類するには、 FolderUsage_MSプロパティを使用します。次の値を指定できます。

  • User Files

  • Group Share

  • Application Files

  • Backup and Archival

分類の実行

ファイル分類は、次の 3 つの方法で実行できます。

  1. 手動分類 - 分類をすぐに実行Start-FSxFSRMClassificationするために使用します。このアプローチは、新しいルールのテストや 1 回限りの分類タスクの実行に役立ちます。

  2. スケジュールされた分類 - 自動分類のスケジュールを設定Set-FSxFSRMClassificationするために使用します。分類は、毎週または毎月の特定の時間に実行するようにスケジュールできます。スケジュールされた分類は、予測可能な分類を定期的に実行するほとんどの本番環境に適しています。

  3. 連続分類 - ContinuousパラメータSet-FSxFSRMClassificationで を使用して、継続的に実行されるバックグラウンド分類を有効にします。連続分類は、新規および変更されたファイルが作成または変更された直後に自動的に分類します。このアプローチはup-to-date最新の分類を提供しますが、より多くのシステムリソースを消費します。

分類を開始するときは、 を指定RunDurationして、プロセスの実行期間を制限できます。分類が指定された時間内に完了しない場合、次回のスケジュールされた実行時、または手動で再開したときに、分類が停止して再開されます。

分類が完了したら、Windows File Explorer でファイルを右クリックし、プロパティを選択し、分類タブを選択することで、ファイルに割り当てられた分類プロパティを表示できます。このタブには、 ファイルのすべての分類プロパティとその値が表示されます。

分類プロセス管理

分類プロセスは、次のコマンドを使用してモニタリングおよび制御できます。

  • Get-FSxFSRMClassification - 分類の現在のステータスを確認する (Running、Queued、NotRunning、または Unknown)

  • Stop-FSxFSRMClassification - 実行中またはキューに入れられた分類ジョブを停止する

  • Wait-FSxFSRMClassification - 分類が完了するかタイムアウトの有効期限が切れるまでスクリプトの実行を一時停止する

これらのコマンドを使用して、分類を他のタスクと調整します。たとえば、分類が完了するまで待ってから、分類されたファイルプロパティに依存するストレージレポートを生成できます。

分類のベストプラクティス

効率的で効果的なファイル分類を行うには、以下のベストプラクティスに従ってください。

1. パフォーマンスに関する考慮事項

FSRM はファイルコンテンツを読み取ってスキャンする必要があるため、コンテンツベースの分類はリソースを大量に消費します。

  • 小さなデータセットで最初にルールをテストする - ファイルシステム全体に分類ルールを適用する前に、ファイルの代表的なサンプルでテストして、それらが期待どおりに動作することを検証し、分類にかかる時間を推定します。

  • コンテンツスキャン範囲の制限 - コンテンツベースの分類は、ファイルコンテンツの読み取りを必要とするため、リソースを大量に消費します。Namespace パラメータを使用して、ファイルシステム全体をスキャンするのではなく、ルールを特定のフォルダに制限します。

  • 可能な場合はフォルダ分類を使用する - ファイルの内容を読み取る必要がないため、フォルダ分類子はコンテンツ分類子よりもはるかに高速です。ファイルが場所に基づいて分類できる場合は、コンテンツ分類子の代わりにフォルダ分類子を使用します。

  • オフピーク時間帯のスケジュール分類 - システムアクティビティが少ない時間帯にスケジュール分類を実行して、ユーザーパフォーマンスへの影響を最小限に抑えます。バックアップウィンドウやその他のメンテナンスタスク中に分類を実行しないでください。

  • 適切な RunDuration 制限を設定する - RunDurationパラメータを使用して、分類の実行時間が長すぎてシステムパフォーマンスに影響を与えないようにします。制限時間内に分類が完了しない場合、次回のスケジュールされた実行中に分類が再開されます。

  • 分類パフォーマンスのモニタリング - 分類ステータス Get-FSxFSRMClassificationをチェックし、分類に予想以上に時間がかかるかどうかを特定します。長時間実行される分類は、ルールを最適化する必要があるか、システムがより多くのリソースを必要とすることを示している可能性があります。

2. ルール設計

  • 特定の正規表現を使用する - を使用する場合はContentRegularExpression、誤一致を避けるために、できるだけ具体的なパターンを記述します。正規表現を本番環境にデプロイする前に、完全にテストします。

  • 複数のパターンを効率的に組み合わせる - 同様のパターンに対して個別のルールを作成する代わりに、複数の ContentStringまたは ContentRegularExpression値を持つ単一のルールに結合します。これにより、FSRM が各ファイルをスキャンするために必要な回数が減ります。

  • 不要なフォルダを除外する - の ExcludeNamespaceパラメータSet-FSxFSRMClassificationを使用して、分類を必要としない一時ディレクトリやその他の場所を除外します。

3. プロパティ管理

  • プロパティスキーマを計画する - ルールを作成する前に分類プロパティを設計します。レポート、コンプライアンス、ファイル管理ポリシーに必要なプロパティを検討してください。

  • ドキュメントプロパティ定義 - 説明フィールドを使用して、各プロパティの意味と使用方法を説明します。これにより、他の管理者が分類スキーマを理解するのに役立ちます。

4. 継続的なメンテナンス

  • 分類結果を定期的に確認する - ストレージレポートを生成して、分類が期待どおりに機能し、ファイルが正しいプロパティ値を受信していることを確認します。

  • 必要に応じてルールを更新する - 組織のデータ管理要件が変更されたら、新しいポリシーまたはコンプライアンス要件を反映するように分類ルールを更新します。

  • 未使用のプロパティをクリーンアップする - 分類設定を管理可能にするために不要になったプロパティ定義とルールを削除します。

分類管理コマンド

ファイル分類を管理するために、FSx リモート PowerShell コマンドの 4 つのファミリーにアクセスできます。

  1. プロパティ定義コマンド - ファイルに割り当てることができるメタデータのタイプを指定する分類プロパティ定義を作成および管理します。

  2. 分類ルールコマンド - ファイルの内容または場所に基づいてプロパティ値を割り当てる自動分類ルールを作成および管理します。

  3. 管理プロパティコマンド - ファイルではなくフォルダの分類プロパティを設定および取得します。

  4. 分類プロセスコマンド - 分類プロセスを開始、停止、モニタリング、設定します。

ファイル分類 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: 可能な値から 1 つの選択肢

    • 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: ファイルシステムから 1 つ以上の分類プロパティ定義を取得します。

パラメータ :

  • Name (array) - オプション。取得するプロパティ定義の名前の配列。名前を指定しない場合、コマンドはファイルシステム上のすべてのプロパティ定義を返します。

例:

1. ファイルシステム上のすべての分類プロパティ定義を取得します。

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

Set-FSxFSRMClassificationPropertyDefinition

既存の分類プロパティ定義のプロパティを変更します。

パラメータ

  • 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

ファイルシステムから 1 つ以上の分類プロパティ定義を削除します。削除できるのは、ローカルに定義されたプロパティ定義のみです。

パラメータ

  • Name (array) - 必須。削除するプロパティ名の配列。

  • PassThru (boolean) - オプション。true に設定すると、削除されたプロパティ定義オブジェクトが返されます。

例:

1. 単一のプロパティ定義を削除します。

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Remove-FSxFSRMClassificationPropertyDefinition -Name "RiskLevel" -PassThru 
}

分類ルールのコマンド

New-FSxFSRMClassificationRule

指定された基準に基づいてファイルにプロパティ値を割り当てる自動分類ルールを作成します。各ルールは、単一のプロパティの値を設定します。

パラメータ

  • 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: 特定の文字列または正規表現パターンのファイルコンテンツをスキャンします。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

ファイルシステムから 1 つ以上の分類ルールを取得します。

パラメータ

  • Name (array) - オプション。取得する分類ルールの名前の配列。名前を指定しない場合、コマンドはファイルシステム上のすべてのルールを返します。

例:

1. ファイルシステムのすべての分類ルールを取得します。

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

既存の分類ルールのプロパティを変更します。

パラメータ

  • 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: 特定の文字列または正規表現パターンのファイルコンテンツをスキャンします。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

ファイルシステムから 1 つ以上の分類ルールを削除します。

パラメータ

  • Name (array) - 必須。削除する分類ルールの名前の配列。

  • PassThru (boolean) - オプション。true に設定すると、削除されたルールオブジェクトが返されます。

例:

1. 1 つの分類ルールを削除します。

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Remove-FSxFSRMClassificationRule -Name "Find Confidential Files" -PassThru 
}

管理プロパティコマンド

Get-FSxFSRMMgmtProperty

指定されたフォルダから管理プロパティを取得します。管理プロパティは、ファイルではなくフォルダに適用される分類プロパティです。

パラメータ

  • Namespace (string) - オプション。フォルダへのパス。

  • Name (string) - オプション。取得する管理プロパティの名前。名前を指定しない場合、コマンドはすべての管理プロパティを取得します。

  • Recurse (boolean) - オプション。true に設定すると、 は名前空間内のすべてのフォルダの管理プロパティを取得します。Namespace パラメータが必要です。

  • 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

指定されたフォルダから管理プロパティを削除します。

パラメータ

  • Namespace (string) - オプション。フォルダへのパス。

  • Name (string) - 必須。削除する管理プロパティの名前。

  • Recurse (boolean) - オプション。true に設定すると、 は名前空間内のすべてのフォルダの管理プロパティを削除します。Namespace パラメータが必要です。

例:

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

指定された名前空間の管理プロパティの値を変更します。管理プロパティは、フォルダに適用され、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-FSxFSRMClassification

実行中のファイル分類プロセスのステータスを取得します。ステータスは、次のいずれかの値になります。

  • Unknown: 分類ステータスを特定できません

  • NotRunning: 現在実行中の分類はありません

  • Queued: 分類は開始するためにキューに入れられます

  • Running: 分類は現在進行中です

パラメータ

なし

例:

1. 現在の分類ステータスを取得します。

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

Start-FSxFSRMClassification

ファイル分類プロセスを開始し、ファイルに分類ルールを適用して分類レポートを生成します。

パラメータ

  • 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

ファイルシステムで実行中またはキューに入れられた分類ジョブを停止します。

パラメータ

なし

例:

1. 実行中の分類を停止します。

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Stop-FSxFSRMClassification
}

Wait-FSxFSRMClassification

ファイル分類プロセスが完了するまで待ちます。分類ファイルに基づいてレポートを生成するなど、分類の終了に依存するアクションを実行する必要がある場合は、このコマンドを使用します。

パラメータ

  • Timeout (number) - オプション。分類が完了するまでの待機時間を秒単位で指定します。分類が終了する前にタイムアウトが期限切れになると、 コマンドは を返しますが、分類はバックグラウンドで実行され続けます。有効な値: -1 から 2147483。特殊な値:

    • -1: 分類が完了するまで無期限に待機する (デフォルト)

    • 0: 現在のステータスを確認し、待たずにすぐに戻る

例:

1. 分類が完了するまで無期限に待ちます。

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Wait-FSxFSRMClassification
}

Set-FSxFSRMClassification

ファイル分類の設定を変更します。

パラメータ

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