Set-DataClassification
Questo cmdlet funziona solo in Exchange locale.
In Exchange Online questo cmdlet viene sostituito dal cmdlet Set-DlpSensitiveInformationType in PowerShell Security & Compliance.
Utilizzare il cmdlet Set-DataClassification per modificare le regole di classificazione dei dati che utilizzando le impronte digitali dei documenti.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Default (impostazione predefinita).
Set-DataClassification
[-Identity] <DataClassificationIdParameter>
[-Confirm]
[-Description <String>]
[-DomainController <Fqdn>]
[-Fingerprints <MultiValuedProperty>]
[-IsDefault]
[-Locale <CultureInfo>]
[-Name <String>]
[-WhatIf]
[<CommonParameters>]
Descrizione
I pacchetti di regole di classificazione vengono utilizzati da DLP per identificare contenuto sensibile nei messaggi.
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.
Esempio
Esempio 1
Set-DataClassification "Contoso Confidential" -Locale fr -Name "Contoso Confidentiel" -Description "Ce message contient des informations confidentielles." -IsDefault
In questo esempio, viene aggiunta la traduzione francese alla regola di classificazione dei dati esistenti denominata "Contoso Confidential" e tale traduzione viene impostata come predefinita.
Esempio 2
Set-DataClassification "Contoso Confidential" -Locale es -Name $null -Description $null
In questo esempio, la traduzione esistente per lo spagnolo viene eliminata dalla regola di classificazione dei dati denominata "Contoso Confidential".
Esempio 3
$Benefits_Template = [System.IO.File]::ReadAllBytes('C:\My Documents\Contoso Benefits Template.docx')
$Benefits_Fingerprint = New-Fingerprint -FileData $Benefits_Template -Description "Contoso Benefits Template"
$Contoso_Confidential = Get-DataClassification "Contoso Confidential"
$Array = [System.Collections.ArrayList]($Contoso_Confidential.Fingerprints)
$Array.Add($Benefits_FingerPrint)
Set-DataClassification $Contoso_Confidential.Identity -FingerPrints $Array
In questo esempio, viene modificata la regola di classificazione dei dati denominata "Contoso Confidential" tramite l'aggiunte di nuove impronte digitali del documento per il file C:\Documenti\Contoso Benefits Template.docx, senza influire sulle impronte digitali già definite per altri documenti.
Esempio 4
$cc = Get-DataClassification "Contoso Confidential"
$a = [System.Collections.ArrayList]($cc.Fingerprints)
$a
$a.RemoveAt(0)
Set-DataClassification $cc.Identity -FingerPrints $a
In questo esempio, la regola di classificazione dei dati denominata "Contoso Confidential" viene modificata tramite la rimozione delle impronte digitali di un documento esistenti, senza influire su quelle già definite.
I primi tre comandi restituiscono l'elenco delle impronte digitali dei documenti nella classificazione dei dati. Le prime impronte digitali del documenti presenti nell'elenco sono indicate dal numero 0, le seconde dal numero 1 e così via. Il numero di indice viene utilizzato per specificare le impronte digitali del documento da rimuovere. Gli ultimi due comandi consentono di rimuovere la prima impronta digitale del documento visualizzata nell'elenco.
Parametri
-Confirm
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.
- I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi:
-Confirm:$false. - La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non dispone di una pausa incorporata. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
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 |
-Description
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Il parametro Description consente di specificare una descrizione relativa alla regola di classificazione dei dati. È possibile utilizzare il parametro Description insieme a quelli Locale e Name al fine di specificare in differenti lingue le descrizioni relative alla regola di classificazione dei dati. I valori tradotti di Description vengono visualizzati nella proprietà AllLocalizedDescriptions della regola di classificazione dei dati.
Proprietà dei parametri
| Tipo: | String |
| 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 |
-DomainController
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.
Proprietà dei parametri
| Tipo: | Fqdn |
| 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 |
-Fingerprints
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Il parametro Fingerprints consente di specificare i file del documento codificati in byte che vengono utilizzati come impronte digitali dalla regola di classificazione dei dati. Per istruzioni su come importare documenti da usare come modelli per le impronte digitali, vedere La nuova impronta digitale o la sezione Esempi. Per istruzioni su come aggiungere e rimuovere le impronte digitali del documento da una regola di classificazione dei dati esistente, vedere la sezione Examples.
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| 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 |
-Identity
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Il parametro Identity consente di specificare la regola di classificazione dei dati da modificare. È possibile utilizzare qualsiasi valore che identifichi la regola di classificazione dei dati in modo univoco. Ad esempio:
- Nome
- LocalizedName
- Valore GUID identità
Proprietà dei parametri
| Tipo: | DataClassificationIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-IsDefault
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
L'opzione IsDefault viene utilizzata insieme al parametro Locale per indicare la lingua predefinita per la regola di classificazione dei dati. Con questa opzione non è necessario specificare alcun valore.
Il valore Locale predefinito, viene memorizzato nella proprietà DefaultCulture.
Quando viene modificato il valore Locale predefinito, il valore Name relativo alla regola di classificazione dei dati viene modificato per rispecchiare il valore Name associato alle nuove impostazioni locali predefinite. Il valore Name originale, definito durante la creazione della regola, viene memorizzato nella proprietà LocalizedName.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| 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 |
-Locale
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Il parametro Locale consente di aggiungere o rimuovere le lingue associate alla regola di classificazione dei dati.
L'input valido per questo parametro è un valore di codice delle impostazioni cultura supportato dalla classe CultureInfo di Microsoft .NET Framework. Ad esempio, da-DK per il danese o ja-JP per il giapponese. Per altre informazioni, vedere Classe CultureInfo.
Di solito, il parametro Locale viene utilizzato insieme a quelli Name e Description al fine di aggiungere o rimuovere le descrizioni e i nomi tradotti relativi alla regola di classificazione dei dati. È anche possibile utilizzare il parametro Locale insieme all'opzione IsDefault, al fine di indicare come predefinito una descrizione e un nome tradotto già esistenti. Prima di rimuovere la traduzione predefinita, è necessario impostarne un'altra.
Proprietà dei parametri
| Tipo: | CultureInfo |
| 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 |
-Name
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Il parametro Name consente di specificare un nome relativo alla regola di classificazione dei dati. Il valore deve contenere meno di 256 caratteri.
È possibile utilizzare il parametro Name insieme a quelli Locale e Description al fine di specificare in differenti lingue i nomi relativi alla regola di classificazione dei dati. I valori tradotti di Name vengono visualizzati nella proprietà AllLocalizedNames della regola di classificazione dei dati.
Il valore del parametro Name viene usato nel suggerimento per i criteri presentato agli utenti in Outlook sul web. Quando si stabilisce una corrisponde tra il valore del parametro Name tradotto e la lingua del client, il suggerimento del criterio viene visualizzato nella lingua del client. Se nessun valore tradotto del parametro Name corrisponde alla lingua del client, per il suggerimento del criterio viene utilizzata la traduzione predefinita specificata dal parametro IsDefault.
Proprietà dei parametri
| Tipo: | String |
| 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 |
-WhatIf
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
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 |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.
Input
Input types
Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.
Output
Output types
Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.