Test-SmtpConnectivity
Этот командлет доступен только в локальной среде Exchange.
Командлет Test-SmtpConnectivity используется для диагностики возможности успешного установления SMTP-подключения к соединителям получения на определенном сервере. Хотя этот командлет можно запустить вручную, чтобы проверить SMTP-связь на определенном сервере, в основном он используется Microsoft System Center Operations Manager 2007 для проверки возможности приема SMTP-подключений на транспортных серверах для всех привязок на всех соединителях получения этих серверов.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
Test-SmtpConnectivity
[[-Identity] <ServerIdParameter>]
[-Confirm]
[-DomainController <Fqdn>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]
Описание
При запуске командлета Test-SmtpConnectivity на сервере почтовых ящиков командлет пытается установить SMTP-подключение ко всем привязкам всех соединителей получения, размещенных на сервере. Для каждой попытки командлет возвращает следующую информацию:
- Server: Имя сервера, на котором размещен соединитель получения.
- ReceiveConnector: Имя соединителя получения, к которому осуществляется попытка SMTP-подключения.
- Binding: Привязка, настроенная для соединителя получения.
- EndPoint: Фактический IP-адрес и порт, к которому осуществляется попытка SMTP-подключения.
- StatusCode: Результат попытки подключения. Параметр может иметь одно из следующих значений: Success (успех), Unable to connect (не удалось подключиться), Transient error (временная ошибка), Permanent error (постоянная ошибка), External error (внешняя ошибка).
- Details: Фактический ответ, полученный от проверяемого сервера. Если попытка подключения не завершилась успехом, в этом поле содержится строка ошибки.
Вы можете записать результаты команды в файл, выбрав ConvertTo-Html или ConvertTo-Csv и добавив к команде > <filename>. Пример: Test-SmtpConnectivity Mailbox01 | ConvertTo-Csv > "C:\My Documents\SMTP Test.csv".
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Test-SmtpConnectivity Mailbox01
Этот пример проверяет наличие SMTP-связи для всех соединителей получения на сервере почтовых ящиков с именем Mailbox01.
Пример 2
Get-TransportService | Test-SmtpConnectivity
Этот пример проверяет наличие SMTP-связи для всех соединителей получения на всех серверах почтовых ящиков в организации.
Параметры
-Confirm
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. То, как этот переключатель влияет на командлет, зависит от того, требует ли командлет подтверждения перед продолжением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DomainController
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
Параметр DomainController не поддерживается пограничными транспортными серверами. Пограничный транспортный сервер использует локальный экземпляр службы Active Directory облегченного доступа к каталогам (AD LDS) для чтения и записи данных.
Свойства параметров
| Тип: | Fqdn |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр Identity указывает транспортный сервер, для которого командлет проверяет подключение SMTP.
Параметр Identity указывает транспортный сервер, на котором необходимо проверить подключение SMTP (протестировать все разъемы приема на указанном сервере). Можно использовать любое значение, однозначно определяющее сервер. Примеры:
- Имя.
- полное доменное имя;
- различающееся имя (DN);
- Устаревшее различающееся имя Exchange
Если этот параметр не используется, проверяются все разъемы Receive на локальном сервере.
Свойства параметров
| Тип: | ServerIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-MonitoringContext
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Параметр MonitoringContext определяет, следует ли включать в результаты связанные события мониторинга и данные счетчиков производительности. Допустимые значения:
- $true. События мониторинга и счетчики производительности включаются в результаты команды. Обычно события мониторинга и счетчики производительности включаются в результаты при передаче выходных данных в Microsoft System Center Operations Manager (SCOM).
- $false. События мониторинга и счетчики производительности не включаются в результаты команды. Это значение используется по умолчанию.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Переключатель WhatIf показывает, что команда делает без каких-либо изменений. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.
Входные данные
Input types
Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.
Выходные данные
Output types
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.