Test-TextExtraction

Riferimento

Modulo:: ExchangePowerShell

Si applica a:: Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

Usare il cmdlet Test-TextExtraction per restituire il testo dai file dei messaggi di posta elettronica non crittografati.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

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

Descrizione

Questo cmdlet non funziona sui file di messaggi di posta elettronica crittografati.

Il motore di classificazione Microsoft usa i risultati per classificare il contenuto e determinare i tipi di informazioni sensibili nel file di messaggio.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

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

$content.ExtractedResults

Questo esempio estrae il testo dal file del messaggio di posta elettronica denominato "financial data.msg" nella stessa cartella in cui si esegue il comando e mostra i risultati.

Esempio 2

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

Test-DataClassification -TestTextExtractionResults $content.ExtractedResults

Questo esempio estrae il testo dal file del messaggio di posta elettronica denominato "financial data.msg", archivia le informazioni nella variabile denominata $content e usa la variabile con il cmdlet Test-DataClassification per restituire i tipi di informazioni riservate, la relativa attendibilità e conteggio.

Parametri

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non dispone di una pausa incorporata. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False
Si applica a:	Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance

-DomainController

Questo parametro è disponibile solo in Exchange locale.

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.

Tipo:	Fqdn
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False
Si applica a:	Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance

-FileData

Il parametro FileData consente di specificare il nome e il percorso del file da cui estrarre il testo.

Per un valore valido per questo parametro è necessario leggere il file in un oggetto con codifica byte usando la sintassi seguente: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). È possibile usare questo comando come valore del parametro oppure scrivere l'output in una variabile ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) e usare la variabile come valore del parametro ($data).

Tipo:	Byte[]
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False
Si applica a:	Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

Tipo:	SwitchParameter
Alias:	wi
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False
Si applica a:	Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance

Condividi tramite