Test-MAPIConnectivity

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Используйте командлет Test-MapiConnectivity для проверки функциональности сервера путем входа в указанный почтовый ящик. Если почтовый ящик не указан, командлет входит в SystemMailbox в указанной базе данных.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Test-MAPIConnectivity
    -Database <DatabaseIdParameter>
    [-ActiveDirectoryTimeout <Int32>]
    [-AllConnectionsTimeout <Int32>]
    [-Confirm]
    [-CopyOnServer <ServerIdParameter>]
    [-DomainController <Fqdn>]
    [-MonitoringContext <Boolean>]
    [-PerConnectionTimeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Test-MAPIConnectivity
    [-Identity] <MailboxIdParameter>
    [-ActiveDirectoryTimeout <Int32>]
    [-AllConnectionsTimeout <Int32>]
    [-Archive]
    [-Confirm]
    [-CopyOnServer <ServerIdParameter>]
    [-DomainController <Fqdn>]
    [-MonitoringContext <Boolean>]
    [-PerConnectionTimeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Test-MAPIConnectivity
    [-Server <ServerIdParameter>]
    [-ActiveDirectoryTimeout <Int32>]
    [-AllConnectionsTimeout <Int32>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IncludePassive]
    [-MonitoringContext <Boolean>]
    [-PerConnectionTimeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Описание

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

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

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

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

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Test-MapiConnectivity -Server "Server01"

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

Пример 2

Test-MapiConnectivity -Identity "midwest\john"

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

Параметры

-ActiveDirectoryTimeout

Этот параметр доступен только в локальной среде Exchange.

Параметр ActiveDirectoryTimeout указывает время (в секундах) для завершения каждой операции Active Directory до истечения времени ожидания операции. Значение по умолчанию — 15 секунд.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-AllConnectionsTimeout

Этот параметр доступен только в локальной среде Exchange.

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Archive

Параметр Archive указывает, следует ли проверить подключение MAPI к личному архиву, связанному с указанным почтовым ящиком. Указывать значение для этого параметра необязательно.

Если этот параметр не используется, проверяется только основной почтовый ящик.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Confirm

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

Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-CopyOnServer

Этот параметр доступен только в локальной среде Exchange.

Параметр CopyOnServer указывает сервер почтовых ящиков, на котором хранится конкретная копия базы данных для тестирования. Можно использовать любое значение, однозначно определяющее сервер. Примеры:

Имя.
полное доменное имя;
различающееся имя (DN);
Устаревшее различающееся имя Exchange

Этот параметр можно использовать только с параметром Server, а не с параметрами Identify или Database.

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Database

Этот параметр доступен только в локальной среде Exchange.

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

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

Если вы не используете этот параметр или параметр Identity, команда проверяет SystemMailbox для каждой активной базы данных на сервере Exchange (локальном сервере Exchange server или сервере, заданном с помощью параметра Server).

Нельзя использовать параметры Identity, Database или Server в одной команде.

Type:	DatabaseIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

Этот параметр доступен только в локальной среде Exchange.

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Параметр Identity указывает почтовый ящик для тестирования. Вы можете использовать любое значение, которое однозначно определяет почтовый ящик. Пример.

Имя
Псевдоним
различающееся имя (DN);
различающееся имя (DN);
Домен\Имя пользователя
Адрес электронной почты
GUID
LegacyExchangeDN
SamAccountName
Идентификатор пользователя или имя участника-пользователя

Этот командлет принимает входные данные конвейера из командлета Get-Mailbox или Get-Recipient. Если вы передаете идентификатор из Get-Mailbox или Get-Recipient командлетов, использовать этот параметр не нужно.

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

Нельзя использовать параметры Identity, Database или Server в одной команде.

Type:	MailboxIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludePassive

Этот параметр доступен только в локальной среде Exchange.

Переключатель IncludePassive проверяет подключение MAPI из всех активных и пассивных копий базы данных. Указывать значение для этого параметра необязательно.

Если этот параметр не используется, команда проверяет подключение MAPI только из активных копий базы данных.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MonitoringContext

Этот параметр доступен только в локальной среде Exchange.

Параметр MonitoringContext определяет, следует ли включать в результаты связанные события мониторинга и данные счетчиков производительности. Допустимые значения:

$true. События мониторинга и счетчики производительности включаются в результаты команды. Обычно события мониторинга и счетчики производительности включаются в результаты при передаче выходных данных в Microsoft System Center Operations Manager (SCOM).
$false. События мониторинга и счетчики производительности не включаются в результаты команды. Это значение используется по умолчанию.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-PerConnectionTimeout

Этот параметр доступен только в локальной среде Exchange.

Параметр PerConnectionTimeout указывает время в секундах, разрешенное для завершения каждого подключения до истечения времени ожидания подключения. Значение по умолчанию — 10 секунд.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

Этот параметр доступен только в локальной среде Exchange.

Параметр Server указывает сервер, на котором будет проверяться подключение MAPI. Команда проверяет подключение MAPI к каждому системным почтовым ящикам, размещенным в активных базах данных на указанном сервере. Можно использовать любое значение, однозначно определяющее сервер. Примеры:

Имя.
полное доменное имя;
различающееся имя (DN);
Устаревшее различающееся имя Exchange

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

Нельзя использовать параметры Identity, Database или Server в одной команде.

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.

Test-MAPIConnectivity

Синтаксис

Описание

Примеры

Пример 1

Пример 2

Параметры

-ActiveDirectoryTimeout

-AllConnectionsTimeout

-Archive

-Confirm

-CopyOnServer

-Database

-DomainController

-Identity

-IncludePassive

-MonitoringContext

-PerConnectionTimeout

-Server

-WhatIf

Входные данные

Выходные данные

Обратная связь

Обратная связь

Дополнительные ресурсы