New-DlpFingerprint

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Security & Compliance

このコマンドレットは、セキュリティ & コンプライアンス PowerShell でのみ使用できます。 詳細については、「 セキュリティ & コンプライアンス PowerShell」を参照してください。

New-DlpFingerprint コマンドレットを使用して、Microsoft Purview コンプライアンス ポータルのデータ損失防止 (DLP) 機密情報の種類で使用されるドキュメント フィンガープリントを作成します。 New-DlpFingerprint の結果は機密情報の種類の外に保存されていないので、New-DlpFingerprint と New-DlpSensitiveInformationType または Set-DlpSensitiveInformationType は常に同じ PowerShell セッションで実行します。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

New-DlpFingerprint
   [[-FileData] <Byte[]>]
   -Description <String>
   [-IsExact <Boolean>]
   [-Confirm]
   [-ThresholdConfig <PswsHashtable>]
   [-WhatIf]
   [<CommonParameters>]

説明

機密情報の種類のルール パッケージは、メッセージ内の機密性の高いコンテンツを検出するために、データ損失防止 (DLP) によって使用されます。

セキュリティ & コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可を割り当てる必要があります。 詳細については、「Microsoft Purview コンプライアンス センターのアクセス許可」 を参照してください。

例

例 1

$Patent_Template = [System.IO.File]::ReadAllBytes('C:\My Documents\Contoso Patent Template.docx)'

$Patent_Fingerprint = New-DlpFingerprint -FileData $Patent_Template -Description "Contoso Patent Template"

次の例では、ファイル C:\My Documents\Contoso Patent Template.docx に基づいて新しいドキュメントの指紋を作成します。 同じ PowerShell セッションで New-DlpSensitiveInformationType コマンドレットを使用して新しい指紋を使用できるように、新しい指紋を変数として保存します。

パラメーター

-Confirm

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

  • 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
  • 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Description

Description パラメーターは、ドキュメントの指紋の説明を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-FileData

FileData パラメーターは、ドキュメントの指紋として使用するファイルを指定します。

このパラメーターの有効な値を使用するには、次の構文を使用して、ファイルをバイトエンコード されたオブジェクトに読み取る必要があります。 ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')) このコマンドをパラメーター値として使用することも、変数 () に出力を書き込み、変数をパラメーター値 ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')$data) として使用することもできます。

Type:Byte[]
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-IsExact

{{ Fill IsExact Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ThresholdConfig

{{ Fill ThresholdConfig Description }}

Type:PswsHashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-WhatIf

WhatIf スイッチは、セキュリティ & コンプライアンス PowerShell では機能しません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance