Test-TextExtraction

Referencia

Módulo:: ExchangePowerShell

Se aplica a:: Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.

Use el cmdlet Test-TextExtraction para devolver el texto de los archivos de mensaje de correo electrónico sin cifrar.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Sintaxis

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

Description

Este cmdlet no funciona en archivos de mensajes de correo electrónico cifrados.

El motor de clasificación de Microsoft usa los resultados para clasificar el contenido y determinar los tipos de información confidencial en el archivo de mensajes.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

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

$content.ExtractedResults

En este ejemplo se extrae el texto del archivo de mensaje de correo electrónico denominado "financial data.msg" que se encuentra en la misma carpeta donde se ejecuta el comando y se muestran los resultados.

Ejemplo 2

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

Test-DataClassification -TestTextExtractionResults $content.ExtractedResults

En este ejemplo se extrae el texto del archivo de mensaje de correo electrónico denominado "data.msg financiero", se almacena la información en la variable denominada $content y se usa la variable con el cmdlet Test-DataClassification para devolver los tipos de información confidencial, su confianza y el recuento.

Parámetros

-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance

-DomainController

Este parámetro solo está disponible en Exchange local.

El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.

Tipo:	Fqdn
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance

-FileData

El parámetro FileData especifica el nombre y la ruta de acceso del archivo del que se debe extraer texto.

Un valor válido para este parámetro requiere que lea el archivo en un objeto codificado en bytes mediante la sintaxis siguiente: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Puede usar este comando como valor de parámetro o puede escribir la salida en una variable ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) y usar la variable como valor de parámetro ($data).

Tipo:	Byte[]
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance

-WhatIf

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False
Se aplica a:	Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance

Compartir a través de