Test-Message
Este cmdlet solo funciona en el servicio basado en la nube.
Use el cmdlet Test-Message para simular e informar sobre los efectos de las reglas de flujo de correo (reglas de transporte) y las reglas DLP unificadas en los mensajes de correo electrónico de prueba. Dado que este cmdlet introduce el correo electrónico en la canalización de evaluación DLP, pueden realizarse acciones como Bloquear, Moderar, etc. en el mensaje de prueba. Las notificaciones relacionadas también se enviarán a los destinatarios configurados.
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.
Syntax
Test-Message
-Recipients <ProxyAddressCollection>
-SendReportTo <RecipientIdParameter>
[-TransportRules]
[-Confirm]
[-Force]
[-MessageFileData <Byte[]>]
[-Sender <SmtpAddress>]
[-UnifiedDlpRules]
[-WhatIf]
[<CommonParameters>]Test-Message
-Recipients <ProxyAddressCollection>
-SendReportTo <RecipientIdParameter>
[-UnifiedDlpRules]
[-Confirm]
[-Force]
[-MessageFileData <Byte[]>]
[-Sender <SmtpAddress>]
[-WhatIf]
[<CommonParameters>]Description
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
$data = [System.IO.File]::ReadAllBytes('C:\Data\test.eml')
Test-Message -MessageFileData $data -Sender megan@contoso.com -Recipients adele@contoso.com -SendReportTo admin@contoso.com -TransportRules -UnifiedDlpRulesEn este ejemplo se usa el archivo de mensajes test.eml en C:\Data para probar las reglas de flujo de correo y las reglas DLP unificadas para el remitente megan@contoso.com al destinatario adele@contoso.com. El informe de resultados se envía a admin@contoso.com.
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, 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 demás cmdlets (por ejemplo, los cmdlets 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.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Online, Exchange Online Protection |
-Force
El modificador Force especifica si se van a suprimir los mensajes de advertencia o confirmación. Este modificador se puede usar para ejecutar tareas mediante programación en las que no es apropiado solicitar una entrada administrativa. No es necesario especificar un valor con este modificador.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-MessageFileData
El parámetro MessageFileData especifica el archivo de mensaje .eml que se va a probar.
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 del parámetro ($data).
| Type: | Byte[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Recipients
El parámetro Recipients especifica la dirección de correo electrónico del destinatario que se usará para el mensaje de prueba.
Puede especificar varias direcciones de correo electrónico separadas por comas.
| Type: | ProxyAddressCollection |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Sender
El parámetro Sender especifica la dirección de correo electrónico del remitente que se usará para el mensaje de prueba.
| Type: | SmtpAddress |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-SendReportTo
El parámetro SendReportTo especifica la dirección de correo electrónico de destino para los resultados del comando.
| Type: | RecipientIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-TransportRules
El modificador TransportRules especifica que desea probar las reglas de flujo de correo. No es necesario especificar un valor con este modificador.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Online, Exchange Online Protection |
-UnifiedDlpRules
El modificador UnifiedDlpRules especifica que desea que se unan las reglas DLP. No es necesario especificar un valor con este modificador.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-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.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Online, Exchange Online Protection |