Test-Message

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Server 2013, Exchange Online, Exchange Online Protection

Этот командлет работает только в облачной службе.

Используйте командлет Test-Message для имитации и создания отчетов о влиянии правил потока обработки почты (правил транспорта) и унифицированных правил защиты от потери данных на тестовые сообщения электронной почты. Так как этот командлет вводит электронную почту в конвейер оценки защиты от потери данных, в тестовом сообщении могут выполняться такие действия, как Block, Moderate и т. д. Связанные уведомления также будут отправляться всем настроенным получателям.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

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>]

Описание

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 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 -UnifiedDlpRules

В этом примере используется файл сообщения test.eml в C:\Data для проверки правил потока обработки почты и унифицированных правил защиты от потери данных для отправителя megan@contoso.com получателю adele@contoso.com. Отчет о результатах отправляется в admin@contoso.com.

Параметры

-Confirm

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.

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

Переключатель Force указывает, следует ли блокировать предупреждающие сообщения или подтверждения. Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора. Указывать значение для этого параметра не обязательно.

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

Параметр MessageFileData указывает EML-файл сообщения для тестирования.

Допустимое значение для этого параметра требует считывания файла в байтовый объект с использованием следующего синтаксиса: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Эту команду можно использовать в качестве значения параметра или записать выходные данные в переменную ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) и использовать переменную в качестве значения параметра ($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

Параметр Recipients указывает адрес электронной почты получателя, который будет использоваться для тестового сообщения.

Можно указать несколько адресов электронной почты, разделив их запятыми.

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

Параметр Sender указывает адрес электронной почты отправителя, который будет использоваться для тестового сообщения.

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

Параметр SendReportTo указывает целевой адрес электронной почты для результатов команды.

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

Параметр TransportRules указывает, что вы хотите протестировать правила потока обработки почты. Указывать значение для этого параметра необязательно.

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

Параметр UnifiedDlpRules указывает, что требуется унифицировать правила защиты от потери данных. Указывать значение для этого параметра необязательно.

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

Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.

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