Test-ImapConnectivity
Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Последнее изменение раздела: 2010-08-18
Командлет 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>]]
Подробное описание
Командлет Test-ImapConnectivity используется для проверки правильности работы службы IMAP4. Командлет Test-ImapConnectivity можно использовать для проверки работоспособности IMAP4 для указанного сервера клиентского доступа.
Для выполнения командлета Test-PopConnectivity для проверки работоспособности IMAP4 на сервере клиентского доступа используемой учетной записи необходимо делегировать роль администратора сервера Exchange и членство в локальной группе администраторов целевого сервера.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Параметры
| Параметр | Обязательность | Тип | Описание | ||
|---|---|---|---|---|---|
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 |
Параметр ResetTestAccountCredentials сбрасывает пароль для тестовой учетной записи, используемой для выполнения этой команды. Пароль для тестовой учетной записи обычно сбрасывается каждые семь дней, если для управления средой Exchange используется средство Microsoft System Center Operations Manager. Установка этого флажка приводит к принудительному сбросу пароля в любой момент, когда это потребуется по причинам, связанным с безопасностью. |
||
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 не требуется. |
.gif "note")
Примечание.Типы входных данных
Типы возвращаемых данных
Ошибки
| Ошибка | Описание |
|---|---|
|
|
Пример
В первом примере кода выполняется проверка возможности подключения по протоколу IMAP4 для сервера клиентского доступа Contoso12 с использованием учетных данных пользователя contoso\kweku.
Во втором примере кода проверяется возможность подключения по протоколу IMAP4 определенного сервера клиентского доступа с именем Contoso12 для всех почтовых ящиков сервера Exchange 2007.
Test-ImapConnectivity -ClientAccessServer:Contoso12 -MailboxCredential:(get-credential contoso\kweku)
Test-ImapConnectivity -ClientAccessServer:Contoso12