Share via


Set-DataClassification

Dieses Cmdlet ist nur in lokalem Exchange funktionsfähig.

In Exchange Online wurde dieses Cmdlet durch das Cmdlet Set-DlpSensitiveInformationType in Security & Compliance PowerShell ersetzt.

Verwenden Sie das Cmdlet Set-DataClassification, um die Datenklassifizierungsregeln zu ändern, die Dokumentfingerabdrücke verwenden.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

Set-DataClassification
   [-Identity] <DataClassificationIdParameter>
   [-Confirm]
   [-Description <String>]
   [-DomainController <Fqdn>]
   [-Fingerprints <MultiValuedProperty>]
   [-IsDefault]
   [-Locale <CultureInfo>]
   [-Name <String>]
   [-WhatIf]
   [<CommonParameters>]

Beschreibung

Klassifizierungsregelpakete werden von der Verhinderung von Datenverlust (Data Loss Prevention, DLP) verwendet, um vertrauliche Inhalte in Nachrichten zu erkennen.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

Set-DataClassification "Contoso Confidential" -Locale fr -Name "Contoso Confidentiel" -Description "Ce message contient des informations confidentielles." -IsDefault

In diesem Beispiel wird der vorhandenen Datenklassifizierungsregel namens "Contoso Confidential" eine französische Übersetzung hinzugefügt und diese französische Übersetzung als Standard festgelegt.

Beispiel 2

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

In diesem Beispiel wird die vorhandene spanische Übersetzung aus der Datenklassifizierungsregel namens "Contoso Confidential" entfernt.

Beispiel 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 diesem Beispiel wird die vorhandene Datenklassifizierungsregel namens "Contoso Confidential" verändert, indem ein neuer Dokumentfingerabdruck für die Datei "C:\My Documents\Contoso Benefits Template.docx" hinzugefügt wird, ohne dass sich dies auf die bereits definierten Dokumentfingerabdrücke auswirkt.

Beispiel 4

$cc = Get-DataClassification "Contoso Confidential"

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

$a

$a.RemoveAt(0)

Set-DataClassification $cc.Identity -FingerPrints $a

In diesem Beispiel wird die vorhandene Datenklassifizierungsregel namens "Contoso Confidential" verändert, indem ein vorhandener Dokumentfingerabdruck entfernt wird, ohne dass sich dies auf die bereits definierten Dokumentfingerabdrücke auswirkt.

Die ersten drei Befehle geben die Liste der Dokumentfingerabdrücke in der Datenklassifizierung zurück. Der erste Dokumentfingerabdruck in der Liste hat die Indexnummer 0, der Zweite die Indexnummer 1 usw. Sie verwenden die Indexnummer, um den Dokumentfingerabdruck anzugeben, den Sie entfernen möchten. Mit den letzten beiden Befehlen wird der erste Dokumentfingerabdruck entfernt, der in der Liste angezeigt wird.

Parameter

-Confirm

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

  • Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
  • Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
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

Der Parameter Description gibt eine Beschreibung für die Datenklassifizierungsregel an. Sie können mit dem Parameter Description in Kombination mit den Parametern Locale und Name verschiedensprachige Beschreibungen für die Datenklassifizierungsregel angeben. Die lokalisierten Werte von Description erscheinen in der AllLocalizedDescriptions-Eigenschaft der Datenklassifizierungsregel.

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

Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: 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

Der Parameter Fingerprints gibt das bytecodierten Dokumentdateien an, die von der Datenklassifizierungsregel als Fingerabdrücke verwendet werden. Anweisungen zum Importieren von Dokumenten zur Verwendung als Vorlagen für Fingerabdrücke finden Sie unter New-Fingerprint oder im Abschnitt Beispiele. Anweisungen zum Hinzufügen zu und Entfernen von Fingerabdrücken aus einer vorhandenen Datenklassifizierungsregel finden Sie im Abschnitt 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

Der Parameter Identity gibt die Datenklassifizierungsregel an, die Sie ändern möchten. Sie können einen beliebigen Wert verwenden, der die Datenklassifizierungsregel eindeutig identifiziert. Beispiel:

  • Name
  • LocalizedName
  • Identitäts-GUID-Wert
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

Die Option IsDefault wird zusammen mit dem Parameter Locale verwendet, um die Standardsprache für die Datenklassifizierungsregel anzugeben. Sie müssen keinen Wert für diese Option angeben.

Der Standardwert für Locale wird in der Eigenschaft DefaultCulture gespeichert.

Wenn Sie den Standardwert für Locale ändern, dann ändert sich der Name-Wert der Datenklassifizierungsregel entsprechend, sodass er dem Name-Wert entspricht, der dem neuen Locale-Wert zugeordnet ist. Der ursprüngliche beim Erstellen der Regel definierte Name-Wert wird dauerhaft in der Eigenschaft LocalizedName gespeichert.

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

Mit dem Parameter Locale werden der Datenklassifizierungsregel zugeordnete Sprachen hinzugefügt oder entfernt.

Gültige Eingabe für diesen Parameter ist ein unterstützter Kulturcodewert aus der Microsoft .NET Framework CultureInfo-Klasse. Beispiel: da-DK für Dänisch oder ja-JP für Japanisch. Weitere Informationen finden Sie unter CultureInfo-Klasse.

In der Regel wird der Parameter Locale in Kombination mit den Parametern Name und Description verwendet, um übersetzte Namen und Beschreibungen der Datenklassifizierungsregel hinzuzufügen oder daraus zu entfernen. Sie können den Parameter Locale auch in Kombination mit der Option IsDefault verwenden, um einen vorhandenen übersetzten Namen und eine übersetzte Beschreibung als Standard festzulegen. Sie können die Standardübersetzung erst entfernen, nachdem Sie eine andere Übersetzung als Standard festgelegt haben.

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

Der Parameter Name gibt den Namen der Datenklassifizierungsregel an. Der Wert darf maximal 256 Zeichen lang sein.

Sie verwenden den ParameterName in Kombination mit den Parametern Locale und Description, um für die Datenklassifizierungsregel Namen in anderen Sprachen anzugeben. Die lokalisierten Werte von Name erscheinen in der Eigenschaft AllLocalizedNames der der Datenklassifizierungsregel,

Der Wert des Parameters Name wird im Richtlinientipp verwendet, der Benutzern in Outlook im Web angezeigt wird. Wenn ein übersetzter Wert des Name-Parameters mit der Sprache des Clients übereinstimmt, dann wird der Richtlinientipp in der Sprache des Clients angezeigt. Wenn keine übersetzten Werte des Parameters Name mit der Sprache des Clients übereinstimmen, dann wird die Standardübersetzung, die durch den Parameter IsDefault festgelegt wird, für die Richtlinieninfo verwendet.

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

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

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

Eingaben

Input types

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Ausgaben

Output types

Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.