Set-ScannerConfiguration
Imposta la configurazione facoltativa per lo scanner Microsoft Purview Information Protection.
Sintassi
Default (Impostazione predefinita)
Set-ScannerConfiguration
[-ReportLevel <ReportLevel>]
[-OnlineConfiguration <OnlineConfiguration>]
[-FeatureSettings <Hashtable>]
Descrizione
Il cmdlet Set-ScannerConfiguration consente di impostare le impostazioni di configurazione locali per lo scanner Microsoft Purview Information Protection.
La maggior parte delle impostazioni di configurazione dello scanner viene configurata nel Portale di conformità di Microsoft Purview, ma è necessario usare questo cmdlet se è necessario importare le impostazioni di configurazione da un file perché lo scanner non è in grado di supportare la configurazione online o se è necessario modificare il livello di report per i report creati localmente.
Eventuali modifiche verranno utilizzate alla successiva esecuzione dello scanner. Se è necessario che le modifiche abbiano effetto immediato, riavviare lo scanner Microsoft Purview Information Protection nel computer server Windows.
Esempio
Esempio 1: Impostare lo scanner di Microsoft Purview Information Protection per l'uso della configurazione online
PS C:\> Set-ScannerConfiguration -OnlineConfiguration On
Configuration was set successfully.
Questo comando imposta lo scanner in modo che ottenga la configurazione direttamente dal servizio Microsoft Purview Information Protection.
Esempio 2: Abilita una funzione scanner a livello di cluster (anteprima)
PS C:\> Set-ScannerConfiguration -FeatureSettings @{CustomReporting=$true}
Configuration was set successfully.
Questo comando abilita la funzione Reportistica Personalizzata per l'intero cluster degli scanner. Tutti i nodi rilevano la modifica al prossimo ciclo di scansione. Non è necessario riavviare il servizio.
Puoi passare più funzionalità in una singola tabella hash. Il cmdlet valida ogni nome e valore di funzionalità prima di scrivere qualsiasi cosa; Se una voce non è valida, la chiamata termina e non vengono applicate alcuna impostazione.
Se una funzionalità viene gestita dal Portale di Microsoft Purview, il cmdlet la salta con un avviso e lascia lo stato del cluster invariato. Altre funzionalità nella stessa chiamata sono ancora applicate.
Per informazioni di fondo e l'elenco delle funzionalità supportate da questa versione client, vedi Controllo delle funzionalità dello scanner (anteprima).
Parametri
-FeatureSettings
(Anteprima pubblica) Configura le funzionalità dello scanner Microsoft Purview Information Protection a livello di cluster. L'impostazione si applica a ogni nodo del cluster al ciclo di scansione successivo. Non è necessario riavviare il servizio.
-FeatureSettings accetta una tabella hash PowerShell con le coppie di nomi e impostazioni di funzionalità. Ogni chiave è il nome della funzione (ad esempio, CustomReporting); i valori supportati per ogni caratteristica sono documentati nel controllo delle funzionalità dello scanner (anteprima).
Ad esempio: Set-ScannerConfiguration -FeatureSettings @{CustomReporting=$true}.
Sia il nome che il valore della caratteristica vengono convalidati prima che venga scritta qualsiasi modifica. Se una voce è invalida, il cmdlet termina e nessuna voce dalla tabella hash viene applicata.
Se una funzionalità è stata configurata dal Portale di Microsoft Purview, il cmdlet emette un avviso e lascia invariata la riga di quella funzionalità. Altre funzionalità nello stesso hashtable che non sono gestite dal portale sono comunque applicate.
Per contesto, funzionalità supportate ed esempi, vedi Controllo delle funzionalità dello scanner (anteprima).
Se una funzionalità è stata configurata dal Portale di Microsoft Purview, il cmdlet emette un avviso e lascia invariata la riga di quella funzionalità. Altre funzionalità nello stesso hashtable che non sono gestite dal portale sono comunque applicate.
Per contesto, l'elenco delle funzionalità supportate da questa versione client e gli esempi, vedi Controllo delle funzionalità dello scanner (anteprima).
Proprietà dei parametri
| Tipo: | Hashtable |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-OnlineConfiguration
Specifica se lo scanner ottiene le impostazioni di configurazione direttamente dal servizio Microsoft Purview Information Protection (impostazione predefinita) o usa un file di configurazione offline.
Su: L'impostazione predefinita. Lo scanner ottiene le impostazioni di configurazione direttamente dal servizio Microsoft Purview Information Protection.
Spento: Lo scanner non è in grado di ottenere le impostazioni di configurazione direttamente dal servizio Microsoft Purview Information Protection. Al contrario, lo scanner viene configurato dalle impostazioni importate da un file.
Se lo scanner non è in grado di supportare la configurazione online, è comunque necessario configurare lo scanner nel portale di Azure. Esportare quindi la configurazione dello scanner dal portale in un file .json e importare questo file usando il cmdlet Import-ScannerConfiguration .
Proprietà dei parametri
| Tipo: | OnlineConfiguration |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ReportLevel
Definire il livello di registrazione per i report dello scanner. Per impostazione predefinita, nel file di registro vengono inclusi solo i file etichettati correttamente dallo scanner o che contengono tipi di informazioni riservate.
I file di registro vengono archiviati nella cartella%localappdata%\Microsoft\MSIP\Scanner\Reports . Un rapporto di riepilogo (.txt) include il tempo impiegato per la scansione, il numero di file scansionati e le statistiche sul numero di file classificati e protetti. I report dettagliati (.csv) contengono dettagli per ogni file. La cartella memorizza fino a 60 report per ogni ciclo di scansione e tutti i report, tranne l'ultimo, vengono compressi per ridurre al minimo lo spazio su disco richiesto.
| Livello di registrazione | Descrizione |
|---|---|
| Debug | Registra tutti i file individuati e l'azione risultante. Questo livello di registrazione è utile per la risoluzione dei problemi, ma rallenta lo scanner di Microsoft Purview Information Protection. Questa categoria include i file che non soddisfano nessuna delle condizioni e i file che vengono ignorati a causa di un tipo di file non supportato.
Ad esempio, il tentativo di etichettare un file per la sola classificazione quando il tipo di file non supporta questa azione e il tentativo di etichettare i file che vengono esclusi automaticamente. |
| Info (impostazione predefinita) | Registra solo i file che: - Sono stati etichettati correttamente dallo scanner - Sarebbe stato etichettato dallo scanner, se lo scanner non fosse stato in modalità di rilevamento - Contengono tipi di informazioni sensibili |
| Errore | Registra solo i file che lo scanner ha tentato di etichettare o identificare, ma non è stato in grado di identificare. Ad esempio, un file era in uso o il servizio scanner non disponeva dell'accesso in scrittura al file. |
| Disattivato | Disabilita la creazione di report, che si traduce in prestazioni ottimali per lo scanner. |
Il registro eventi locale di Applicazioni e servizi Windows, Information Protection Scanner , contiene informazioni di registrazione aggiuntive. Gli eventi includono l'ora di inizio e di fine di ogni ciclo di scansione, quando a un file scansionato viene applicata un'etichetta e quando la protezione viene applicata o rimossa.
Proprietà dei parametri
| Tipo: | ReportLevel |
| Valore predefinito: | None |
| Valori accettati: | Off, Debug, Info, Error |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |