View a markdown version of this page

Classificazione dei file - Amazon FSx per Windows File Server
Come funzionaDefinizioni delle proprietàRegole di classificazioneProprietà di gestioneClassificazione podisticaGestione dei processiBest practiceComandi di gestione

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Classificazione dei file

La classificazione dei file assegna automaticamente le proprietà dei metadati ai file in base al contenuto, alla posizione o ad altri attributi. La classificazione consente di organizzare i file, applicare politiche di gestione dei dati e soddisfare i requisiti di conformità identificando i file che contengono informazioni sensibili, appartengono a categorie aziendali specifiche o richiedono periodi di conservazione.

Come funziona la classificazione dei file

La classificazione dei file utilizza un processo in tre fasi:

  1. Definizione delle proprietà: crea definizioni delle proprietà di classificazione che specificano i tipi di metadati da assegnare ai file, ad esempio o. "Data Sensitivity" "ContainsPII"

  2. Crea regole: configura regole di classificazione che assegnano automaticamente i valori delle proprietà ai file in base ai criteri specificati, ad esempio i modelli di contenuto dei file o le posizioni delle cartelle. Ad esempio, i file che contengono un modello, ad esempio un numero di previdenza sociale, (XXX-XX-XXXX) possono essere classificati automaticamente comeContainsPII=Yes.

  3. Esegui classificazione: esegue il processo di classificazione per scansionare i file e applicare le regole. È possibile eseguire la classificazione manualmente su richiesta, in base a una pianificazione o continuamente in background.

Una volta completata la classificazione, è possibile utilizzare le proprietà assegnate per generare report di archiviazioneAttività di gestione dei file, applicare o cercare file con caratteristiche specifiche.

Definizioni delle proprietà di classificazione

Le definizioni delle proprietà di classificazione specificano i tipi di metadati che possono essere assegnati ai file. Ogni definizione di proprietà ha un nome, un tipo di proprietà e, facoltativamente, un elenco di valori consentiti. Ad esempio, è possibile creare una proprietà chiamata "Data Sensitivity" con un OrderedList tipo e i valori possibili:Public, InternalConfidential, eRestricted.

Sono supportati i seguenti tipi di proprietà:

  • OrderedList- Un elenco ordinato in cui i valori hanno una sequenza specifica (ad esempio, Low, Medium, High). Utilizzate questo tipo quando l'ordine dei valori è importante per la rendicontazione o le decisioni politiche.

  • MultiChoice- Consente di selezionare più valori da un elenco (ad esempio, un file potrebbe essere etichettato con le categorie «Finanziario» e «Legale»).

  • SingleChoice- Consente di selezionare un solo valore da un elenco.

  • String- Un singolo valore di testo senza opzioni predefinite.

  • MultiString- Valori di testo multipli senza opzioni predefinite.

  • Integer- Un valore numerico.

  • YesNo- Un valore booleano (vero o falso).

  • DateTime- Un valore di data e ora.

Le definizioni delle proprietà sono riutilizzabili in più regole di classificazione. Dopo aver creato una definizione di proprietà, è possibile farvi riferimento in qualsiasi regola di classificazione che deve assegnare valori per quella proprietà.

Regole di classificazione

Le regole di classificazione definiscono la logica per l'assegnazione automatica dei valori delle proprietà ai file. Ogni regola specifica:

  • Quale proprietà impostare

  • Quale valore assegnare a quella proprietà

  • Dove applicare la regola (quali cartelle)

  • Come identificare i file che dovrebbero ricevere il valore della proprietà. È possibile utilizzare due meccanismi di classificazione:

Classificatore di contenuti

Content Classifier analizza il contenuto dei file alla ricerca di modelli di testo o espressioni regolari specifici. Utilizzate questo meccanismo per identificare i file in base a ciò che contengono. Content Classifier offre tre modi per abbinare il contenuto dei file:

  • ContentString- Cerca stringhe di testo senza distinzione tra maiuscole e minuscole. Usa questa opzione quando vuoi trovare parole o frasi specifiche indipendentemente dalle maiuscole. Ad esempio, cercando «riservato» si otterrà la risposta «Riservato», «CONFIDENZIALE» e «riservato».

  • ContentStringCaseSensitive- Cerca stringhe di testo con distinzione tra maiuscole e minuscole. Usa questa opzione quando le maiuscole sono importanti per la tua ricerca. Ad esempio, la ricerca di «SSN» corrisponderà a «SSN» ma non a «ssn» o «Ssn». Ciò è utile per acronimi, codici di prodotto o altri identificatori in cui le maiuscole e minuscole sono significative.

  • ContentRegularExpression- Cerca modelli utilizzando espressioni regolari. Usa questa opzione quando devi abbinare modelli complessi o formati variabili. Ad esempio, puoi utilizzare le espressioni regolari per rilevare:

    • Numeri di previdenza sociale nel formato 123-45-6789: \b\d{3}-\d{2}-\d{4}\b

    • Numeri di carte di credito con spazi o trattini opzionali: \b\d{4}[\s-]?\d{4}[\s-]?\d{4}[\s-]?\d{4}\b

    • Indirizzi e-mail, numeri di telefono o altri dati strutturati

È possibile specificare più stringhe o pattern in un'unica regola e i file verranno classificati se il loro contenuto corrisponde a uno dei valori specificati.

Classificatore di cartelle

Folder Classifier assegna i valori delle proprietà in base alla posizione in cui sono archiviati i file. Utilizzate questo meccanismo per classificare i file in base alla loro posizione nella gerarchia delle cartelle. Ad esempio:

  • Imposta una proprietà del periodo di conservazione per tutti i file nella cartella Legal Documents

  • Contrassegna tutti i file in una cartella di progetto specifica con un identificatore di progetto

Inoltre, è possibile utilizzare il ReevaluateProperty parametro per controllare cosa succede quando la classificazione viene eseguita su un file che contiene già un valore per la proprietà. È possibile selezionare le seguenti configurazioni:

  • Never- Classifica solo i file che non hanno un valore per questa proprietà

  • Overwrite- Sostituisci i valori esistenti quando i file vengono modificati

  • Aggregate- Combina nuovi valori con valori esistenti (per proprietà con più valori)

Proprietà di gestione

Le proprietà di gestione sono proprietà di classificazione che si applicano alle cartelle anziché ai file. Le proprietà di gestione vengono utilizzate per organizzare e classificare le cartelle nella gerarchia del file system. A differenza delle proprietà dei file assegnate automaticamente tramite regole di classificazione, le proprietà di gestione vengono impostate manualmente utilizzando il Set-FSxFSRMMgmtProperty comando.

Per classificare le cartelle, utilizzate la FolderUsage_MS proprietà. Puoi specificare le seguenti valori:

  • User Files

  • Group Share

  • Application Files

  • Backup and Archival

Classificazione in corso

È possibile eseguire la classificazione dei file in tre modi:

  1. Classificazione manuale: consente Start-FSxFSRMClassification di eseguire immediatamente la classificazione. Questo approccio è utile per testare nuove regole o eseguire attività di classificazione una tantum.

  2. Classificazione pianificata: consente Set-FSxFSRMClassification di configurare una pianificazione per la classificazione automatica. È possibile pianificare la classificazione in modo che venga eseguita settimanalmente o mensilmente in orari specifici. La classificazione pianificata è appropriata per la maggior parte degli ambienti di produzione in cui si desiderano esecuzioni di classificazione regolari e prevedibili.

  3. Classificazione continua: da utilizzare Set-FSxFSRMClassification con il Continuous parametro per abilitare la classificazione in background che viene eseguita continuamente. La classificazione continua classifica automaticamente i file nuovi e modificati poco dopo la loro creazione o modifica. Questo approccio fornisce la classificazione più aggiornata ma consuma più risorse di sistema.

Quando si avvia la classificazione, è possibile specificare RunDuration a per limitare la durata di esecuzione del processo. Se la classificazione non viene completata entro il tempo specificato, si interrompe e riprende durante la successiva esecuzione pianificata o quando la si riavvia manualmente.

Al termine della classificazione, è possibile visualizzare le proprietà di classificazione assegnate ai file facendo clic con il pulsante destro del mouse su un file in Esplora file di Windows, selezionando Proprietà e scegliendo la scheda Classificazione. Questa scheda mostra tutte le proprietà di classificazione e i relativi valori per il file.

Gestione del processo di classificazione

È possibile monitorare e controllare il processo di classificazione con i seguenti comandi:

Utilizzate questi comandi per coordinare la classificazione con altre attività. Ad esempio, è possibile attendere il completamento della classificazione prima di generare un report di archiviazione che dipende dalle proprietà classificate dei file.

Procedure consigliate di classificazione

Segui queste best practice per garantire una classificazione dei file efficiente ed efficace.

1. Considerazioni sulle prestazioni

Content-based la classificazione richiede molte risorse perché FSRM deve leggere e scansionare il contenuto dei file.

  • Testate prima le regole su un set di dati di piccole dimensioni: prima di applicare le regole di classificazione all'intero file system, testatele su un campione rappresentativo di file per verificare che funzionino come previsto e per stimare il tempo necessario per la classificazione.

  • Limita l'ambito di scansione dei contenuti: la Content-based classificazione richiede molte risorse perché richiede la lettura del contenuto dei file. Utilizzate il Namespace parametro per limitare le regole a cartelle specifiche anziché eseguire la scansione dell'intero file system.

  • Usa la classificazione delle cartelle quando possibile: Folder Classifier è molto più veloce di Content Classifier perché non ha bisogno di leggere il contenuto dei file. Quando i file possono essere classificati in base alla loro posizione, utilizza Folder Classifier anziché Content Classifier.

  • Pianifica la classificazione durante le ore non di punta: esegui la classificazione pianificata durante i periodi di scarsa attività del sistema per ridurre al minimo l'impatto sulle prestazioni degli utenti. Evita di eseguire la classificazione durante le finestre di backup o altre attività di manutenzione.

  • Imposta RunDuration i limiti appropriati: utilizza il RunDuration parametro per evitare che la classificazione duri troppo a lungo e influisca sulle prestazioni del sistema. Se la classificazione non viene completata entro il limite di tempo, verrà ripresa durante la successiva esecuzione pianificata.

  • Monitoraggio delle prestazioni di classificazione: Get-FSxFSRMClassification da utilizzare per verificare lo stato della classificazione e identificare se la classificazione richiede più tempo del previsto. Long-runningla classificazione può indicare che le regole devono essere ottimizzate o che il sistema necessita di più risorse.

2. Progettazione delle regole

  • Usa espressioni regolari specifiche: quando lo usiContentRegularExpression, scrivi modelli il più specifici possibile per evitare false corrispondenze. Testate accuratamente le espressioni regolari prima di distribuirle in produzione.

  • Combina più pattern in modo efficiente: invece di creare regole separate per pattern simili, combinali in un'unica regola con più ContentRegularExpression valori ContentString or. Ciò riduce il numero di volte in cui FSRM deve scansionare ogni file.

  • Escludi cartelle non necessarie: utilizza il ExcludeNamespace parametro in Set-FSxFSRMClassification per escludere le directory temporanee e altre posizioni che non necessitano di classificazione.

3. Gestione della proprietà

  • Pianifica lo schema delle proprietà: progetta le proprietà di classificazione prima di creare le regole. Considerate le proprietà necessarie per le politiche di reporting, conformità e gestione dei file.

  • Definizioni delle proprietà del documento: utilizza il campo Descrizione per spiegare il significato di ciascuna proprietà e come deve essere utilizzata. Questo aiuta gli altri amministratori a comprendere il tuo schema di classificazione.

4. Manutenzione continua

  • Rivedi regolarmente i risultati della classificazione: genera report di archiviazione per verificare che la classificazione funzioni come previsto e che i file ricevano i valori delle proprietà corretti.

  • Aggiorna le regole in base alle esigenze: man mano che i requisiti di gestione dei dati dell'organizzazione cambiano, aggiorna le regole di classificazione per riflettere nuove politiche o requisiti di conformità.

  • Elimina le proprietà inutilizzate: rimuovi le definizioni e le regole delle proprietà che non sono più necessarie per mantenere gestibile la configurazione di classificazione.

Comandi di gestione della classificazione

È possibile accedere a quattro famiglie di PowerShell comandi remoti FSx per la gestione della classificazione dei file:

  1. Comandi per la definizione delle proprietà: crea e gestisci le definizioni delle proprietà di classificazione che specificano i tipi di metadati che è possibile assegnare ai file.

  2. Comandi delle regole di classificazione: crea e gestisci regole di classificazione automatiche che assegnano i valori delle proprietà in base al contenuto o alla posizione del file.

  3. Comandi delle proprietà di gestione: imposta e recupera le proprietà di classificazione nelle cartelle anziché nei file.

  4. Comandi del processo di classificazione: avvio, arresto, monitoraggio e configurazione del processo di classificazione.

Elenco dei comandi remoti PowerShell FSx di File Classification

Nota

Tutti gli esempi in questa pagina presuppongono che tu abbia definito la $FSxWindowsRemotePowerShellEndpoint variabile con l' PowerShell endpoint Windows Remote del tuo file system. Puoi trovare questo endpoint nella console Amazon FSx nella pagina dei dettagli del tuo file system o utilizzando il comando. AWS CLI describe-file-systems

Comandi per la definizione delle proprietà

New-FSxFSRMClassificationPropertyDefinition

New-FSxFSRMClassificationPropertyDefinition: crea una definizione di proprietà di classificazione che può essere utilizzata per classificare i file. Le definizioni delle proprietà definiscono gli attributi che possono essere assegnati ai file tramite regole di classificazione.

Parametri:

  • Name (string)- Obbligatorio. Un nome per la definizione della proprietà.

  • DisplayName (string)- Facoltativo. Un nome visualizzato per la definizione della proprietà.

  • Description (string)- Facoltativo. Una descrizione per la definizione della proprietà.

  • Type (string)- Obbligatorio. Il tipo di proprietà di classificazione. Puoi specificare le seguenti valori:

    • OrderedList: un elenco ordinato di valori possibili

    • MultiChoice: Selezione a scelta multipla tra valori possibili

    • SingleChoice: Scelta singola tra i valori possibili

    • String: Stringa di testo singola

    • MultiString: Stringhe di testo multiple

    • Integer: Valore numerico

    • YesNo: Valore booleano

    • DateTime: valore di data e ora

  • PossibleValueConfigurations (array)- Facoltativo Una serie di configurazioni per OrderedList MultiChoice, o tipi di SingleChoice proprietà. Ogni configurazione ha le seguenti proprietà:

    • Name (string): Il nome del valore (obbligatorio)

    • Description (string): Una descrizione del valore (opzionale)

  • Parameters (array)- Facoltativo. Una serie di stringhe in "name=value" formato per una configurazione aggiuntiva.

Esempi:

1. Crea un elenco di proprietà per i dati PII. 

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    New-FSxFSRMClassificationPropertyDefinition -Name "ContainsPII" -Type OrderedList -PossibleValueConfigurations @(
            @{ Name = "Yes" },
            @{ Name = "No" })
}

2. Crea una proprietà di elenco ordinato per la sensibilità dei dati. 

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: recupera una o più definizioni delle proprietà di classificazione dal file system.

Parametri:

  • Name (array)- Facoltativo. Una serie di nomi di definizioni di proprietà da recuperare. Se non si specifica un nome, il comando restituisce tutte le definizioni di proprietà nel file system.

Esempi:

1. Recupera tutte le definizioni delle proprietà di classificazione nel file system. 

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

Set-FSxFSRMClassificationPropertyDefinition

Modifica le proprietà di una definizione di proprietà di classificazione esistente.

Parameters

  • Name (array)- Obbligatorio. Una serie di nomi di proprietà da modificare.

  • DisplayName (string)- Facoltativo. Un nuovo nome visualizzato per la definizione della proprietà.

  • Description (string)- Facoltativo. Una nuova descrizione per la definizione della proprietà.

  • PossibleValueConfigurations (array)- Facoltativo. Una nuova serie di configurazioni per OrderedList MultiChoice, o SingleChoice proprietà. Ogni configurazione ha le seguenti proprietà:

    • Name (string): Il nome del valore (obbligatorio)

    • Description (string): Una descrizione del valore (opzionale)

  • Parameters (array)- Facoltativo. Un nuovo array di stringhe in formato «name=value».

  • PassThru (boolean)- Facoltativo. Se impostato su true, restituisce l'oggetto di definizione della proprietà modificato.

Esempi:

1. Aggiorna i valori possibili con le descrizioni di una definizione di proprietà esistente. 

$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

Rimuove una o più definizioni delle proprietà di classificazione dal file system. È possibile rimuovere solo le definizioni delle proprietà definite localmente.

Parameters

  • Name (array)- Obbligatorio. Una serie di nomi di proprietà da rimuovere.

  • PassThru (boolean)- Facoltativo. Se impostato su true, restituisce l'oggetto di definizione della proprietà rimosso.

Esempi:

1. Rimuove una singola definizione di proprietà. 

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

Comandi delle regole di classificazione

New-FSxFSRMClassificationRule

Crea una regola di classificazione automatica che assegna i valori delle proprietà ai file in base a criteri specificati. Ogni regola imposta un valore per una singola proprietà.

Parameters

  • Name (string)- Obbligatorio. Un nome per la regola di classificazione.

  • Description (string)- Facoltativo. Una descrizione della regola di classificazione.

  • Property (string)- Obbligatorio. Il nome della proprietà di classificazione da impostare. Deve essere un nome di definizione di proprietà esistente.

  • PropertyValue (string)- Facoltativo. Il valore da assegnare alla proprietà. Deve essere valido per il meccanismo di classificazione specificato.

  • Namespace (array)- Obbligatorio. Una serie di percorsi o tipi di cartelle a cui si applica la regola.

  • Disabled (boolean)- Facoltativo. Se impostato su true, crea la regola in uno stato disabilitato.

  • ReevaluateProperty (string)- Facoltativo. Specifica quando rivalutare i file. Puoi specificare le seguenti valori:

    • Never: valuta solo i file senza un valore di proprietà esistente

    • Overwrite: Re-evaluate quando i file cambiano e sovrascrivono il valore esistente

    • Aggregate: Re-evaluate quando i file cambiano e si combinano con il valore esistente

  • Flags (array)- Opzionale. Specifica comportamenti speciali per la regola. Puoi specificare le seguenti valori:

    • ClearAutomaticallyClassifiedProperty

    • ClearManuallyClassifiedProperty

    • Deprecated

  • ContentRegularExpression (array)- Facoltativo. Una serie di espressioni regolari da abbinare al contenuto del file.

  • ContentString (array)- Facoltativo. Una serie di stringhe senza distinzione tra maiuscole e minuscole da cercare nel contenuto del file.

  • ClassificationMechanism (string)- Obbligatorio. Il meccanismo da utilizzare per classificare i file. Puoi specificare le seguenti valori:

    • Content Classifier: analizza il contenuto dei file alla ricerca di stringhe specifiche o modelli di espressioni regolari. Quando si specifica Content Classifier, è possibile utilizzare i ContentRegularExpression parametri ContentString, ContentStringCaseSensitive, o per definire il contenuto da cercare.

    • Folder Classifier: classifica i file in base alla posizione della cartella

  • Parameters (array)- Facoltativo. Una serie di "name=value" stringhe per una configurazione aggiuntiva.

Esempi:

1. Rileva i numeri di previdenza sociale utilizzando un'espressione regolare. 

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. Rileva i numeri delle carte di credito utilizzando un'espressione regolare. 

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. Classifica ogni file in una cartella con un periodo di conservazione di 7 anni. 

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

Recupera una o più regole di classificazione dal file system.

Parameters

  • Name (array)- Opzionale. Una serie di nomi di regole di classificazione da recuperare. Se non si specifica un nome, il comando restituisce tutte le regole del file system.

Esempi:

1. Recupera tutte le regole di classificazione sul file system. 

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

Modifica le proprietà delle regole di classificazione esistenti.

Parameters

  • Name (array)- Obbligatorio. Una serie di nomi di regole di classificazione da modificare.

  • Description (string)- Facoltativo. Una nuova descrizione per la regola.

  • Property (string)- Facoltativo. Il nome della proprietà di classificazione da impostare.

  • PropertyValue (string)- Facoltativo. Un nuovo valore da assegnare alla proprietà.

  • Namespace (array)- Facoltativo. Una nuova serie di percorsi o tipi di cartelle a cui si applica la regola.

  • Disabled (boolean)- Facoltativo. Se impostato su true, disabilita la regola. Se impostato su false, abilita la regola.

  • ReevaluateProperty (string)- Facoltativo. Cambia quando rivalutare i file. Puoi specificare le seguenti valori:

    • Never: valuta solo i file senza un valore di proprietà esistente

    • Overwrite: Re-evaluate quando i file cambiano e sovrascrivono il valore esistente

    • Aggregate: Re-evaluate quando i file cambiano e si combinano con il valore esistente

  • Flags (array)- Opzionale. Nuovi comportamenti speciali per la regola. Puoi specificare le seguenti valori:

    • ClearAutomaticallyClassifiedProperty

    • ClearManuallyClassifiedProperty

    • Deprecated

  • ContentRegularExpression (array)- Opzionale. Una nuova serie di espressioni regolari.

  • ContentString (array)- Opzionale. Una nuova serie di stringhe di ricerca senza distinzione tra maiuscole e minuscole.

  • ContentStringCaseSensitive (array)- Facoltativo. Una nuova serie di stringhe di ricerca con distinzione tra maiuscole e minuscole.

  • ClassificationMechanism (string)- Opzionale. Un nuovo meccanismo di classificazione da utilizzare. Puoi specificare le seguenti valori:

    • Content Classifier: analizza il contenuto del file alla ricerca di stringhe o modelli di espressioni regolari specifici. Quando si specifica Content Classifier, è possibile utilizzare i ContentRegularExpression parametri ContentString, ContentStringCaseSensitive, o per definire il contenuto da cercare.

    • Folder Classifier: classifica i file in base alla posizione della cartella

  • Parameters (array)- Facoltativo. Una nuova serie di stringhe di "name=value" configurazione.

  • PassThru (boolean)- Opzionale. Se impostato su true, restituisce l'oggetto regola modificato.

Esempi:

1. Aggiorna le proprietà e lo spazio dei nomi di una regola di classificazione esistente. 

$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

Rimuove una o più regole di classificazione dal file system.

Parameters

  • Name (array)- Obbligatorio. Una serie di nomi di regole di classificazione da rimuovere.

  • PassThru (boolean)- Facoltativo. Se impostato su true, restituisce l'oggetto regola rimosso.

Esempi:

1. Rimuove una singola regola di classificazione. 

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

Comandi delle proprietà di gestione

Get-FSxFSRMMgmtProperty

Recupera le proprietà di gestione dalle cartelle specificate. Le proprietà di gestione sono proprietà di classificazione che si applicano alle cartelle anziché ai file.

Parameters

  • Namespace (string)- Facoltativo Il percorso di una cartella.

  • Name (string)- Facoltativo Il nome di una proprietà di gestione da recuperare. Se non si specifica un nome, il comando recupera tutte le proprietà di gestione.

  • Recurse (boolean)- Facoltativo. Se impostato su true, recupera le proprietà di gestione per tutte le cartelle all'interno del namespace. Richiede il parametro Namespace.

  • Effective (boolean)- Facoltativo Se impostato su true, recupera la proprietà di gestione per la cartella più vicina con il nome specificato. La ricerca include lo spazio dei nomi specificato e la relativa gerarchia principale. Richiede il parametro Name.

Esempi:

1. Recupera tutte le proprietà di gestione sul file system. 

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

2. Recupera le proprietà di gestione per una cartella specifica. 

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Get-FSxFSRMMgmtProperty -Namespace "share\department"
}

Remove-FSxFSRMMgmtProperty

Rimuove le proprietà di gestione dalle cartelle specificate.

Parameters

  • Namespace (string)- Facoltativo Il percorso di una cartella.

  • Name (string)- Obbligatorio. Il nome della proprietà di gestione da rimuovere.

  • Recurse (boolean)- Facoltativo. Se impostato su true, rimuove le proprietà di gestione per tutte le cartelle all'interno del namespace. Richiede il parametro Namespace.

Esempi:

1. Rimuove tutte le istanze di una proprietà di gestione. 

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Remove-FSxFSRMMgmtProperty -Name "FolderUsage_MS"
}

2. Rimuove una proprietà di gestione da una cartella specifica. 

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Remove-FSxFSRMMgmtProperty -Name "FolderUsage_MS" -Namespace "share\department" 
}

Set-FSxFSRMMgmtProperty

Modifica il valore di una proprietà di gestione per uno spazio dei nomi specificato. Le proprietà di gestione sono proprietà di classificazione che si applicano alle cartelle e non hanno il flag Secure impostato.

Parameters

  • Namespace (string)- Opzionale. Il percorso della cartella.

  • Name (string)- Obbligatorio. Il nome della proprietà di gestione da modificare. Deve essere una proprietà di classificazione esistente che si applica alle cartelle.

  • Value (string)- Obbligatorio. Il nuovo valore da assegnare alla proprietà di gestione.

Esempi:

1. Imposta una proprietà di utilizzo della cartella. 

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Set-FSxFSRMMgmtProperty -Namespace "share\department" -Name "FolderUsage_MS" -Value "User Files" 
}

Comandi del processo di classificazione

Get-FSxFSRMClassification

Recupera lo stato del processo di classificazione dei file in esecuzione. Lo stato può avere uno dei seguenti valori:

  • Unknown: lo stato della classificazione non può essere determinato

  • NotRunning: Nessuna classificazione è attualmente in corso

  • Queued: La classificazione è in coda per iniziare

  • Running: La classificazione è attualmente in corso

Parameters

Nessuno

Esempi:

1. Recupera lo stato corrente della classificazione. 

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

Start-FSxFSRMClassification

Avvia il processo di classificazione dei file, che applica le regole di classificazione ai file e genera un rapporto di classificazione.

Parameters

  • Queue (boolean)- Opzionale. Se impostato su true, aggiunge l'attività di classificazione a una coda da eseguire entro i 5 minuti successivi. Tutte le attività in coda durante questo periodo verranno eseguite insieme. Se è impostata su false o non è specificata, la classificazione inizia immediatamente.

  • RunDuration (number)- Facoltativo. Specifica quante ore deve essere eseguito il processo di classificazione prima di essere annullato. Valori validi: da -1 a 2147483. Valori speciali:

    • -1: Esegui fino all'annullamento

    • 0: Esegui fino al completamento

    • Se non specificato, viene eseguito fino al completamento.

Esempi:

1. Inizia la classifica senza limiti di tempo. 

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Start-FSxFSRMClassification -RunDuration 0
}

Stop-FSxFSRMClassification

Interrompe qualsiasi processo di classificazione in esecuzione o in coda sul file system.

Parameters

Nessuno

Esempi:

1. Interrompe una classificazione in corso. 

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

Wait-FSxFSRMClassification

Attende il completamento del processo di classificazione dei file. Utilizzate questo comando quando dovete eseguire azioni che dipendono dal completamento della classificazione, ad esempio la generazione di report basati su file classificati.

Parameters

  • Timeout (number)- Opzionale. Specifica il tempo di attesa, in secondi, per il completamento della classificazione. Se il timeout scade prima del termine della classificazione, il comando viene restituito ma la classificazione continua a essere eseguita in background. Valori validi: da -1 a 2147483. Valori speciali:

    • -1: Attendi indefinitamente il completamento della classificazione (impostazione predefinita)

    • 0: Controlla lo stato attuale e torna immediatamente senza aspettare

Esempi:

1. Attendi indefinitamente il completamento della classificazione. 

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

Set-FSxFSRMClassification

Modifica le impostazioni di configurazione per la classificazione dei file.

Parameters

  • ExcludeNamespace (array)- Facoltativo. Una serie di cartelle aggiuntive da escludere dalla classificazione.

  • ScheduleConfigurations (hashtable)- Facoltativo. Una tabella hash contenente la configurazione della pianificazione con le seguenti proprietà:

    • Time (datetime): DateTime oggetto che specifica quando eseguire l'attività (obbligatorio)

    • RunDuration (number): numero di ore per eseguire l'operazione (opzionale)

    • Weekly (array): Matrice di giorni feriali (opzionale)

    • Monthly (array): Matrice di giorni del mese, usa -1 per l'ultimo giorno (opzionale)

  • Continuous (boolean)- Facoltativo Se impostato su true, abilita la classificazione continua in background.

  • PassThru (boolean)- Facoltativo. Se impostato su true, restituisce l'oggetto di configurazione della classificazione modificato.

Esempi:

1. Abilita la classificazione continua.

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
    Set-FSxFSRMClassification -Continuous:$true
}

2. Imposta una pianificazione settimanale per eseguire la classificazione.

$schedule = @{
    Time = ("12:00am")
    Weekly = @('Monday', 'Wednesday', 'Friday')
}

Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ArgumentList $schedule -ScriptBlock {
    param($schedule)
    Set-FSxFSRMClassification -ScheduleConfigurations $schedule
}

3. Imposta una pianificazione mensile con esclusioni personalizzate.

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