Командлет Test-ImapConnectivity используется для проверки правильности работы службы IMAP4. Командлет Test-ImapConnectivity можно использовать для проверки работоспособности IMAP4 для указанного сервера клиентского доступа для всех почтовых ящиков на серверах Exchange 2007, расположенных на одном сайте Active Directory.
Синтаксис
Test-ImapConnectivity [-ClientAccessServer <ServerIdParameter>] [-Confirm [<SwitchParameter>]] [-ConnectionType <Plaintext | Tls | Ssl>] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxCredential <PSCredential>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-PerConnectionTimeout <Int32>] [-PortClientAccessServer <Int32>] [-ResetTestAccountCredentials <SwitchParameter>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-WhatIf [<SwitchParameter>]] |
Параметры
| Параметр | Обязательность | Тип | Описание | ||
|---|---|---|---|---|---|
|
ClientAccessServer |
Дополнительно |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Этот параметр задает имя сервера клиентского доступа для проверки. Не допускается совместное использование этого параметра с параметром URL. |
||
|
Confirm |
Дополнительно |
System.Management.Automation.SwitchParameter |
Параметр Confirm используется для приостановки команды и требует подтверждения ее выполнения. Указывать значение параметра Confirm не требуется. |
||
|
ConnectionType |
Дополнительно |
Microsoft.Exchange.Monitoring.ProtocolConnectionType |
Этот параметр указывает тип подключения, используемого для подключения к серверу клиентского доступа. |
||
|
DomainController |
Дополнительно |
Microsoft.Exchange.Data.Fqdn |
Чтобы указать полное доменное имя контроллера домена, получающего данные из службы каталогов Active Directory, включите в командлет параметр DomainController. |
||
|
LightMode |
Дополнительно |
System.Management.Automation.SwitchParameter |
Этот параметр не реализован для командлета Test-ImapConnectivity. Использование этого параметра не влияет на работу командлета.
|
||
|
MailboxCredential |
Дополнительно |
System.Management.Automation.PSCredential |
Параметр задает учетные данные почтового ящика для единичной проверки URL-адреса. |
||
|
MailboxServer |
Дополнительно |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Этот параметр указывает имя проверяемого сервера почтовых ящиков. Если параметр не задан, проверяются все серверы почтовых ящиков на локальном сайте Active Directory. |
||
|
MonitoringContext |
Дополнительно |
System.Management.Automation.SwitchParameter |
При использовании этого параметра задача будет запущена по расписанию Microsoft Operations Manager (MOM). Задача, запущенная с этим параметром без MOM, завершится сбоем. При отсутствии этого параметра задача должна выполняться администратором в интерактивном режиме. |
||
|
PerConnectionTimeout |
Дополнительно |
System.Int32 |
Этот параметр указывает время ожидания завершения операции тестирования в секундах для каждого подключения. Значение параметра PerConnectionTimeout по умолчанию равно 24 секундам. Значение параметра Timeout должно быть больше 0 и меньше 120 секунд. Рекомендуется всегда устанавливать для данного параметра значение не менее 5 секунд. |
||
|
PortClientAccessServer |
Дополнительно |
System.Int32 |
Этот параметр указывает порт для подключения к серверу клиентского доступа, который будет использоваться с командлетом Test-ImapConnectivity. |
||
|
ResetTestAccountCredentials |
Дополнительно |
System.Management.Automation.SwitchParameter |
При использовании этого параметра будут сброшены учетные данные тестовой учетной записи, используемые с командлетом Test-ImapConnectivity. |
||
|
Timeout |
Дополнительно |
System.UInt32 |
Этот параметр указывает время ожидания завершения операции тестирования в секундах. Значение параметра Timeout по умолчанию равно 30 секундам. Укажите значение параметра Timeout больше 0 секунд и меньше 1 часа (3600 секунд). Рекомендуется всегда устанавливать для данного параметра значение не менее 5 секунд. |
||
|
TrustAnySSLCertificate |
Дополнительно |
System.Management.Automation.SwitchParameter |
При использовании этого параметра в отчет не включаются ошибки проверки сертификата SSL (Secure Sockets Layer). Этот параметр позволяет командлету Test-ImapConnectivity проверить службу IMAP4 без вывода сообщения об ошибке, когда сертификат не соответствует URL-адресу сервера клиентского доступа. |
||
|
WhatIf |
Дополнительно |
System.Management.Automation.SwitchParameter |
Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью параметра WhatIf можно просматривать изменения, которые могли бы произойти, без применения этих изменений. Указывать значение параметра WhatIf не требуется. |
Примечание.Подробное описание
Командлет Test-ImapConnectivity используется для проверки правильности работы службы IMAP4. Командлет Test-ImapConnectivity можно использовать для проверки работоспособности IMAP4 для указанного сервера клиентского доступа.
Для выполнения командлета Test-PopConnectivity для проверки работоспособности IMAP4 на сервере клиентского доступа используемой учетной записи необходимо делегировать роль администратора сервера Exchange и членство в локальной группе администраторов целевого сервера.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Типы входных данных
Типы возвращаемых данных
Ошибки
| Ошибка | Описание |
|---|---|
|
|
|
Пример
В первом примере кода выполняется проверка возможности подключения по протоколу IMAP4 для сервера клиентского доступа Contoso12 с использованием учетных данных пользователя contoso\kweku.
Во втором примере кода проверяется возможность подключения по протоколу IMAP4 определенного сервера клиентского доступа с именем Contoso12 для всех почтовых ящиков сервера Exchange 2007.
 Копировать код |
|
|---|---|
Test-ImapConnectivity -ClientAccessServer:Contoso12 -MailboxCredential:(get-credential contoso\kweku) Test-ImapConnectivity -ClientAccessServer:Contoso12 |
|