Применимо к: 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 можно указать проверяемый почтовый ящик. Можно использовать следующие значения:

  • идентификатор GUID

  • различающееся имя (DN)

  • домен\учетная_запись

  • Основное имя пользователя

  • различающееся имя в прежнем формате Exchange

  • SMTP-адрес

  • псевдоним

  • Этот параметр принимает возвращаемые данные командлетов Get-Mailbox или Get-Recipient. Если объект передается из командлетов Get-Mailbox или Get-Recipient, этот параметр не требуется.

  • Если этот параметр не указан, командлет выполнит проверку почтового ящика SystemMailbox указанной базы данных.

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 указывает, будут ли включены в результаты выполнения команды счетчики производительности и наблюдение за событиями. Два возможных значения для этого параметра: $true или $false. Если указано значение $true, то в результаты будут включены счетчики производительности и наблюдение за событиями, а также сведения о транзакциях MAPI.

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"