Condividi tramite


New-DataClassification

Questo cmdlet funziona solo in Exchange locale.

In Exchange Online questo cmdlet viene sostituito dal cmdlet New-DlpSensitiveInformationType in PowerShell Security & Compliance.

Utilizzare il cmdlet New-DataClassification per creare le regole relative alla classificazione dei dati che utilizzano le impronte digitali del documento.

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

Sintassi

Default (impostazione predefinita).

New-DataClassification
    [-Name] <String>
    -Description <String>
    -Fingerprints <MultiValuedProperty>
    [-ClassificationRuleCollectionIdentity <ClassificationRuleCollectionIdParameter>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Locale <CultureInfo>]
    [-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

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

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

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

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

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

Questo esempio consente di creare una nuova regola di classificazione dati denominata "Contoso Employee-Customer Confidential" che utilizza le impronte digitali del documento dei file C:\Documenti\Contoso Employee Template.docx e D:\Dati\Contoso Customer Template.docx.

Parametri

-ClassificationRuleCollectionIdentity

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Questo parametro è riservato all'uso interno da parte di Microsoft.

Proprietà dei parametri

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

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
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 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.

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Locale

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

È possibile aggiungere ulteriori traduzioni alla regola di classificazione dei dati, utilizzando il cmdlet Set-DataClassification.

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.

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
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.