Controllo delle funzionalità dello scanner (anteprima)

Questo articolo descrive come gli amministratori dello scanner possono abilitare, disabilitare e configurare le funzionalità dello scanner di Microsoft Purview Information Protection supportate a livello di cluster tramite PowerShell.

Amministrazione configurazione delle funzionalità controllata è disponibile con Microsoft Purview Information Protection client e scanner versione 3.2.89.0 o successiva.

Funzionamento del controllo funzionalità

Le funzionalità dello scanner vengono configurate una volta per ogni cluster di scanner. Le impostazioni vengono archiviate in una tabella dedicata dbo.Features nel database del cluster dello scanner condiviso. Ogni nodo del cluster legge dalla stessa tabella, ovvero:

• Un amministratore esegue un cmdlet di configurazione una volta da qualsiasi nodo del cluster e tutti i nodi raccolgono la modifica nel ciclo di analisi successivo.
• Non è necessario riavviare il servizio.
• I nodi non possono ottenere stati di funzionalità non corrispondenti.
• La disabilitazione di una funzionalità interrompe l'azione eseguita dalla funzionalità, ad esempio la scrittura in una nuova tabella di database o la produzione di un nuovo file. I dati esistenti non vengono eliminati, quindi è possibile riabilitare la funzionalità in un secondo momento senza perdita di dati.
• Le funzionalità non configurate in modo esplicito non hanno una riga nella dbo.Features tabella e usano il codice predefinito (in genere Disattivato). Le righe vengono aggiunte solo quando un amministratore imposta in modo esplicito una funzionalità.

Ogni riga in dbo.Features registra la funzionalità Name, ( Setting una stringa come On o Off) e l'oggetto Source che ha scritto il valore (PowerShell o Portal).

La creazione di report personalizzati è la prima funzionalità fornita tramite la configurazione delle funzionalità controllata dall'amministratore. Per informazioni dettagliate su tale funzionalità, vedere Creazione di report personalizzati (anteprima).

Evoluzione del controllo: PowerShell e il portale di Microsoft Purview

Amministrazione configurazione delle funzionalità controllata è progettata per evolversi nel tempo. Attualmente, le funzionalità supportate vengono configurate tramite PowerShell. Man mano che le funzionalità diventano disponibili nel portale di Microsoft Purview, il portale diventa l'origine della verità per tali funzionalità.

Le regole seguenti si applicano quando entrambe le superfici sono disponibili per una funzionalità:

• PowerShell prima di tutto. Finché non viene esposta una funzionalità nel portale di Microsoft Purview, gli amministratori lo configurano da PowerShell in qualsiasi nodo del cluster. Ogni scrittura di PowerShell imposta la colonna della Source riga su PowerShell.
• Il portale ha la precedenza. Quando una funzionalità è stata configurata dal portale di Microsoft Purview, la relativa riga in dbo.Features contiene Source = 'Portal'. Alla successiva esecuzione Set-ScannerConfiguration -FeatureSettings di un amministratore per la stessa funzionalità, il cmdlet genera un avviso nel formato "Nome funzionalità<>" gestito dal portale Purview e non può essere modificato tramite PowerShell. Saltare." e lascia invariato lo stato del cluster. Altre funzionalità nella stessa -FeatureSettings tabella hash che non sono gestite dal portale vengono ancora applicate.
• Nessuna sincronizzazione. Le impostazioni non vengono sincronizzate tra PowerShell e il portale. Non tutte le funzionalità dello scanner finiranno per essere configurabili dal portale. Quando una funzionalità è disponibile nel portale ed è stata configurata, l'impostazione configurata dal portale ha la precedenza e impedisce gli aggiornamenti da PowerShell. Esiste una singola fonte di verità (la riga in ) in dbo.Featuresqualsiasi momento.
• Get riflette sempre lo stato. Indipendentemente dalla posizione in cui è stata configurata una funzionalità, Get-ScannerConfiguration restituisce lo stato corrente di ogni funzionalità configurata, inclusi i Setting valori e Source . Gli amministratori possono controllare il cluster da PowerShell in qualsiasi momento.

Questo modello significa che gli amministratori dello scanner possono adottare nuove funzionalità tramite PowerShell non appena raggiungono l'anteprima pubblica e passare alla gestione basata su portale al proprio ritmo man mano che le funzionalità diventano disponibili.

Cmdlet supportati e il -FeatureSettings parametro

I cmdlet seguenti accettano il -FeatureSettings parametro :

-FeatureSettings accetta una tabella hash di PowerShell con coppie di nome di funzionalità e impostazione, usando lo stesso modello di -AdvancedSettings:

• La chiave della tabella hash è la funzionalità Name , CustomReportingad esempio .
• Il valore della tabella hash è e Setting viene archiviato così com'è nella colonna del database Setting (VARCHAR(MAX)). Per la creazione di report personalizzati, i valori supportati sono "On" e "Off".

I nomi delle funzionalità vengono convalidati in base all'elenco delle funzionalità supportate dello scanner prima della scrittura di qualsiasi modifica. Un nome di funzionalità sconosciuto fa sì che il cmdlet termini con un errore che elenca le funzionalità supportate; in tale chiamata non vengono applicate voci dalla tabella hash.

Per informazioni generali sul -AdvancedSettings modello, inclusi i suggerimenti per le virgolette di PowerShell e le tabelle hash, vedere Suggerimenti di PowerShell per specificare le impostazioni avanzate e il -AdvancedSettings parametro in Set-Label.

Esempio: Abilitare la creazione di report personalizzati in un cluster esistente

Eseguire quanto segue da qualsiasi nodo nel cluster dello scanner:

Set-ScannerConfiguration -FeatureSettings @{CustomReporting="On"}

Tutti i nodi del cluster raccolgono la modifica nel ciclo di analisi successivo.

Esempio: Abilitare la creazione di report personalizzati in fase di installazione

Install-Scanner -SqlServerInstance SQLSERVER1 -Cluster Europe -FeatureSettings @{CustomReporting="On"}

Esempio: Configurare le impostazioni della funzionalità in una chiamata

Usare la FeatureSettings tabella hash per passare i nomi e i valori delle funzionalità. Attualmente, questa pagina documenta solo CustomReporting:

Set-ScannerConfiguration -FeatureSettings @{CustomReporting="On"}

Esempio: Esaminare lo stato corrente della funzionalità

$cfg = Get-ScannerConfiguration
$cfg.Features                       # hashtable of all configured features
$cfg.Features.CustomReporting       # @{Source=PowerShell; Setting=On}

La Features proprietà è una tabella hash. Il rendering predefinito della visualizzazione elenco lo rende inline come {[<feature>, @{Source=<source>; Setting=<setting>}]}. Ogni valore espone l'oggetto corrente Setting e l'oggetto Source (PowerShell o Portal) che lo ha scritto. Le funzionalità che non sono mai state configurate non vengono visualizzate e accettano il codice predefinito.

Disabilitare una funzionalità

Impostare il valore su "Off". I dati esistenti scritti dalla funzionalità non vengono eliminati; lo scanner interrompe l'esecuzione dell'azione della funzionalità nel ciclo di analisi successivo.

Set-ScannerConfiguration -FeatureSettings @{CustomReporting="Off"}

Funzionalità attualmente supportate

Altre funzionalità verranno aggiunte nel tempo ed elencate nelle note sulla versione.

Vedere anche

• Creazione di report personalizzati (anteprima)
• Configurare e installare lo scanner Microsoft Purview Information Protection
• note sulla versione client Microsoft Purview Information Protection
• Install-Scanner
• Set-ScannerConfiguration
• Get-ScannerConfiguration