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 le 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"`
1. **Crea regole**: configura le regole di classificazione che assegnano automaticamente i valori delle proprietà ai file in base a criteri specificati, come i modelli di contenuto dei file o le posizioni delle cartelle. Ad esempio, i file che contengono uno schema come un numero di previdenza sociale `(XXX-XX-XXXX)` possono essere classificati automaticamente come`ContainsPII=Yes`.
1. **Esegui la classificazione**: esegui 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 archiviazione[Attività di gestione dei file](fsrm-file-management.md), 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` Type e i valori possibili:`Public`, `Internal``Confidential`, e`Restricted`.
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 entrambe 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 debba assegnare valori a tale 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. Utilizzate questa opzione per trovare parole o frasi specifiche indipendentemente dalle maiuscole. Ad esempio, la ricerca di «riservato» corrisponderà a «Confidenziale», «CONFIDENZIALE» e «riservato».
+ `ContentStringCaseSensitive`- Cerca stringhe di testo con distinzione tra maiuscole e minuscole. Utilizzate questa opzione quando le maiuscole sono importanti per la 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. Utilizzate questa opzione quando avete bisogno di abbinare modelli complessi o formati variabili. Ad esempio, puoi usare 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 modelli 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. Esempio:
+ Imposta una proprietà del periodo di conservazione per tutti i file nella cartella Documenti legali
+ 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 ha già un valore per la proprietà. È possibile selezionare le seguenti configurazioni:
+ `Never`- Classizza solo i file che non hanno un valore per questa proprietà
+ `Overwrite`- Sostituisci i valori esistenti quando i file cambiano
+ `Aggregate`- Combina nuovi valori con valori esistenti (per proprietà multivalore)
## 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 che vengono assegnate automaticamente tramite regole di classificazione, le proprietà di gestione vengono impostate manualmente utilizzando il ` Set- FSx FSRMMgmt Property` comando.
Per classificare le cartelle, utilizzare 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 [Inizia- FSx FSRMClassification](#start-fsxfsrmclassification) di eseguire immediatamente la classificazione. Questo approccio è utile per testare nuove regole o eseguire attività di classificazione una tantum.
1. **Classificazione pianificata**: [Impostare- FSx FSRMClassification](#set-fsxfsrmclassification) consente 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 richiedono esecuzioni di classificazione regolari e prevedibili.
1. **Classificazione continua**: da utilizzare [Impostare- FSx FSRMClassification](#set-fsxfsrmclassification) con il `Continuous` parametro per abilitare la classificazione in background che viene eseguita in modo continuo. La classificazione continua classifica automaticamente i file nuovi e modificati subito dopo la loro creazione o modifica. Questo approccio offre il massimo livello di up-to-date classificazione 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 Windows File Explorer, 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:
+ [Ottieni- FSx FSRMClassification](#get-fsxfsrmclassification)- Verifica lo stato attuale della classificazione (`Running`,`Queued`,`NotRunning`, o`Unknown`)
+ [Smettila... FSx FSRMClassification](#stop-fsxfsrmclassification)- Interrompi un processo di classificazione in esecuzione o in coda
+ [Aspetta... FSx FSRMClassification](#wait-fsxfsrmclassification)- Sospende l'esecuzione dello script fino al completamento della classificazione o alla scadenza di un timeout
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 dipenda dalle proprietà dei file classificati.
## Procedure consigliate di classificazione
Segui queste best practice per garantire una classificazione dei file efficiente ed efficace.
### 1. Considerazioni sulle prestazioni
La classificazione basata sui contenuti richiede molte risorse perché FSRM deve leggere e scansionare il contenuto dei file.
+ **Verifica innanzitutto le regole su un set di dati di piccole dimensioni: prima** di applicare le regole di classificazione all'intero file system, testale 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 classificazione basata sui contenuti 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, riprenderà durante la successiva esecuzione pianificata.
+ **Monitora le prestazioni di classificazione**: ` Get-FSxFSRMClassification` da utilizzare per verificare lo stato della classificazione e identificare se la classificazione sta impiegando più tempo del previsto. La classificazione a lungo termine può indicare che le regole devono essere ottimizzate o che il sistema necessita di più risorse.
### 2. Progettazione delle regole
+ **Usa espressioni regolari specifiche**: durante l'uso`ContentRegularExpression`, scrivi modelli il più specifici possibile per evitare false corrispondenze. Prova a fondo le espressioni regolari prima di implementarle in produzione.
+ **Combina più modelli in modo efficiente**: anziché creare regole separate per modelli simili, combinali in un'unica regola con `ContentRegularExpression` valori multipli `ContentString` o. 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 richiedono una classificazione.
### 3. Gestione della proprietà
+ **Pianifica lo schema delle proprietà**: progetta le proprietà di classificazione prima di creare regole. Considerate le proprietà necessarie per le politiche di reporting, conformità e gestione dei file.
+ **Definizioni delle proprietà del documento**: utilizzate il campo Descrizione per spiegare il significato di ciascuna proprietà e come deve essere utilizzata. Questo aiuta gli altri amministratori a comprendere lo 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 di proprietà corretti.
+ **Aggiorna le regole secondo necessità**: 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à.
+ **Pulisci le proprietà non utilizzate**: rimuovi le definizioni e le regole delle proprietà che non sono più necessarie per mantenere gestibile la configurazione della classificazione.
## Comandi di gestione della classificazione
È possibile accedere a quattro famiglie di PowerShell comandi FSx remoti per la gestione della classificazione dei file:
1. **Comandi di definizione delle proprietà**: crea e gestisce le definizioni delle proprietà di classificazione che specificano i tipi di metadati che è possibile assegnare ai file.
1. **Comandi delle regole di classificazione**: crea e gestisci regole di classificazione automatiche che assegnano valori alle proprietà in base al contenuto o alla posizione del file.
1. **Comandi delle proprietà di gestione**: impostano e recuperano le proprietà di classificazione sulle cartelle anziché sui file.
1. **Comandi del processo di classificazione**: avvia, arresta, monitora e configura il processo di classificazione.
### Elenco di PowerShell comandi FSx remoti per la classificazione dei file
**Nota**
Tutti gli esempi in questa pagina presuppongono che la ` $FSxWindowsRemotePowerShellEndpoint` variabile sia stata definita con l' PowerShell endpoint Windows Remote del file system. Puoi trovare questo endpoint nella FSx console Amazon nella pagina dei dettagli del tuo file system o utilizzando il AWS CLI `describe-file-systems` comando.
### Comandi di definizione delle proprietà
#### Nuovo- FSx FSRMClassification PropertyDefinition
`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 i 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)`: 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" }
)
}
```
#### Ottieni- FSx FSRMClassification PropertyDefinition
`Get-FSxFSRMClassificationPropertyDefinition`: recupera una o più definizioni delle proprietà di classificazione dal file system.
**Parametri:**
+ `Name (array)`- Facoltativo. Una matrice 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 sul file system.**
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMClassificationPropertyDefinition
}
```
#### Imposta- FSx FSRMClassification PropertyDefinition
Modifica le proprietà di una definizione di proprietà di classificazione esistente.
##### Parameters
+ `Name (array)`- Richiesto. Una matrice 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)`: 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
}
```
#### Rimuovi- FSx FSRMClassification PropertyDefinition
Rimuove una o più definizioni di proprietà di classificazione dal file system. È possibile rimuovere solo le definizioni di proprietà definite localmente.
##### Parameters
+ `Name (array)`- Richiesto. 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
#### Nuova FSx FSRMClassification regola
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)`- Richiesto. 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`: rivaluta quando i file cambiano e sovrascrivono il valore esistente
+ `Aggregate`: rivaluta quando i file cambiano e si combinano con il valore esistente
+ `Flags (array)`- Facoltativo. Specifica comportamenti speciali per la regola. Puoi specificare le seguenti valori:
+ `ClearAutomaticallyClassifiedProperty`
+ `ClearManuallyClassifiedProperty`
+ `Deprecated`
+ `ContentRegularExpression (array)`- Facoltativo. Una serie di espressioni regolari per corrispondere 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 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 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 usando 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. Classificate ogni file in una cartella con un periodo di conservazione di 7 anni Property.
```
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"
}
```
#### Regola Get- FSx FSRMClassification
Recupera una o più regole di classificazione dal file system.
##### Parameters
+ `Name (array)`- Facoltativo. Una serie di nomi di regole di classificazione da recuperare. Se non si specifica un nome, il comando restituisce tutte le regole sul file system.
**Esempi:**
1. Recupera tutte le regole di classificazione sul file system.
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Get-FSxFSRMClassificationRule
}
```
##### Imposta - Regola FSx FSRMClassification
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 della 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. Modifica quando rivalutare i file. Puoi specificare le seguenti valori:
+ `Never`: valuta solo i file senza il valore della proprietà esistente
+ `Overwrite`: rivaluta quando i file cambiano e sovrascrivono il valore esistente
+ `Aggregate`: rivaluta quando i file cambiano e si combinano con il valore esistente
+ `Flags (array)`- Facoltativo. Nuovi comportamenti speciali per la regola. Puoi specificare le seguenti valori:
+ `ClearAutomaticallyClassifiedProperty`
+ `ClearManuallyClassifiedProperty`
+ `Deprecated`
+ `ContentRegularExpression (array)`- Facoltativo. Una nuova serie di espressioni regolari.
+ `ContentString (array)`- Facoltativo. 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)`- Facoltativo. 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)`- Facoltativo. Se impostato su true, restituisce l'oggetto regola modificato.
**Esempi:**
1. Aggiorna le proprietà della regola 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"
}
```
##### Rimuovi- Regola FSx FSRMClassification
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- FSx FSRMMgmt Property
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. Un percorso verso 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"
}
```
#### Rimuovi- Proprietà FSx FSRMMgmt
Rimuove le proprietà di gestione dalle cartelle specificate.
##### Parameters
+ `Namespace (string)`- Facoltativo. Un percorso verso 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 dello spazio dei nomi. 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- FSx FSRMMgmt Property
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)`- Facoltativo. Il percorso della cartella.
+ `Name (string)`- Obbligatorio. Il nome della proprietà di gestione da modificare. Deve essere una proprietà di classificazione esistente applicabile 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
#### Ottieni- FSx FSRMClassification
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 esecuzione
+ `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
}
```
#### Inizia- FSx FSRMClassification
Avvia il processo di classificazione dei file, che applica le regole di classificazione ai file e genera un rapporto di classificazione.
##### Parameters
+ `Queue (boolean)`- Facoltativo. Se impostato su true, aggiunge l'attività di classificazione a una coda da eseguire entro i successivi 5 minuti. Tutte le attività in coda durante questo periodo verranno eseguite contemporaneamente. Se impostata su false o non specificata, la classificazione inizia immediatamente.
+ `RunDuration (number)`- Facoltativo. Specifica per 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 classificazione senza limiti di tempo.
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Start-FSxFSRMClassification -RunDuration 0
}
```
#### Smettila... FSx FSRMClassification
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
}
```
#### Aspetta... FSx FSRMClassification
Attende il completamento del processo di classificazione dei file. Utilizzate questo comando quando è necessario eseguire azioni che dipendono dal completamento della classificazione, come la generazione di report basati su file classificati.
##### Parameters
+ `Timeout (number)`- Facoltativo. Specificate 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 fino al completamento della classificazione (impostazione predefinita)
+ `0`: Controlla lo stato attuale e torna immediatamente senza aspettare
**Esempi:**
1. Attendi a tempo indeterminato il completamento della classificazione.
```
Invoke-Command -ComputerName $FSxWindowsRemotePowerShellEndpoint -ConfigurationName FSxRemoteAdmin -ScriptBlock {
Wait-FSxFSRMClassification
}
```
#### Impostare- FSx FSRMClassification
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 di esecuzione dell'attività (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, consente la classificazione continua dello sfondo.
+ `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
}
```