New-DlpSensitiveInformationType

Questo cmdlet è disponibile solo in PowerShell conformità alla sicurezza & . Per altre informazioni, vedere PowerShell conformità alla sicurezza&.

Usare il cmdlet New-DlpSensitiveInformationType per creare regole relative al tipo di informazioni riservate che usano le impronte digitali dei documenti.

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

Sintassi

New-DlpSensitiveInformationType
   [[-Name] <String>]
   [-Fingerprints <MultiValuedProperty>]
   [-Confirm]
   [-Description <String>]
   [-FileData <Byte[]>]
   [-IsExact <Boolean>]
   [-Locale <CultureInfo>]
   [-ThresholdConfig <PswsHashtable>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

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

Per usare questo cmdlet in Security & Compliance PowerShell, è necessario disporre delle autorizzazioni. Per ulteriori informazioni, vedere Autorizzazioni nel portale di conformità di Microsoft Purview.

Esempio

Esempio 1

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

$Employee_Fingerprint = New-DlpFingerprint -FileData $Employee_Template -Description "Contoso Employee Template"

$Customer_Template = [System.IO.File]::ReadAllBytes('D:\Data\Contoso Customer Template.docx')

$Customer_Fingerprint = New-DlpFingerprint -FileData $Customer_Template -Description "Contoso Customer Template"

New-DlpSensitiveInformationType -Name "Contoso Employee-Customer Confidential" -Fingerprints $Employee_Fingerprint[0],$Customer_Fingerprint[0] -Description "Message contains Contoso employee or customer information."

In questo esempio viene creata una nuova regola del tipo di informazioni riservate denominata "Contoso Employee-Customer Confidential" che usa le impronte digitali dei documenti C:\Documenti\Contoso Employee Template.docx e D:\Data\Contoso Customer Template.docx.

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:Security & Compliance

-Description

Il parametro Description consente di specificare una descrizione per la regola del tipo di informazioni riservate.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-FileData

{{ File di riempimento Descrizione dati }}

Type:Byte[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Fingerprints

Il parametro Fingerprints consente ai file codificati in byte di essere utilizzati come impronte digitali dei documenti. È possibile utilizzare più impronte digitali, divise da virgole. Per istruzioni su come importare documenti da usare come modelli per le impronte digitali, vedere La nuova impronta digitale o la sezione Esempi.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Security & Compliance

-IsExact

{{ Fill IsExact Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Locale

Il parametro Locale consente di specificare la lingua associata 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.

È possibile aggiungere traduzioni di lingua aggiuntive alla regola del tipo di informazioni riservate usando il cmdlet Set-DlpSensitiveInformationType.

Type:CultureInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Name

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

Il valore di questo parametro viene usato nel suggerimento per i criteri presentato agli utenti in Outlook sul web.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ThresholdConfig

{{ Fill ThresholdConfig Description }}

Type:PswsHashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-WhatIf

L'opzione WhatIf non funziona in PowerShell per la conformità alla sicurezza & .

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance