Set-DataClassification
Dieses Cmdlet ist nur in lokalem Exchange funktionsfähig.
In Exchange Online wird 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
Default (Standardwert)
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. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen 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
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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 (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen:
-Confirm:$false. - Die meisten anderen Cmdlets (beispielsweise 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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Description
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-DomainController
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Parametereigenschaften
| Typ: | Fqdn |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Fingerprints
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
Parametereigenschaften
| Typ: | MultiValuedProperty |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Identity
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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
Parametereigenschaften
| Typ: | DataClassificationIdParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-IsDefault
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Locale
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
Parametereigenschaften
| Typ: | CultureInfo |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Name
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.
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 und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.