Test-OutlookConnectivity

Модуль:

ExchangePowerShell

Применяется к:

Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

Используйте командлет Test-OutlookConnectivity, чтобы проверить сквозное Майкрософт подключение клиента Outlook в организации Майкрософт Exchange. Сюда входит тестирование для подключений Outlook Anywhere (RPC через HTTP) и MAPI через HTTP.

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

Синтаксис

Test-OutlookConnectivity
    [-ProbeIdentity] <String>
    [-Credential <PSCredential>]
    [-Hostname <String>]
    [-MailboxId <MailboxIdParameter>]
    [-RunFromServerId <ServerIdParameter>]
    [-TimeOutSeconds <String>]
    [<CommonParameters>]

Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -Protocol <Protocol>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]

Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -GetDefaultsFromAutodiscover <Boolean>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-RpcAuthenticationType <RpcAuthenticationType>]
    [-RpcClientAccessServer <ClientAccessServerIdParameter>]
    [-RpcProxyAuthenticationType <RPCProxyAuthenticationType>]
    [-RpcProxyServer <ServerIdParameter>]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]

Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -RpcTestType <RpcTestType>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-RpcAuthenticationType <RpcAuthenticationType>]
    [-RpcClientAccessServer <ClientAccessServerIdParameter>]
    [-RpcProxyAuthenticationType <RPCProxyAuthenticationType>]
    [-RpcProxyTestType <RpcProxyTestType>]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]

Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -WSTestType <VirtualDirectoryUriScope>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]

Описание

Выполнение командлета Test-OutlookConnectivity проверяет подключение Outlook, определенное указанными параметрами. Команда может проверить один почтовый ящик.

Командлет Test-OutlookConnectivity выполняет тот же процесс, что и пробы мониторинга. Служба диспетчера работоспособности Exchange (MSExchangeHM) Майкрософт должна быть запущена и создать пробы Outlook на компьютере, который будет тестироваться. Для запуска теста необходимо выбрать одно из удостоверений пробы Outlook. Используйте командлет Get-MonitoringItemIdentity , чтобы узнать, какие пробы активны.

В этом примере перечислены пробы, выполняемые во внутренних службах на сервере почтовых ящиков: Get-MonitoringItemIdentity -Server MailboxServer1 -Identity outlook.protocol | ?{$_.Name -like '*probe'}.

В этом примере перечислены пробы, выполняемые в службах клиентского доступа на сервере почтовых ящиков: Get-MonitoringItemIdentity -Server MailboxServer1 -Identity outlook | ?{$_.Name -like '*probe'}.

Дополнительные сведения о пробах и платформе мониторинга см. в разделах Управляемая доступность, Управляемая доступность и работоспособность сервера и Настройка управляемой доступности.

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

• MailboxId и Credential не указаны: универсальный тест подключения к тестовом почтовому ящику с использованием тестовых учетных данных системы.
• MailboxId указан, credential is not: проверка подключения к конкретному почтовому ящику с использованием тестовых учетных данных системы.
• MailboxId и Credential указаны: Вы получаете проверку подключения к конкретному почтовому ящику, а также проверку допустимости указанных учетных данных для этого почтового ящика

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

Примеры

Пример 1

Test-OutlookConnectivity -ProbeIdentity OutlookMapiHttp.Protocol\OutlookMapiHttpSelfTestProbe

В Exchange 2013 или более поздней версии этот пример запускает MAPI через HTTP OutlookRpcSelfTestProbe на сервере почтовых ящиков, к которому вы подключены.

Пример 2

Test-OutlookConnectivity "Outlook.Protocol\OutlookRpcDeepTestProbe\Mailbox Database 1234512345" -RunFromServerId PrimaryMailbox -MailboxId johnd@contoso.com

В Exchange 2013 или более поздней версии этот пример запускает OutlookRpcDeepTestProbe с сервера PrimaryMailbox для почтового ящика,johnd@contoso.com подключенного к папке "База данных почтовых ящиков 1234512345". Так как параметр Credential не указан, зонд будет использовать учетные данные проверки по умолчанию.

Пример 3

Test-OutlookConnectivity -Protocol HTTP -GetDefaultsFromAutoDiscover $true

В Exchange 2010 в этом примере проверяется наиболее распространенный сценарий сквозного подключения к Outlook для Любого Outlook. Сюда входит тестирование подключения через службу автообнаружения, создание профиля пользователя и вход в почтовый ящик пользователя. Все необходимые значения извлекаются из службы автообнаружения. Так как параметр Identity не указан, команда использует временного тестового пользователя, созданного с помощью скрипта New-TestCasConnectivityUser.ps1. Этот пример команды можно выполнить для проверки подключения TCP/IP, задав для параметра Protocol значение RPC.

Пример 4

Test-OutlookConnectivity -RpcProxyTestType:Internal -RpcTestType:Server

В Exchange 2010 в этом примере проверяется подключение к Outlook Anywhere с использованием локального сервера в качестве конечной точки RpcProxy, а также конечной точки RPC. Так как параметр Identity не указан, команда использует временного тестового пользователя, созданного с помощью скрипта New-TestCasConnectivityUser.ps1. Измените этот пример, чтобы использовать общедоступный внешний URL-адрес, задав для параметра RpcProxyTestType значение External. Кроме того, в примере команды можно использовать массив сервера клиентского доступа в качестве конечной точки RPC, задав для параметра RpcTestType значение Array. Чтобы проверить только подключение TCP/IP, опустите параметр RpcProxyTestType.

Пример 5

Test-OutlookConnectivity -RpcProxyServer RpcProxySrv01 -RpcProxyAuthenticationType Basic -RpcClientAccessServer CAS01 -RpcAuthenticationType NTLM

В Exchange 2010 в этом примере проверяется подключение Outlook через RpcProxy на одном сервере к другому серверу с ролью сервера клиентского доступа с базовым для внешнего уровня проверки подлинности и NTLM для внутреннего уровня проверки подлинности. Использование этих параметров позволит проверить большинство типов конфигураций подключения Outlook. Эту команду также можно использовать с параметром GetDefaultsFromAutoDiscover, $true если необходимо переопределить только один или два параметра. Эта следующая команда аналогична выполнению теста подключения с помощью служебной программы проверки связи RPC, но обеспечивает более надежную проверку.

Параметры

-Archive

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

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

$true. Подключитесь к локальному архиву пользователя.

$false: не подключайтесь к локальному почтовому ящику пользователя. Это значение используется по умолчанию.

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

-Confirm

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

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

• Деструктивные командлеты (например, командлеты 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

-Credential

Параметр Credential указывает учетные данные, используемые зондом. Тестовые учетные данные системы используются по умолчанию.

Для значения этого параметра требуется командлет Get-Credential. Чтобы приостановить эту команду и получить приглашение для ввода учетных данных, используйте значение (Get-Credential). Или перед выполнением этой команды сохраните учетные данные в переменной (например,$cred = Get-Credential), а затем используйте имя переменной ($cred) для этого параметра. Для получения дополнительной информации см. Get-Credential.

Type:	PSCredential
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

-GetDefaultsFromAutodiscover

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

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

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

-Hostname

ПараметрHostname указывает целевой объект конечной точки протокола для пробы. Вы можете использовать определенный сервер почтовых ящиков или маршрутизировать через сервер распределенной службы имен.

Type:	String
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

-Identity

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

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

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

Если этот параметр не используется, команда ищет тестового пользователя в Active Directory, созданного ранее с помощью скрипта New-TestCasConnectivityUser.ps1.

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

-MailboxCredential

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

Параметр MailboxCredential указывает определенные учетные данные для разрешения входа в почтовый ящик пользователя. Используйте параметр вместе с параметром Identity для доступа к почтовому ящику пользователя, если у вас нет разрешений на доступ.

Для значения этого параметра требуется командлет Get-Credential. Чтобы приостановить эту команду и получить приглашение для ввода учетных данных, используйте значение (Get-Credential). Или перед выполнением этой команды сохраните учетные данные в переменной (например,$cred = Get-Credential), а затем используйте имя переменной ($cred) для этого параметра. Для получения дополнительной информации см. Get-Credential.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MailboxId

Параметр MailboxID определяет целевой почтовый ящик.

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

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

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

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

-MonitoringContext

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

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

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

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

-ProbeIdentity

Параметр ProbeIdentity указывает зонд, который нужно использовать. Допустимые значения:

Пробы Outlook Anywhere (RPC через HTTP):

• Outlook.Protocol\OutlookRpcSelfTestProbe: проверяет, может ли конечная точка RPC/HTTP получать трафик на сервере почтовых ящиков. Он не пытается войти в почтовый ящик. Это высокий уровень проверки подключения.
• Outlook.Protocol\OutlookRpcDeepTestProbe: проверяет, работает ли конечная точка RPC/HTTP на сервере почтовых ящиков. Он попытается подключиться к почтовому ящику и войти в него. Так как база данных не указана, она попытается подключиться к первой базе данных, возвращенной командлетом Get-MailboxDatabase.
• Outlook.Protocol\OutlookRpcDeepTestProbe\<Case-sensitive Mailbox Database Name>: проверяет, работает ли конечная точка RPC/HTTP на сервере почтовых ящиков. Он попытается подключиться к почтовому ящику в указанной базе данных почтовых ящиков и войти в него. Если имя базы данных почтового ящика содержит пробелы, заключите все значение в кавычки (например, "Outlook.Protocol\OutlookRpcDeepTestProbe\Mailbox Database 0352791530").

Пробы MAPI через HTTP:

• OutlookMapiHttp.Protocol\OutlookMapiHttpSelfTestProbe: проверяет, может ли конечная точка MAPI/HTTP принимать трафик на сервере почтовых ящиков. Он не пытается войти в почтовый ящик. Это высокий уровень проверки подключения.
• OutlookMapiHttp.Protocol\OutlookMapiHttpDeepTestProbe: проверяет, работает ли конечная точка MAPI/HTTP на сервере почтовых ящиков. Он попытается подключиться к почтовому ящику и войти в него. Так как база данных не указана, она попытается подключиться к первой базе данных, возвращенной командлетом Get-MailboxDatabase.
• OutlookMapiHttp.Protocol\OutlookRpcDeepTestProbe\<Case-sensitive Mailbox Database Name>: проверяет, работает ли конечная точка MAPI/HTTP на сервере почтовых ящиков. Он попытается подключиться к почтовому ящику в указанной базе данных и войти в него. Если имя базы данных почтового ящика содержит пробелы, заключите все значение в кавычки (например, "Outlook.Protocol\OutlookRpcDeepTestProbe\Mailbox Database 0352791530").

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

-Protocol

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

Параметр Protocol указывает, следует ли тестировать подключение к Outlook Anywhere или напрямую тестировать подключение RPC или TCP/IP. Значение — HTTP или TCP.

Type:	Protocol
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RpcAuthenticationType

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

Параметр RpcAuthenticationType указывает параметр проверки подлинности для проверки уровня RPC. Использовать этот параметр полезно, если в виртуальном каталоге прокси-сервера RPC задан другой тип проверки подлинности. Можно использовать следующие значения:

• NTLM;
• Kerberos;
• Переговоры

Значение по умолчанию — Negotiate.

Type:	RpcAuthenticationType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RpcClientAccessServer

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

Параметр RpcClientAccessServer указывает целевой сервер с установленной ролью сервера клиентского доступа, которую требуется проверить. Это может быть полное доменное имя сервера (FQDN) или GUID.

Type:	ClientAccessServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RpcProxyAuthenticationType

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

Параметр RpcProxyAuthenticationType указывает параметр проверки подлинности для конечной точки прокси-сервера RPC. Значение можно указать как Basic, NTLM или Negotiate. Значение по умолчанию отсутствует, если не используется с параметром GetDefaultsFromAutodiscover.

Type:	RPCProxyAuthenticationType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RpcProxyServer

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

Параметр RpcProxyServer указывает, следует ли задать целевой сервер RpcProxy для тестирования. Этот параметр можно использовать, если сервер RpcProxy отличается от сервера клиентского доступа.

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

-RpcProxyTestType

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

Параметр RpcProxyTestType указывает, к какой конечной точке HTTP должна подключиться команда. Допустимые значения:

• Internal: ссылается на имя локального компьютера (https://<localcomputername>например, https://CAS01).
• Внешний: ссылается на общедоступное пространство имен (внешний URL-адрес HTTP в виртуальном каталоге /rpc, например ). https://mail.contoso.com

Type:	RpcProxyTestType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RpcTestType

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

Параметр RpcTestType указывает, какой тип конечной точки RPC должна тестировать команда. Допустимые значения:

• Сервер. Команда использует локальный сервер в качестве конечной точки RPC.
• Массив: команда ищет объект ClientAccessArray на локальном сайте Active Directory.

Type:	RpcTestType
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RunFromServerId

Параметр RunFromServerID указывает сервер, на котором необходимо запустить зонд.

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

-TimeOutSeconds

Параметр TimeOutSeconds указывает время ожидания в секундах, прежде чем зонд будет остановлен. Значение по умолчанию — 30 секунд. Цифры можно ввести в кавычках или без них. 10 или 10 будут работать. В случае ошибки ввода будет установлено значение по умолчанию (30 секунд).

Type:	String
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

-TotalTimeoutInMinutes

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

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

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

-TrustAnySslCert

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

Параметр TrustAnySSLCertificate дает возможность системе Exchange принимать сертификаты из недоверенных центров сертификации (ЦС). Для этого переключателя не требуется указывать значение.

Параметр TrustAnySSLCertificate указывает, следует ли игнорировать сбои проверки SSL-сертификатов. Указывать значение для этого параметра необязательно.

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

-WhatIf

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

Переключатель 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

-WSTestType

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

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

• Unknown (Это значение по умолчанию.)
• Внутренний
• Внешний

Type:	VirtualDirectoryUriScope
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

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

Input types

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

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

Output types

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