Применимо к: Exchange Server 2010 SP1
Последнее изменение раздела: 2011-03-19
Командлет Test-MapiConnectivity используется для проверки функциональных возможностей сервера путем подключения к указанным почтовым ящикам. Если почтовые ящики не указаны, командлет выполняет вход в почтовый ящик SystemMailbox указанной базы данных.
Синтаксис
Test-MAPIConnectivity [-ActiveDirectoryTimeout
<Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>]
[-MonitoringContext <$true | $false>] [-PerConnectionTimeout
<Int32>] [-Server <ServerIdParameter>] [-WhatIf
[<SwitchParameter>]]
|
Test-MAPIConnectivity -Database
<DatabaseIdParameter> [-ActiveDirectoryTimeout <Int32>]
[-AllConnectionsTimeout <Int32>] [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>]
[-MonitoringContext <$true | $false>] [-PerConnectionTimeout
<Int32>] [-WhatIf [<SwitchParameter>]]
|
Test-MAPIConnectivity -Identity
<MailboxIdParameter> [-ActiveDirectoryTimeout <Int32>]
[-AllConnectionsTimeout <Int32>] [-Archive
<SwitchParameter>] [-Confirm [<SwitchParameter>]]
[-DomainController <Fqdn>] [-MonitoringContext <$true |
$false>] [-PerConnectionTimeout <Int32>] [-WhatIf
[<SwitchParameter>]]
|
Параметры
Параметр | Обязательность | Тип | Описание |
---|---|---|---|
Database |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
С помощью параметра Database можно указать базу данных, в которой следует проверить подключение к системному почтовому ящику. Если не указан этот параметр или параметр Identity, команда выполнить проверку почтовых ящиков SystemMailbox каждой из баз данных на указанном сервере или на локальном сервере, если параметр Server не указан. |
Identity |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
С помощью параметра Identity можно указать проверяемый почтовый ящик. Можно использовать следующие значения:
|
ActiveDirectoryTimeout |
Необязательный |
System.Int32 |
Параметр ActiveDirectoryTimeout задает время (в секундах), в течение которого должна завершиться каждая из операций Служба каталогов Active Directory до истечения времени ожидания. Значение по умолчанию: 15 секунд. |
AllConnectionsTimeout |
Необязательный |
System.Int32 |
Параметр AllConnectionsTimeout указывает количество времени (в секундах), в течение которого должно быть выполнено каждое из подключений. В противном случае подключение будет отменено. Отсчет истечения времени ожидания не начинается до того момента, когда в Служба каталогов Active Directory будут собраны все сведения, необходимые для выполнения подключений. Значение по умолчанию составляет 90 секунд. |
Archive |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр Archive задает проверку MAPI-связи с личным архивом, связанным с почтовым ящиком. Если этот параметр не указан, используется только основной почтовый ящик. |
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
|
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
|
MonitoringContext |
Необязательный |
System.Boolean |
Параметр MonitoringContext указывает, будут ли включены в
результаты выполнения команды счетчики производительности и
наблюдение за событиями. Два возможных значения для этого
параметра: |
PerConnectionTimeout |
Необязательный |
System.Int32 |
С помощью параметра PerConnectionTimeout можно указать количество времени (в секундах), в течение которого подключение должно завершиться, прежде чем оно будет отменено. Значение по умолчанию: 10 секунд. |
Server |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
С помощью параметра Server можно указать сервер, на котором необходимо проверить подключение MAPI. Команда проверяет подключение MAPI к каждому системному почтовому ящику, размещенному в активных базах данных на указанном сервере. Если этот параметр не указан, команда проверяет почтовый ящик на локальном сервере. |
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
Подробное описание
Командлет Test-MapiConnectivity проверяет функциональные возможности сервера. Этот командлет выполняет вход в указанный почтовый ящик (или в почтовый ящик SystemMailbox, если не указан параметрIdentity) и извлекает список элементов папки «Входящие». С помощью подключения к почтовым ящикам проверяются два важнейших протокола, используемых при подключении клиента к серверу почтовых ящиков: MAPI и LDAP. Во время проверки подлинности командлет Test-MapiConnectivity косвенно проверяет работоспособность сервера MAPI, хранилища Exchange и DSAccess (Directory Service Access).
Этот командлет выполняет вход в указанный почтовый ящик с использованием учетных данных учетной записи, с которой был выполнен вход на локальный компьютер. После успешной проверки подлинности командлет Test-MapiConnectivity получает доступ к почтовому ящику, чтобы проверить работоспособность базы данных. Если подключение к почтовому ящику прошло успешно, командлет также определяет время, за которое прошло подключение.
С этой командой можно использовать три различных параметра: Database, Identity и Server.
- Параметр Database использует идентификацию базы данных и
проверяет возможность подключения к системному почтовому ящику
указанной базы данных.
- Параметр Identity использует идентификацию почтового
ящика и проверяет возможность подключения к указанному почтовому
ящику.
- Параметр Database использует идентификацию сервера и
проверяет возможность подключения к каждому системному почтовому
ящику на указанном сервере.
Запись «Подключение MAPI» в разделе Разрешения для почтового ящика.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
Исключения
Исключения | Описание |
---|---|
|
Примеры
ПРИМЕР 1
В этом примере проверяется подключение к серверу Server01.
Скопировать код | |
---|---|
Test-MapiConnectivity -Server "Server01" |
ПРИМЕР 2
В этом примере проверяется подключение к почтовому ящику, указанному с именем домена и именем пользователя.
Скопировать код | |
---|---|
Test-MapiConnectivity -Identity "midwest\john" |