Set-ScannerContentScan
Definiert Einstellungen für einen Microsoft Purview Information Protection-Scanner-Inhaltsscanauftrag.
Syntax
Default (Standard)
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]
Beschreibung
Definiert die Konfiguration für Ihren Content-Scan-Job, der den Inhalt in den definierten Repositories gemäß den definierten Einstellungen scannt. Weitere Informationen zu Inhaltsscanaufträgen finden Sie in der Dokumentation zu lokalen Microsoft Purview Information Protection-Scannern.
Beispiele
Beispiel 1 Definieren der Standardeinstellungen für den Inhaltsscanauftrag
PS C:\WINDOWS\system32> Set-ScannerContentScan -Enforce Off
In diesem Beispiel wird der Inhaltsscanauftrag mit den Standardeinstellungen definiert, und die Option Richtlinienerzwingung wird auf Aus festgelegt.
Beispiel 2 Definieren eines einfachen Inhaltsscanauftrags, der kontinuierlich ausgeführt wird
PS C:\WINDOWS\system32> Set-ScannerContentScan -Enforce Off -RelabelFiles On -EnforceDefaultLabel On -Schedule Always
In diesem Beispiel wird der Inhaltsscanauftrag ohne Erzwingen einer Richtlinie definiert, sodass Dateien unter Verwendung einer Standardbezeichnung neu bezeichnet werden können und immer ausgeführt werden sollen.
Beispiel 3 Definieren eines Inhaltsscanauftrags, der nur bestimmte Neubezeichnungsaktionen zulässt
PS C:\WINDOWS\system32> Set-ScannerContentScan -RelabelFiles On -AllowLabelDowngrade On -EnforceDefaultLabel On
In diesem Beispiel wird ein Inhaltsscanauftrag definiert, der das Neubezeichnen von Inhalten nur ermöglicht, um eine Bezeichnung herabzustufen oder eine Standardbezeichnung zu verwenden.
Beispiel 4 Definieren eines Inhaltsscanauftrags, der .msg und .tmp Dateien ausschließt
PS C:\WINDOWS\system32> Set-ScannerContentScan -IncludeFileTypes '' -ExcludeFileTypes '.msg,.tmp'
In diesem Beispiel wird ein Inhaltsscanauftrag definiert, der alle Dateitypen mit Ausnahme von .msg- und .tmp Dateien enthält.
Beispiel 5 Definieren eines Inhaltsscanauftrags mit aktiviertem DLP und einem bestimmten Repository-Besitzer
PS C:\WINDOWS\system32> Set-ScannerContentScan -EnableDLP On -RepositoryOwner 'domain\user'
In diesem Beispiel wird definiert, dass der Inhaltsscanauftrag beim Überprüfen des Inhalts die Vertraulichkeitsinformationstypen (Data Loss Prevention, DLP) von Microsoft Purview verwendet, und es wird auch ein bestimmter Besitzer für die Repositorys des Inhaltsscanauftrags definiert.
Beispiel 6 Definieren eines Inhaltsscanauftrags mit einer Standardbeschriftung, 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 Inhaltsscanauftrag mit einer bestimmten Bezeichnung definiert, die als Standardbezeichnung verwendet wird und durch die Bezeichnungs-ID angegeben wird.
Parameter
-AllowLabelDowngrade
Legt fest, ob der Inhaltsscanauftrag die Bezeichnung von Downgrade-Aktionen zulässt.
Nur relevant, wenn der Parameter RelabelFiles auf on gesetzt ist.
Parametereigenschaften
| Typ: | OnOffEnum |
| Standardwert: | None |
| Zulässige Werte: | On, Off |
| 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 |
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
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 |
-DefaultLabelId
Definiert die ID der Standardbeschriftung, die beim automatischen Bezeichnen von Inhalten mit einer Standardbezeichnung verwendet wird.
Obligatorisch, wenn der Parameter DefaultLabelType auf custom festgelegt ist.
Parametereigenschaften
| Typ: | Guid |
| 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 |
-DefaultLabelType
Bestimmt den Typ der Standardbeschriftung, die beim automatischen Bezeichnen von Inhalten mit einer Standardbezeichnung verwendet wird.
Wenn Sie verwendet werden, definieren Sie die Bezeichnungs-ID, die Sie als Standard-ID verwenden möchten, mithilfe des Parameters DefaultLabelId .
Parametereigenschaften
| Typ: | DefaultLabelType |
| Standardwert: | None |
| Zulässige Werte: | None, PolicyDefault, Custom |
| 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 |
-DefaultOwner
Definiert den Standardwert des Besitzers, der für die gescannten Dateien verwendet wird, unter Verwendung der E-Mail-Adresse des Kontos. Standardmäßig ist dies das Scannerkonto.
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 |
-DiscoverInformationTypes
Bestimmt die Typen von Informationstypen, die während des Inhaltsscanauftrags erkannt werden.
Parametereigenschaften
| Typ: | DiscoverInformationTypes |
| Standardwert: | None |
| Zulässige Werte: | PolicyOnly, All |
| 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 |
-EnableDlp
Bestimmt, ob der Inhaltsscanauftrag beim Scannen des Inhalts die Vertraulichkeitsinformationen zur Verhinderung von Datenverlust (Data Loss Prevention, DLP) verwendet.
Tipp
Wenn Sie diesen Parameter konfigurieren, können Sie auch einen bestimmten Repository-Besitzer mit dem Parameter RepositoryOwner konfigurieren.
Parametereigenschaften
| Typ: | OnOffEnum |
| Standardwert: | None |
| Zulässige Werte: | On, Off |
| 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 |
-Enforce
Bestimmt, ob der Inhaltsscanauftrag die Inhaltsüberprüfung und -kennzeichnung gemäß Ihrer Richtlinie erzwingt.
Parametereigenschaften
| Typ: | OnOffEnum |
| Standardwert: | None |
| Zulässige Werte: | On, Off |
| 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 |
-EnforceDefaultLabel
Legt fest, ob beim Umbenennen von Inhalten immer eine Standardbezeichnung verwendet wird.
Nur relevant, wenn der Parameter RelabelFiles auf on gesetzt ist.
Parametereigenschaften
| Typ: | OnOffEnum |
| Standardwert: | None |
| Zulässige Werte: | On, Off |
| 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 |
-ExcludeFileTypes
Bestimmt alle Dateitypen, die während des Inhaltsscanauftrags ignoriert werden. Definieren Sie mehrere Dateitypen mithilfe einer durch Kommas getrennten Liste.
Wenn Sie diesen Parameter definieren, definieren Sie den Parameter IncludeFileTypes als null. Beispiel: Beispiel 4 oben.
Nur relevant, wenn der Parameter OverrideContentScanJob in den Cmdlets Add-ScannerRepository oder Set-ScannerRepository auf on festgelegt ist.
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 |
-IncludeFileTypes
Bestimmt explizit die Dateitypen, die vom Inhaltsscanauftrag gescannt werden. Definieren Sie mehrere Dateitypen mithilfe einer durch Kommas getrennten Liste.
Wenn Sie diesen Parameter definieren, definieren Sie den Parameter ExcludeFileTypes als null. Beispiel: Beispiel 4 oben.
Nur relevant, wenn der Parameter OverrideContentScanJob in den Cmdlets Add-ScannerRepository oder Set-ScannerRepository auf on festgelegt ist.
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 |
-LabelFilesByContent
Legt fest, ob die Option Dateien basierend auf dem Auftrag zum Scannen von Inhaltsinhalten beschriften aktiviert oder deaktiviert ist.
Parametereigenschaften
| Typ: | OnOffEnum |
| Standardwert: | None |
| Zulässige Werte: | On, Off |
| 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 |
-PreserveFileDetails
Legt fest, ob die Dateidetails, einschließlich des Änderungsdatums, der letzten Änderung und der Einstellungen für geändert von, beim Scannen und bei der automatischen Beschriftung beibehalten werden.
Parametereigenschaften
| Typ: | OnOffEnum |
| Standardwert: | None |
| Zulässige Werte: | On, Off |
| 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 |
-RecommendedAsAutomatic
Legt fest, ob empfohlene Labels verwendet werden, um Ihre Inhalte automatisch zu bezeichnen.
Parametereigenschaften
| Typ: | OnOffEnum |
| Standardwert: | None |
| Zulässige Werte: | On, Off |
| 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 |
-RelabelFiles
Legt fest, ob der Inhaltsscanauftrag Dateien neu bezeichnen darf.
Tipp
Wenn Sie diesen Parameter verwenden, verwenden Sie bei Bedarf die folgenden zusätzlichen Parameter:
- EnforceDefaultLabel
- AllowLabelHerabstufung
Parametereigenschaften
| Typ: | OnOffEnum |
| Standardwert: | None |
| Zulässige Werte: | On, Off |
| 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 |
-RepositoryOwner
Gibt den SAMAccountname (Domäne\Benutzer), UPN (user@domain) oder die SID einer Gruppe an, die das Repository besitzt.
Den Besitzern wird Vollzugriff auf die Datei gewährt, wenn die Berechtigungen für die Datei durch eine übereinstimmende DLP-Regel geändert werden.
Nur relevant, wenn der Parameter EnableDlp auf on festgelegt ist.
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 |
-Schedule
Legt fest, ob der Inhaltsscanauftrag nach einem bestimmten Zeitplan oder kontinuierlich ausgeführt wird.
Parametereigenschaften
| Typ: | Schedule |
| Standardwert: | None |
| Zulässige Werte: | Manual, Always |
| 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
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
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 |