Test-DataClassification

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance

このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。

Test-DataClassification コマンドレットを使用して、指定したテキスト文字列内にある機密情報の種類の信頼度と数を見つけます。

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

構文

Test-DataClassification
    [-ClassificationNames <String[]>]
    [-DomainController <Fqdn>]
    [-FileExtension <String>]
    [-TestTextExtractionResults <TestTextExtractionResult[]>]
    [-TextToClassify <String>]
    [<CommonParameters>]

説明

このコマンドレットを使用すると、特定のテキストでMicrosoft分類エンジンから返される分類結果を知ることができます。 分類結果には、機密性の高い型、その数、信頼度が含まれます。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

$r = Test-DataClassification -TextToClassify "Credit card information Visa: xxxx xxxx xxxx xxxx. Patient Identifier or SSN: xxx-xx-xxxx"

$r.ClassificationResults

次の使用例は、指定したテキスト文字列内のすべての機密情報の種類、その数、信頼度を一覧表示します。

パラメーター

-ClassificationNames

ClassificationNames パラメーターは、TextToClassify パラメーターで指定されたテキストで検索する機密情報の種類を指定します。 有効な値は次のとおりです。

  • 名前
  • Id (GUID 値)

複数の値をコンマで区切って指定できます。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance

-DomainController

このパラメーターは、オンプレミスの Exchange でのみ使用可能で正常に機能します。

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-FileExtension

このパラメーターは、クラウドベースのサービスでのみ使用できます。

{{ Fill FileExtension Description }}

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

-TestTextExtractionResults

TestTextExtractionResults パラメーターは、Test-TextExtraction コマンドレットから抽出されたテキストを入力テキスト ストリームとして指定します。

Type:TestTextExtractionResult[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance

-TextToClassify

TextToClassify パラメーターは、分類結果を表示する必要があるテキスト文字列を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance