Test-TextExtraction

参考

模块:: ExchangePowerShell

适用于:: Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。一些参数和设置可能只适用于某个特定的环境。

使用 Test-TextExtraction cmdlet 从未加密的电子邮件文件返回文本。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

Test-TextExtraction
    [-FileData] <Byte[]>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-WhatIf]
    [<CommonParameters>]

说明

此 cmdlet 不适用于加密的电子邮件文件。

Microsoft分类引擎使用结果对内容进行分类，并确定消息文件中的敏感信息类型。

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

$content = Test-TextExtraction -FileData ([System.IO.File]::ReadAllBytes('.\financial data.msg'))

$content.ExtractedResults

本示例从运行命令的同一文件夹中名为“financial data.msg”的电子邮件文件中提取文本，并显示结果。

示例 2

$content = Test-TextExtraction -FileData ([System.IO.File]::ReadAllBytes('.\financial data.msg'))

Test-DataClassification -TestTextExtractionResults $content.ExtractedResults

此示例从名为“财务data.msg”的电子邮件文件中提取文本，将信息存储在名为 $content 的变量中，并将变量与 Test-DataClassification cmdlet 一起使用来返回敏感信息类型、其置信度和计数。

参数

-Confirm

Confirm 开关指定是否显示确认提示。此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance

-DomainController

此参数只在本地 Exchange 中可用。

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。可以使用完全限定的域名 (FQDN) 来标识域控制器。例如，dc01.contoso.com。

类型:	Fqdn
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance

-FileData

FileData 参数指定应从中提取文本的文件的名称和路径。

此参数的有效值要求使用以下语法将文件读取到字节编码对象： ([System.IO.File]::ReadAllBytes('<Path>\<FileName>'))。可以使用此命令作为参数值，也可以将输出写入变量 () $data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>') ，并将变量用作参数值 ($data) 。

类型:	Byte[]
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False
适用于:	Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance

-WhatIf

WhatIf 开关模拟命令操作。可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。不必为此开关指定值。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False
适用于:	Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance

通过