Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Test-TextExtraction.md #12329

Open
wants to merge 7 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 6 additions & 4 deletions exchange/exchange-ps/exchange/Test-TextExtraction.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ ms.reviewer:
## SYNOPSIS
This cmdlet is available in on-premises Exchange and in the cloud-based service. Some parameters and settings may be exclusive to one environment or the other.

Use the Test-TextExtraction cmdlet to find the text that is extracted from a specified email message in Exchange flow.
Use the Test-TextExtraction cmdlet to return the text from unencrypted email message files.

For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

Expand All @@ -29,7 +29,9 @@ Test-TextExtraction [-FileData] <Byte[]>
```

## DESCRIPTION
This cmdlet returns the text that is found in a file in Exchange. The Microsoft classification engine uses this text to classify content and determine which sensitive information types are found in this file/message.
This cmdlet doesn't work on encrypted email message files.

The Microsoft classification engine uses the results to classify content and determine the sensitive information types in the message file.

You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://learn.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).

Expand All @@ -42,7 +44,7 @@ $content = Test-TextExtraction -FileData ([System.IO.File]::ReadAllBytes('.\fina
$content.ExtractedResults
```

This example returns the text that's extracted from the email "financial data.msg"
This example extracts the text from the email message file named "financial data.msg" that's in the same folder where you run the command, and shows the results.

### Example 2
```powershell
Expand All @@ -51,7 +53,7 @@ $content = Test-TextExtraction -FileData ([System.IO.File]::ReadAllBytes('.\fina
Test-DataClassification -TestTextExtractionResults $content.ExtractedResults
```

This example extracts the text from the email "financial data.msg" and returns the sensitive information types, their confidence, and count.
This example extracts the text from the email message file named "financial data.msg", stores the information in the variable named $content, and uses the variable with the Test-DataClassification cmdlet to return the sensitive information types, their confidence, and count.

## PARAMETERS

Expand Down