Test-ImapConnectivity

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Этот командлет доступен только в локальной среде Exchange.

Используйте командлет Test-ImapConnectivity, чтобы убедиться, что подключение к службе Microsoft Exchange IMAP4 работает должным образом.

Примечание: этот командлет оптимальным образом работает с Exchange 2010. В более поздних версиях Exchange функциональность этого командлета была заменена управляемой доступностью. Для получения наилучших результатов используйте командлет Invoke-MonitoringProbe и укажите соответствующий активный зонд мониторинга вместо использования этого командлета.

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

Синтаксис

Test-ImapConnectivity
    [[-ClientAccessServer] <ServerIdParameter>]
    [-Confirm]
    [-ConnectionType <ProtocolConnectionType>]
    [-DomainController <Fqdn>]
    [-LightMode]
    [-MailboxCredential <PSCredential>]
    [-MailboxServer <ServerIdParameter>]
    [-MonitoringContext]
    [-PerConnectionTimeout <Int32>]
    [-PortClientAccessServer <Int32>]
    [-ResetTestAccountCredentials]
    [-Timeout <UInt32>]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]

Описание

Командлет Test-ImapConnectivity проверяет подключение IMAP4, подключаясь к указанному почтовому ящику, указанному серверу Exchange server или всем серверам Exchange, доступным на локальном сайте Active Directory.

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

& $env:ExchangeInstallPath\Scripts\New-TestCasConnectivityUser.ps1

Результаты проверки отображаются на экране. Командлет вернет следующую информацию:

CasServer — сервер Exchange, к которому подключен клиент.
LocalSite — имя локального сайта Active Directory.
Scenario — проверяемые действия. Проверка подключения IMAP4 подключается к серверу по протоколу IMAP4, выполняет поиск тестового сообщения и удаляет его вместе с любыми сообщениями старше 24 часов.
Result — возвращаемые результаты. Обычно это Success (Успешно), Skipped (Пропущено) или Failure (Сбой).
Latency(MS) — время, необходимое для выполнения проверки (в миллисекундах).
Error — любые появившиеся сообщения об ошибках.

Результаты можно записать в файл, перенаписав выходные данные в ConvertTo-Html и Set-Content. Пример: Test-IMAPConnectivity -ClientAccessServer MBX01 | ConvertTo-Html | Set-Content -Path "C:\My Documents\IMAP Test.html".

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

Важно! В Exchange 2013 или более поздней версии при выполнении этой команды для тестирования одного почтового ящика на сервере Exchange Server, на котором не размещена активная копия базы данных почтового ящика для почтового ящика, может появиться следующее сообщение об ошибке:

Unable to create MailboxSession object to access the mailbox [user@contoso.com]. Detailed error information: [Microsoft.Exchange.Data.Storage.WrongServerException]: The user and the mailbox are in different Active Directory sites. Inner error [Microsoft.Mapi.MapiExceptionMailboxInTransit]: MapiExceptionMailboxInTransit: Detected site violation (hr=0x0, ec=1292)

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

Примеры

Пример 1

Test-ImapConnectivity -ClientAccessServer Contoso12 -MailboxCredential (Get-Credential contoso\kweku)

В этом примере выполняется проверка возможности подключения по протоколу IMAP4 для сервера Contoso12 с помощью учетных данных пользователя contoso\kweku.

Пример 2

Test-ImapConnectivity -ClientAccessServer Contoso12

В этом примере проверяется подключение клиента IMAP4 к серверу Contoso12 и проверяются все почтовые ящики Exchange.

Параметры

-ClientAccessServer

Параметр ClientAccessServer указывает сервер Exchange для проверки. Этот сервер имеет установленную роль сервера клиентского доступа и отвечает за прием клиентских подключений.

Можно использовать любое значение, однозначно определяющее сервер. Примеры:

имя;
различающееся имя (DN);
ExchangeLegacyDN
GUID

Type:	ServerIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ConnectionType

Параметр ConnectionType определяет тип подключения к службе IMAP4. Допустимые значения:

Plaintext
Ssl
Tls

Type:	ProtocolConnectionType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LightMode

Параметр LightMode указывает, что при выполнении команды необходимо выполнять только проверочный вход на сервер по протоколу IMAP4. Для этого переключателя не требуется указывать значение.

Если этот параметр не используется, также проверяется отправка и получение сообщения по протоколу IMAP4.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MailboxCredential

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

Для значения этого параметра требуется командлет Get-Credential. Чтобы приостановить эту команду и получить приглашение для ввода учетных данных, используйте значение (Get-Credential). Или перед выполнением этой команды сохраните учетные данные в переменной (например,$cred = Get-Credential), а затем используйте имя переменной ($cred) для этого параметра. Для получения дополнительной информации см. Get-Credential.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MailboxServer

Параметр MailboxServer указывает сервер почтовых ящиков Exchange, который требуется протестировать. Этот параметр определяет внутренний сервер, принимающий прокси-подключения от интерфейсного сервера, к которому подключаются клиенты.

Параметр MailboxServer указывает сервер почтовых ящиков exExchange2k16 или exExchange2k13, который необходимо протестировать. Примеры:

имя;
различающееся имя (DN);
ExchangeLegacyDN
GUID

Если вы не используете этот параметр, то проверяются подключения ко всем серверам почтовых ящиков на локальном сайте Active Directory.

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MonitoringContext

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

Обычно события мониторинга и счетчики производительности включаются в результаты при передаче выходных данных в Microsoft System Center Operations Manager (SCOM).

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-PerConnectionTimeout

Параметр PerConnectionTimeout указывает время ожидания завершения проверки подключения в секундах. Допустимые значения: от 0 до 120 секунд. Значение по умолчанию: 120 секунд.

Для этого параметра рекомендуется устанавливать значение не менее 5 секунд.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-PortClientAccessServer

Параметр PortClientAccessServer указывает порт, который необходимо использовать для подключения к серверу клиентского доступа. Порт по умолчанию для IMAP4 — 143. Допустимый диапазон значений: от 0 до 65 535.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ResetTestAccountCredentials

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Timeout

Параметр Timeout указывает время ожидания завершения проверки в секундах. Допустимые значения: от 0 до 3600 секунд (1 час). Значение по умолчанию равно 180 секундам (3 минутам).

Для этого параметра рекомендуется устанавливать значение не менее 5 секунд.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-TrustAnySSLCertificate

Параметр TrustAnySSLCertificate дает возможность системе Exchange принимать сертификаты из недоверенных центров сертификации (ЦС). Для этого переключателя не требуется указывать значение.

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.

Поделиться через