Test-UMConnectivity

Модуль:

ExchangePowerShell

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

Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

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

Используйте командлет Test-UMConnectivity для проверки работы серверов единой системы обмена сообщениями (UM).

Примечание: этот командлет оптимальным образом работает с Exchange 2010. В более поздних версиях Exchange функциональность этого командлета была заменена управляемой доступностью. Для получения наилучших результатов используйте командлет Invoke-MonitoringProbe и укажите соответствующий активный зонд мониторинга вместо использования этого командлета.

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

Синтаксис

Test-UMConnectivity
    -Phone <String>
    -PIN <String>
    -TUILogon <Boolean>
    -UMDialPlan <UMDialPlanIdParameter>
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-RemotePort <Int32>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    -Phone <String>
    -UMIPGateway <UMIPGatewayIdParameter>
    [-DiagDtmfDurationInMilisecs <Int32>]
    [-DiagDtmfSequence <String>]
    [-DiagInitialSilenceInMilisecs <Int32>]
    [-DiagInterDtmfDiffGapInMilisecs <String>]
    [-DiagInterDtmfGapInMilisecs <Int32>]
    [-From <String>]
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    -ResetPIN <Boolean>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MonitoringContext <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    -TUILogonAll <Boolean>
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-RemotePort <Int32>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    [-CallRouter]
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-RemotePort <Int32>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Описание

Существует два диагностических теста, предназначенных для проверки работы программного обеспечения сервера почтовых ящиков (режим 1) и работы всей системы, содержащей подключенные компоненты телефонии (режим 2).

Командлет Test-UMConnectivity используется для проверки работы сервера почтовых ящиков и соответствующего подключенного телефонного оборудования. Если запустить этот командлет с параметром UMIPGateway, сервер почтовых ящиков выполнит сквозную проверку работы единой системы обмена сообщениями. Этот тест включает компоненты телефонии, подключенные к серверу почтовых ящиков, такие как IP-шлюзы, eXchanges Private Branch (УАТС) и кабели. Если параметр UMIPGateway не указан, сервер почтовых ящиков выполнит проверку работы только компонентов единой системы обмена сообщениями, установленных и настроенных на сервере.

При запуске командлета в локальном развертывании единой системы обмена сообщениями (UM) необходимо создать шлюз IP этой системы для компьютера или сервера, на котором тестируется данный командлет. При создании объекта шлюза IP единой системы обмена сообщениями следует настроить его с помощью полного доменного имени, причем оно должно совпадать с именем компьютера, на котором запущен этот командлет.

После выполнения этой задачи командлет проверит работу сервера почтовых ящиков и связанных компонентов телефонной системы.

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

Примеры

Пример 1

Test-UMConnectivity

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

Пример 2

Test-UMConnectivity -UMIPGateway MyUMIPGateway -Phone 56780 -Secured $false

Во этом примере проверяется возможность использования сервером почтовых ящиков незащищенного подключения протокола TCP вместо защищенного подключения Mutual TLS, чтобы передать вызов через шлюз IP единой системы обмена сообщениями MyUMIPGateway по телефонному номеру 56780.

Пример 3

Test-UMConnectivity -Phone sip:sipdp.contoso.com@contoso.com -UMIPGateway MyUMIPGateway -Secured $true -From sip:user1@contoso.com -MediaSecured $true

В этом примере тестируется абонентская группа SIP путем использования универсальных кодов ресурса (URI) протокола SIP. Этот пример можно использовать в среде, которая включает Lync Server или Skype для бизнеса Server.

Параметры

-CallRouter

Параметр CallRouter указывает, следует ли тестировать службу маршрутизатора вызовов единой системы обмена сообщениями Microsoft Exchange (интерфейс). Для этого переключателя не требуется указывать значение.

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

-CertificateThumbprint

Параметр CertificateThumbprint указывает отпечаток сертификата, используемый для режимов "Защищенный SIP" и "Защищенный".

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

-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

-DiagDtmfDurationInMilisecs

Параметр DiagDtmfDurationInMilisecs определяет длительность сигнала, отправляемого при наборе каждой цифры.

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

-DiagDtmfSequence

Параметр DiagDtmfSequence определяет последовательность отправляемых цифр.

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

-DiagInitialSilenceInMilisecs

Параметр DiagInitialSilenceInMilisecs определяет длительность паузы (в миллисекундах) перед отправкой последовательности цифр.

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

-DiagInterDtmfDiffGapInMilisecs

Параметр DiagInterDtmfDiffGapInMilisecs указывает, настраивать ли время интервала между цифрами в диагностической последовательности. Он представляет собой список значений, разделенных запятыми, который может включать в себя пустые записи. Значений должно быть несколько.

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

-DiagInterDtmfGapInMilisecs

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

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

-DomainController

Параметр 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

-From

Параметр From указывает универсальный код ресурса (URI) или адрес SIP, от которого получен вызов. Он используется только с параметром Phone. По умолчанию используется уникальный код ресурса (URI) SIP, который указывается при использовании параметра Phone.

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

-ListenPort

Параметр ListenPort указывает номер IP-порта для прослушивания. Если значение параметра не задано, будет использоваться IP-порт 9000.

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

-MediaSecured

Параметр MediaSecured определяет используемый режим: с защитой RTP или незащищенный.

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

-MonitoringContext

Параметр 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

-Phone

Параметр Phone указывает номер телефона или универсальный код ресурса (URI) протокола SIP, используемого для перенаправления тестового вызова. Для перенаправления вызова в сервисную группу единой системы обмена сообщениями необходимо, чтобы во внутренней АТС был настроен добавочный номер.

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

-PIN

Параметр PIN указывает ПИН-код, связанный с почтовым ящиком с включенной поддержкой единой системы обмена сообщениями.

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

-RemotePort

Параметр RemotePort указывает порт, используемый для вызова. Если параметр на задан, порт по умолчанию для протокола TCP — 5060 и 5061 — для протокола mutual TLS.

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

-ResetPIN

Параметр ResetPIN указывает, будет ли создаваться или восстанавливаться новый ПИН-код для всех тестовых почтовых ящиков текущего узла.

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

-Secured

Параметр Secured указывает, будет ли проверка запущена в безопасном режиме SIP.

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

-Timeout

Параметр Timeout указывает время ожидания завершения проверки в секундах. Значение по умолчанию — 600 секунд. Для данного параметра нельзя устанавливать значение менее 60 секунд. Тем не менее рекомендуется всегда устанавливать для этого параметра значение, равное 60 секундам или более. Максимальное значение этого параметра составляет 1800 секунд.

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

-TUILogon

Параметр TUILogon указывает, выполняет ли командлет попытку входа в один или несколько почтовых ящиков с включенной поддержкой единой системы обмена сообщениями. Почтовые ящики должны быть с поддержкой единой системы обмена сообщениями и связаны с абонентской группой единой системы обмена сообщениями, к которой принадлежит сервер почтовых ящиков, на котором запущена служба единой системы обмена сообщениями Microsoft Exchange. Параметр по умолчанию — $false.

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

-TUILogonAll

Параметр TUILogonAll указывает, следует ли пытаться подключиться ко всем тестируемым почтовым ящикам на текущем сайте Active Directory. Значение по умолчанию — $false. Тестируемые учетные записи должны создаваться путем вызова сценария New-TestCasConnectivityUser.ps1, а для соответствующих почтовых ящиков должна быть включена поддержка единой системы обмена сообщениями. В противном случае никакое действие не выполняется.

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

-UMDialPlan

Параметр UMDialPlan указывает проверяемую абонентскую группу единой системы обмена сообщениями. Этот параметр необходимо использовать вместе с параметром TUILogon.

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

-UMIPGateway

Параметр UMIPGateway определяет имя шлюза IP единой системы обмена сообщениями или IP-УАТС, которые необходимо использовать для исходящих тестовых вызовов.

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

-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

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

Input types

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

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

Output types

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