Set-ScannerContentScan
Microsoft Purview Information Protection スキャナー コンテンツ スキャン ジョブの設定を定義します。
構文
Default (既定)
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]
説明
定義された設定に従って、定義されたリポジトリ内のコンテンツをスキャンするコンテンツ・スキャン・ジョブの構成を定義します。 コンテンツ スキャン ジョブの詳細については、 Microsoft Purview Information Protection オンプレミス スキャナーのドキュメントを参照してください。
例
例 1: デフォルトのコンテンツスキャンジョブ設定を定義する
PS C:\WINDOWS\system32> Set-ScannerContentScan -Enforce Off
この例では、デフォルト設定でコンテンツスキャンジョブを定義し、[ ポリシー適用 ] オプションを [オフ] に設定します。
例 2: 継続的に実行される基本的なコンテンツ スキャン ジョブを定義する
PS C:\WINDOWS\system32> Set-ScannerContentScan -Enforce Off -RelabelFiles On -EnforceDefaultLabel On -Schedule Always
この例では、ポリシーを適用せずにコンテンツ スキャン ジョブを定義し、既定のラベルを使用してファイルのラベル付けをやり直し、常に実行するようにスケジュールします。
例 3: 特定のラベル付け変更アクションのみを許可するコンテンツ スキャン ジョブを定義する
PS C:\WINDOWS\system32> Set-ScannerContentScan -RelabelFiles On -AllowLabelDowngrade On -EnforceDefaultLabel On
この例では、ラベルをダウングレードするか、既定のラベルを使用するためだけに、コンテンツに再ラベル付けできるコンテンツ スキャン ジョブを定義します。
例 4: .msg ファイルと .tmp ファイルを除外するコンテンツスキャンジョブを定義する
PS C:\WINDOWS\system32> Set-ScannerContentScan -IncludeFileTypes '' -ExcludeFileTypes '.msg,.tmp'
この例では、.msg ファイルと .tmp ファイルを除くすべてのファイルの種類を含むコンテンツ スキャン ジョブを定義します。
例 5: DLP が有効になっているコンテンツ スキャン ジョブと、特定のリポジトリ所有者を定義する
PS C:\WINDOWS\system32> Set-ScannerContentScan -EnableDLP On -RepositoryOwner '___domain\user'
この例では、コンテンツのスキャン時に Microsoft Purview データ損失防止 (DLP) の秘密度情報の種類を使用するようにコンテンツ スキャン ジョブを定義し、コンテンツ スキャン ジョブのリポジトリの特定の所有者も定義します。
例 6: コンテンツに自動的にラベルを付けるときに使用する既定のラベルを持つコンテンツ スキャン ジョブを定義する
PS C:\WINDOWS\system32> Set-ScannerContentScan -DefaultLabelType Custom -DefaultLabelId 'ff1f1c9d-2f92-4a18-3d84-4608b742424'
この例では、ラベル ID で指定されたデフォルト・ラベルとして使用される特定のラベルを持つコンテンツ・スキャン・ジョブを定義します。
パラメーター
-AllowLabelDowngrade
コンテンツ・スキャン・ジョブでダウングレード・アクションのラベル付けを許可するかどうかを決定します。
RelabelFiles パラメーターが on に設定されている場合にのみ関連します。
パラメーターのプロパティ
型: | OnOffEnum |
規定値: | None |
指定可能な値: | On, Off |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
型: | SwitchParameter |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | cf |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DefaultLabelId
デフォルトラベルでコンテンツに自動的にラベルを付けるときに使用するデフォルトラベルの ID を定義します。
DefaultLabelType パラメーターが custom に設定されている場合は必須です。
パラメーターのプロパティ
型: | Guid |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DefaultLabelType
デフォルトラベルでコンテンツに自動的にラベルを付けるときに使用するデフォルトラベルのタイプを決定します。
使用する場合は、 DefaultLabelId パラメーターを使用して、デフォルト ID として使用するラベル ID を定義します。
パラメーターのプロパティ
型: | DefaultLabelType |
規定値: | None |
指定可能な値: | None, PolicyDefault, Custom |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DefaultOwner
アカウントのメールアドレスを使用して、スキャンされるファイルに使用されるデフォルトの所有者値を定義します。 デフォルトでは、これはスキャナーアカウントです。
パラメーターのプロパティ
型: | String |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-DiscoverInformationTypes
コンテンツ・スキャン・ジョブ中に検出される情報タイプのタイプを決定します。
パラメーターのプロパティ
型: | DiscoverInformationTypes |
規定値: | None |
指定可能な値: | PolicyOnly, All |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-EnableDlp
コンテンツ スキャン ジョブで、コンテンツのスキャン時にデータ損失防止 (DLP) の秘密度情報の種類を使用するかどうかを決定します。
ヒント
このパラメータを設定する場合は、 RepositoryOwner パラメータを使用して特定のリポジトリ所有者を設定することもできます。
パラメーターのプロパティ
型: | OnOffEnum |
規定値: | None |
指定可能な値: | On, Off |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Enforce
コンテンツ・スキャン・ジョブがポリシーに従ってコンテンツのスキャンとラベル付けを強制するかどうかを決定します。
パラメーターのプロパティ
型: | OnOffEnum |
規定値: | None |
指定可能な値: | On, Off |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-EnforceDefaultLabel
コンテンツのラベルを変更するときに、デフォルトのラベルを常に使用するかどうかを決定します。
RelabelFiles パラメーターが on に設定されている場合にのみ関連します。
パラメーターのプロパティ
型: | OnOffEnum |
規定値: | None |
指定可能な値: | On, Off |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ExcludeFileTypes
コンテンツ・スキャン・ジョブ中に無視されるファイル・タイプを決定します。 コンマ区切りリストを使用して、複数のファイルタイプを定義します。
このパラメーターを定義する場合は、 IncludeFileTypes パラメーターを null として定義します。 たとえば、上記の 例 4 です。
Add-ScannerRepository または Set-ScannerRepository コマンドレットで OverrideContentScanJob パラメーターが on に設定されている場合にのみ関連します。
パラメーターのプロパティ
型: | String |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-IncludeFileTypes
コンテンツ・スキャン・ジョブによってスキャンされるファイル・タイプを明示的に決定します。 コンマ区切りリストを使用して、複数のファイルタイプを定義します。
このパラメーターを定義する場合は、 ExcludeFileTypes パラメーターを null として定義します。 たとえば、上記の 例 4 です。
Add-ScannerRepository または Set-ScannerRepository コマンドレットで OverrideContentScanJob パラメーターが on に設定されている場合にのみ関連します。
パラメーターのプロパティ
型: | String |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-LabelFilesByContent
「コンテンツ・コンテンツ・スキャン・ジョブ に基づいてファイルにラベルを付ける 」オプションを有効にするか無効にするかを決定します。
パラメーターのプロパティ
型: | OnOffEnum |
規定値: | None |
指定可能な値: | On, Off |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-PreserveFileDetails
更新日、最終更新日、変更者の設定など、ファイルの詳細をスキャンおよび自動ラベル付け時に保持するかどうかを決定します。
パラメーターのプロパティ
型: | OnOffEnum |
規定値: | None |
指定可能な値: | On, Off |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-RecommendedAsAutomatic
推奨ラベルを使用してコンテンツに自動的にラベルを付けるかどうかを決定します。
パラメーターのプロパティ
型: | OnOffEnum |
規定値: | None |
指定可能な値: | On, Off |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-RelabelFiles
コンテンツ・スキャン・ジョブでファイルのラベルを変更できるかどうかを決定します。
ヒント
このパラメータを使用する場合は、必要に応じて次の追加パラメータを使用します。
- EnforceDefaultLabel(デフォルトラベルを強制)
- AllowLabelダウングレード
パラメーターのプロパティ
型: | OnOffEnum |
規定値: | None |
指定可能な値: | On, Off |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-RepositoryOwner
リポジトリを所有するグループの SAMAccountname (ドメイン\ユーザー)、UPN (user@___domain)、または SID を指定します。
所有者には、一致した DLP ルールによってファイルのアクセス許可が変更された場合、ファイルに対するフル コントロールのアクセス許可が付与されます。
EnableDlp パラメーターが on に設定されている場合にのみ関連します。
パラメーターのプロパティ
型: | String |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Schedule
コンテンツ・スキャン・ジョブを特定のスケジュールに従って実行するか、または継続的に実行するかを決定します。
パラメーターのプロパティ
型: | Schedule |
規定値: | None |
指定可能な値: | Manual, Always |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
型: | SwitchParameter |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | ウィスコンシン |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |