Set-DataClassification

Questo cmdlet funziona solo in Exchange locale.

In Exchange Online questo cmdlet è stato sostituito dal cmdlet Set-DlpSensitiveInformationType in Security & Compliance PowerShell.

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

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. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. 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

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-*, hanno una pausa predefinita che impone 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 hanno una pausa predefinita. 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.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Description

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

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.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Fingerprints

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.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

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à
Type:DataClassificationIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IsDefault

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Locale

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 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.

Type:CultureInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Name

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-WhatIf

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.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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.