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

Test-MapiConnectivity

  • Статья

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2007-07-05

Командлет 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>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-WhatIf [<SwitchParameter>]]

Подробное описание

Для выполнения командлета Test-MapiConnectivity используемой учетной записи необходимо делегировать:

  • роль администратора сервера Exchange и членство в локальной группе администраторов на целевом сервере.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Командлет Test-MapiConnectivity можно использовать для проверки функциональных возможностей сервера. Этот командлет выполнит вход в указанный почтовый ящик или в почтовый ящик SystemMailbox, если не указан параметрIdentity, и извлечет список элементов папки «Входящие». С помощью подключения к почтовым ящикам проверяются два важнейших протокола, используемых при подключении клиента к серверу почтовых ящиков: MAPI и LDAP. Во время проверки подлинности командлет Test-MapiConnectivity косвенно проверяет работоспособность сервера MAPI, хранилища Exchange и  DSAccess (Directory Service Access).

Этот командлет выполнит вход в указанный почтовый ящик с использованием учетных данных учетной записи, с которой был выполнен вход на локальный компьютер. После успешной проверки подлинности командлет Test-MapiConnectivity получает доступ к почтовому ящику, чтобы проверить работоспособность базы данных. Если подключение к почтовому ящику прошло успешно, командлет также определяет время, за которое прошло подключение.

С этой командой можно использовать три различных параметра: Database, Identity и Server.

  • Параметр Database использует идентификацию базы данных и проверяет возможность подключения к системному почтовому ящику указанной базы данных.

  • Параметр Identity использует идентификацию почтового ящика и проверяет возможность подключения к указанному почтовому ящику.

  • Параметр Database использует идентификацию сервера и проверяет возможность подключения к каждому системному почтовому ящику на указанном сервере.

Параметры

Параметр Обязательный Тип Описание

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

Параметр AllConnectionTimeout указывает количество времени (в секундах), в течение которого должно быть выполнено каждое из подключений. В обратном случае подключение будет отменено. Отсчет истечения времени ожидания не начинается до того момента, когда в Active Directory будут собраны все сведения, необходимые для выполнения подключений. Значение по умолчанию составляет 90 секунд.

Confirm

Необязательный

System.Management.Automation.SwitchParameter

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

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

С помощью параметра DomainController можно указать контроллер домена, который будет использоваться для получения доступа к службе каталогов Active Directory. Используется полное доменное имя (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

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

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

 

Исключения

Исключения Описание

 

Пример

В первом примере проверяется подключение к серверу Server01.

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

Test-MapiConnectivity -Server "Server01"
Test-MapiConnectivity -Identity "midwest\john"