Set-DlpSensitiveInformationType

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni potrebbero essere esclusivi di un ambiente o dell'altro.

Usare il cmdlet Set-DlpSensitiveInformationType per modificare le regole del tipo di informazioni riservate che usano le impronte digitali del documento.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Default (Impostazione predefinita)

Set-DlpSensitiveInformationType
    [-Identity] <SensitiveInformationTypeIdParameter>
    [-Confirm]
    [-Description <String>]
    [-FileData <Byte[]>]
    [-Fingerprints <MultiValuedProperty>]
    [-IsExact <Boolean>]
    [-Locale <CultureInfo>]
    [-Name <String>]
    [-Threshold <UInt32>]
    [-ThresholdConfig <PswsHashtable>]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

I pacchetti di regole per il tipo di informazioni sensibili vengono usati dalla prevenzione della perdita dei dati (DLP) per rilevare contenuto riservato nei messaggi.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono 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-DlpSensitiveInformationType "Contoso Confidential" -Locale fr -Name "Contoso Confidentiel" -Description "Ce message contient des informations confidentielles." -IsDefault

In questo esempio viene aggiunta una traduzione francese alla regola del tipo di informazioni riservate esistente denominata "Contoso Confidential" e viene impostata come predefinita.

Esempio 2

Set-DlpSensitiveInformationType "Contoso Confidential" -Locale es -Name $null -Description $null

In questo esempio la traduzione spagnola esistente viene rimossa dalla regola del tipo di informazioni riservate denominata "Contoso Confidential".

Esempio 3

$Benefits_Template = [System.IO.File]::ReadAllBytes('C:\My Documents\Contoso Benefits Template.docx')

$Benefits_Fingerprint = New-DlpFingerprint -FileData $Benefits_Template -Description "Contoso Benefits Template"

$Contoso_Confidential = Get-DlpSensitiveInformationType "Contoso Confidential"

$Array = [System.Collections.ArrayList]($Contoso_Confidential.Fingerprints)

$Array.Add($Benefits_FingerPrint[0])

Set-DlpSensitiveInformationType $Contoso_Confidential.Identity -FingerPrints $Array

In questo esempio viene modificata la regola del tipo di informazioni riservate esistente denominata "Contoso Confidential" aggiungendo una nuova impronta digitale del documento per il file C:\Documenti\Contoso Benefits Template.docx senza influire sulle impronte digitali dei documenti già definiti.

Esempio 4

$cc = Get-DlpSensitiveInformationType "Contoso Confidential"

$a = [System.Collections.ArrayList]($cc.Fingerprints)

$a

$a.RemoveAt(0)

Set-DlpSensitiveInformationType $cc.Identity -FingerPrints $a

In questo esempio viene modificata la regola per il tipo di informazioni sensibili denominata "Contoso Confidential" rimuovendo un'impronta digitale di un documento esistente senza influire sulle altre impronte digitali del documento già definite.

I primi tre comandi restituiscono l'elenco delle impronte digitali del documento nel tipo di informazioni riservate. 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 rimuovono la prima impronta digitale del documento visualizzata nell'elenco.

Parametri

-Confirm

Applicabile: Sicurezza & conformità

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma 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, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.

Questo cmdlet ha una pausa incorporata, quindi è consigliabile usare -Confirm:$false per ignorare la conferma.

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: Sicurezza & conformità

Il parametro Descrizione consente di specificare una descrizione per la regola del tipo di informazioni riservate. Utilizzare il parametro Descrizione con i parametri Impostazioni locali e Nome per specificare le descrizioni per la regola del tipo di informazioni sensibili in lingue diverse. I valori localizzati di Description vengono visualizzati nella proprietà AllLocalizedDescriptions della regola del tipo di informazioni sensibili.

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

-FileData

Applicabile: Sicurezza & conformità

{{ Riempimento Descrizione FileData }}

Proprietà dei parametri

Tipo:

Byte[]

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: Sicurezza & conformità

Il parametro Fingerprints consente di specificare i file di documento con codifica di byte che vengono utilizzati come impronte digitali dalla regola del tipo di informazioni sensibili. Per istruzioni su come importare documenti da utilizzare come modelli per le impronte digitali, vedere New-DlpFingerprint o la sezione Esempi. Per istruzioni su come aggiungere e rimuovere le impronte digitali dei documenti da una regola esistente per il tipo di informazioni riservate, vedere la sezione Esempi.

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: Sicurezza & conformità

Il parametro Identity consente di specificare la regola del tipo di informazioni riservate che si desidera modificare. È possibile usare qualsiasi valore che identifichi in modo univoco la regola del tipo di informazioni riservate. Ad esempio:

  • Nome
  • LocalizedName
  • Valore GUID di identità

Proprietà dei parametri

Tipo:SensitiveInformationTypeIdParameter
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

-IsExact

Applicabile: Sicurezza & conformità

{{ Fill IsExact Description }}

Proprietà dei parametri

Tipo:Boolean
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: Sicurezza & conformità

Il parametro Impostazioni locali aggiunge o rimuove le lingue associate alla regola del tipo di informazioni riservate.

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.

In genere, è possibile utilizzare il parametro Impostazioni locali con i parametri Nome e Descrizione per aggiungere o rimuovere nomi e descrizioni tradotti per la regola del tipo di informazioni riservate. È 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: Sicurezza & conformità

Il parametro Name consente di specificare un nome per la regola del tipo di informazioni riservate. Il valore deve contenere meno di 256 caratteri.

Utilizzare il parametro Name con i parametri Locale e Description per specificare i nomi per la regola del tipo di informazioni riservate in lingue diverse. I valori localizzati di Name vengono visualizzati nella proprietà AllLocalizedNames della regola del tipo di informazioni sensibili.

Il valore del parametro Nome 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

-Threshold

Applicabile: Sicurezza & conformità

{{ Descrizione soglia riempimento }}

Proprietà dei parametri

Tipo:UInt32
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

-ThresholdConfig

Applicabile: Sicurezza & conformità

{{ Fill ThresholdConfig Description }}

Proprietà dei parametri

Tipo:PswsHashtable
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: Sicurezza & conformità

Il parametro WhatIf non funziona in PowerShell per sicurezza e conformità.

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.