Set-ScannerContentScan

  • Referenz
Modul:
PurviewInformationProtection

Definiert Einstellungen für einen Microsoft Purview Information Protection Scanauftrag für Inhalt des Scanners.

Syntax

Set-ScannerContentScan
   [-Schedule <Schedule>]
   [-DiscoverInformationTypes <DiscoverInformationTypes>]
   [-RecommendedAsAutomatic <OnOffEnum>]
   [-EnableDlp <OnOffEnum>]
   [-Enforce <OnOffEnum>]
   [-LabelFilesByContent <OnOffEnum>]
   [-RelabelFiles <OnOffEnum>]
   [-AllowLabelDowngrade <OnOffEnum>]
   [-EnforceDefaultLabel <OnOffEnum>]
   [-DefaultLabelType <DefaultLabelType>]
   [-DefaultLabelId <Guid>]
   [-DefaultOwner <String>]
   [-RepositoryOwner <String>]
   [-PreserveFileDetails <OnOffEnum>]
   [-IncludeFileTypes <String>]
   [-ExcludeFileTypes <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Definiert die Konfiguration für Ihren Inhaltsüberprüfungsauftrag, der den Inhalt in den definierten Repositorys gemäß den definierten Einstellungen überprüft. Weitere Informationen zu Aufträgen zur Inhaltsüberprüfung finden Sie in der Dokumentation zu Microsoft Purview Information Protection lokalen Scannern.

Beispiele

Beispiel 1 Definieren der Standardeinstellungen für den Inhaltsüberprüfungsauftrag

PS C:\WINDOWS\system32> Set-ScannerContentScan -Enforce Off

In diesem Beispiel wird der Inhaltsüberprüfungsauftrag mit Den Standardeinstellungen definiert und die Option Richtlinienerzwingung auf Aus festgelegt.

Beispiel 2 Definieren eines grundlegenden Inhaltsüberprüfungsauftrags, der kontinuierlich ausgeführt wird

PS C:\WINDOWS\system32> Set-ScannerContentScan -Enforce Off -RelabelFiles On -EnforceDefaultLabel On -Schedule Always

In diesem Beispiel wird der Inhaltsüberprüfungsauftrag mit definiert, ohne eine Richtlinie zu erzwingen, sodass Dateien mit einer Standardbezeichnung neu beschriftet werden können. Die Ausführung wird für immer geplant.

Beispiel 3: Definieren eines Inhaltsüberprüfungsauftrags, der nur bestimmte Aktionen zur Neubeschriftung zulässt

PS C:\WINDOWS\system32> Set-ScannerContentScan -RelabelFiles On -AllowLabelDowngrade On -EnforceDefaultLabel On

In diesem Beispiel wird ein Inhaltsüberprüfungsauftrag definiert, mit dem Inhalte nur umbeschriftet werden können, um eine Bezeichnung herabzustufen oder eine Standardbezeichnung zu verwenden.

Beispiel 4 Definieren eines Inhaltsüberprüfungsauftrags, der .msg und .tmp Dateien ausschließt

PS C:\WINDOWS\system32> Set-ScannerContentScan -IncludeFileTypes '' -ExcludeFileTypes '.msg,.tmp'

In diesem Beispiel wird ein Inhaltsüberprüfungsauftrag definiert, der alle Dateitypen außer .msg und .tmp Dateien enthält.

Beispiel 5 Definieren eines Inhaltsüberprüfungsauftrags mit aktiviertem DLP und einem bestimmten Repositorybesitzer

PS C:\WINDOWS\system32> Set-ScannerContentScan -EnableDLP On -RepositoryOwner 'domain\user'

In diesem Beispiel wird der Inhaltsüberprüfungsauftrag für die Verwendung der Vertraulichkeitsinformationstypen zur Verhinderung von Datenverlust (Data Loss Prevention, DLP) von Microsoft Purview definiert, wenn Ihre Inhalte überprüft werden. Außerdem wird ein bestimmter Besitzer für die Repositorys des Inhaltsüberprüfungsauftrags definiert.

Beispiel 6 Definieren eines Inhaltsüberprüfungsauftrags mit einer Standardbezeichnung, die beim automatischen Bezeichnen von Inhalten verwendet werden soll

PS C:\WINDOWS\system32> Set-ScannerContentScan -DefaultLabelType Custom -DefaultLabelId 'ff1f1c9d-2f92-4a18-3d84-4608b742424'

In diesem Beispiel wird der Inhaltsüberprüfungsauftrag mit einer bestimmten Bezeichnung definiert, die als Standardbezeichnung verwendet wird, die durch die Bezeichnungs-ID angegeben wird.

Parameter

-AllowLabelDowngrade

Bestimmt, ob der Inhaltsüberprüfungsauftrag das Bezeichnen von Downgradeaktionen zulässt.

Nur relevant, wenn der RelabelFiles-Parameter auf On festgelegt ist.

Typ:OnOffEnum
Zulässige Werte:On, Off
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultLabelId

Definiert die ID der Standardbezeichnung, die beim automatischen Bezeichnen von Inhalten mit einer Standardbezeichnung verwendet wird.

Obligatorisch, wenn der DefaultLabelType-Parameter auf custom festgelegt ist.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultLabelType

Bestimmt den Typ der Standardbezeichnung, die beim automatischen Bezeichnen von Inhalten mit einer Standardbezeichnung verwendet wird.

Definieren Sie bei Verwendung die Bezeichnungs-ID, die Sie als Standard-ID verwenden möchten, mit dem DefaultLabelId-Parameter .

Typ:DefaultLabelType
Zulässige Werte:None, PolicyDefault, Custom
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultOwner

Definiert den Standardbesitzerwert, der für die gescannten Dateien verwendet wird, und verwendet dabei die E-Mail-Adresse des Kontos. Standardmäßig ist dies das Scannerkonto.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DiscoverInformationTypes

Bestimmt die Typen von Informationstypen, die während des Inhaltsüberprüfungsauftrags ermittelt werden.

Typ:DiscoverInformationTypes
Zulässige Werte:PolicyOnly, All
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableDlp

Bestimmt, ob der Auftrag für die Inhaltsüberprüfung die Dlp-Vertraulichkeitsinformationstypen (Data Loss Prevention, Verhinderung von Datenverlust) verwendet, wenn Ihre Inhalte überprüft werden.

Tipp

Wenn Sie diesen Parameter konfigurieren, können Sie auch einen bestimmten Repositorybesitzer mithilfe des RepositoryOwner-Parameters konfigurieren.

Typ:OnOffEnum
Zulässige Werte:On, Off
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Enforce

Bestimmt, ob der Inhaltsüberprüfungsauftrag die Inhaltsüberprüfung und Bezeichnung gemäß Ihrer Richtlinie erzwingt.

Typ:OnOffEnum
Zulässige Werte:On, Off
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnforceDefaultLabel

Bestimmt, ob bei der Neubeschriftung von Inhalten immer eine Standardbezeichnung verwendet wird.

Nur relevant, wenn der RelabelFiles-Parameter auf On festgelegt ist.

Typ:OnOffEnum
Zulässige Werte:On, Off
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ExcludeFileTypes

Bestimmt alle Dateitypen, die während Ihres Inhaltsüberprüfungsauftrags ignoriert werden. Definieren Sie mehrere Dateitypen mithilfe einer durch Trennzeichen getrennten Liste.

Wenn Sie diesen Parameter definieren, definieren Sie den IncludeFileTypes-Parameter als NULL. Beispiel 4 oben.

Nur relevant, wenn der OverrideContentScanJob-Parameter in den Cmdlets Add-ScannerRepository oder Set-ScannerRepository auf On festgelegt ist.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IncludeFileTypes

Bestimmt explizit die Dateitypen, die von Ihrem Inhaltsüberprüfungsauftrag überprüft werden. Definieren Sie mehrere Dateitypen mithilfe einer durch Trennzeichen getrennten Liste.

Wenn Sie diesen Parameter definieren, definieren Sie den ExcludeFileTypes-Parameter als NULL. Beispiel 4 oben.

Nur relevant, wenn der OverrideContentScanJob-Parameter in den Cmdlets Add-ScannerRepository oder Set-ScannerRepository auf On festgelegt ist.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LabelFilesByContent

Bestimmt, ob die Option Beschriftungsdateien basierend auf dem Scanauftrag für Inhaltsinhalte aktiviert oder deaktiviert ist.

Typ:OnOffEnum
Zulässige Werte:On, Off
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PreserveFileDetails

Bestimmt, ob die Dateidetails, einschließlich des Änderungsdatums, der letzten Änderung und der Änderungen durch Einstellungen, während der Überprüfung und automatischen Bezeichnung beibehalten werden.

Typ:OnOffEnum
Zulässige Werte:On, Off
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RecommendedAsAutomatic

Bestimmt, ob empfohlene Bezeichnungen verwendet werden, um Ihre Inhalte automatisch zu bezeichnen.

Typ:OnOffEnum
Zulässige Werte:On, Off
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RelabelFiles

Bestimmt, ob der Inhaltsüberprüfungsauftrag Dateien neu bezeichnen darf.

Tipp

Wenn Sie diesen Parameter verwenden, verwenden Sie bei Bedarf die folgenden zusätzlichen Parameter:

  • EnforceDefaultLabel
  • AllowLabelDowngrade
Typ:OnOffEnum
Zulässige Werte:On, Off
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RepositoryOwner

Gibt den SAMAccountname (Domäne\Benutzer), den UPN (user@domain) oder die SID einer Gruppe an, die das Repository besitzt.

Den Besitzern werden Vollzugriffsberechtigungen für die Datei gewährt, wenn die Berechtigungen für die Datei durch eine übereinstimmene DLP-Regel geändert werden.

Nur relevant, wenn der Parameter EnableDlp auf On festgelegt ist.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Schedule

Bestimmt, ob der Inhaltsüberprüfungsauftrag nach einem bestimmten Zeitplan oder kontinuierlich ausgeführt wird.

Typ:Schedule
Zulässige Werte:Manual, Always
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

System.Object