Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-04-12

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

Синтаксис


`Test-UMConnectivity [-CertificateThumbprint <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MediaSecured <$true \| $false>] [-MonitoringContext <$true \| $false>] [-RemotePort <Int32>] [-Secured <$true \| $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]`


`Test-UMConnectivity -Phone <String> -PIN <String> -TUILogon <$true \| $false> -UMDialPlan <UMDialPlanIdParameter> [-CertificateThumbprint <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MediaSecured <$true \| $false>] [-MonitoringContext <$true \| $false>] [-RemotePort <Int32>] [-Secured <$true \| $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]`


`Test-UMConnectivity -TUILogonAll <$true \| $false> [-CertificateThumbprint <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MediaSecured <$true \| $false>] [-MonitoringContext <$true \| $false>] [-RemotePort <Int32>] [-Secured <$true \| $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]`


Test-UMConnectivity -Phone <String> -UMIPGateway <UMIPGatewayIdParameter> [-CertificateThumbprint <String>] [-Confirm [<SwitchParameter>]] [-DiagDtmfDurationInMilisecs <Int32>] [-DiagDtmfSequence <String>] [-DiagInitialSilenceInMilisecs <Int32>] [-DiagInterDtmfDiffGapInMilisecs <String>] [-DiagInterDtmfGapInMilisecs <Int32>] [-DomainController <Fqdn>] [-From <String>] [-ListenPort <Int32>] [-MediaSecured <$true \| $false>] [-MonitoringContext <$true \| $false>] [-Secured <$true \| $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]

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


`Test-UMConnectivity -ResetPIN <$true \| $false> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true \| $false>] [-WhatIf [<SwitchParameter>]]`

Параметры

Параметр	Обязательный	Тип	Описание
Phone	Обязательный	System.String	Параметр Phone указывает номер телефона или универсальный код ресурса (URI) протокола SIP, используемого для перенаправления тестового вызова. Для перенаправления вызова в сервисную группу единой системы обмена сообщениями необходимо, чтобы во внутренней АТС был настроен добавочный номер.
PIN	Обязательный	System.String	Параметр PIN указывает ПИН-код, связанный с почтовым ящиком с включенной поддержкой единой системы обмена сообщениями.
ResetPIN	Обязательный	System.Boolean	Параметр ResetPIN указывает, будет ли создаваться или восстанавливаться новый ПИН-код для всех тестовых почтовых ящиков текущего узла.
TUILogon	Обязательный	System.Boolean	Параметр TUILogon указывает, следует ли использовать командлет для входа в один или несколько почтовых ящиков с включенной поддержкой единой системы обмена сообщениями. Для почтовых ящиков должна быть включена поддержка единой системой обмена сообщениями, их также необходимо связать с абонентской группой единой системы обмена сообщениями, к которой принадлежит сервер единой системы обмена сообщениями. Значение по умолчанию — `$false`.
TUILogonAll	Обязательный	System.Boolean	Параметр TUILogonAll указывает, следует ли пытаться выполнить подключение ко всем тестовым почтовым ящикам на текущем сайте Служба каталогов Active Directory. Значение по умолчанию — `$false`. Тестируемые учетные записи должны создаваться путем вызова сценария New-TestCasConnectivityUser.ps1, а для соответствующих почтовых ящиков должна быть включена поддержка единой системы обмена сообщениями. В противном случае никакие действия не будут выполнены.
UMDialPlan	Обязательный	Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter	Параметр UMDialPlan указывает проверяемую абонентскую группу единой системы обмена сообщениями. Этот параметр необходимо использовать вместе с параметром TUILogon.
UMIPGateway	Обязательный	Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter	Параметр UMIPGateway определяет имя шлюза IP единой системы обмена сообщениями или IP-УАТС, которые необходимо использовать для исходящих тестовых вызовов.
CertificateThumbprint	Необязательный	System.String	Параметр CertificateThumbprint указывает отпечаток сертификата, используемый для режима «Защищенный SIP» и«Защищенный».
Confirm	Необязательный	System.Management.Automation.SwitchParameter	Параметр Confirm приостанавливает обработку и требует указать действие, которое будет выполнено командой перед ее возобновлением. Указывать значение параметра Confirm не обязательно.
DiagDtmfDurationInMilisecs	Необязательный	System.Int32	Параметр DiagDtmfDurationInMilisecs определяет длительность сигнала, отправляемого при наборе каждой цифры.
DiagDtmfSequence	Необязательный	System.String	Параметр DiagDtmfSequence определяет последовательность отправляемых цифр.
DiagInitialSilenceInMilisecs	Необязательный	System.Int32	Параметр DiagInitialSilenceInMilisecs определяет длительность паузы (в миллисекундах) перед отправкой последовательности цифр.
DiagInterDtmfDiffGapInMilisecs	Необязательный	System.String	Параметр DiagInterDtmfDiffGapInMilisecs указывает, настраивать ли время интервала между цифрами в диагностической последовательности. Он представляет собой список значений, разделенных запятыми, который может включать в себя пустые записи. Значений должно быть несколько.
DiagInterDtmfGapInMilisecs	Необязательный	System.Int32	ПараметрDiagInterDtmfGapInMilisecs указывает временной интервал в миллисекундах между каждой цифрой в отправляемой последовательности цифр. Он представляет собой одно значение.
DomainController	Необязательный	Microsoft.Exchange.Data.Fqdn	Параметр DomainController указывает имя FQDN контроллера домена, получающего данные из Служба каталогов Active Directory.
From	Необязательный	System.String	Параметр From указывает универсальный код ресурса (URI) или адрес SIP, от которого получен вызов. Он используется только с параметром Phone. По умолчанию используется уникальный код ресурса (URI) SIP, который указывается при использовании параметра Phone.
ListenPort	Необязательный	System.Int32	Параметр ListenPort указывает номер IP-порта для прослушивания. Если значение параметра не задано, будет использоваться IP-порт 9000.
MediaSecured	Необязательный	System.Boolean	Параметр MediaSecured определяет используемый режим: с защитой RTP или незащищенный.
MonitoringContext	Необязательный	System.Boolean	Параметр MonitoringContext указывает, запускать ли командлет в командной строке или передавать объект вывода в диспетчер Microsoft System Center Operations Manager 2007. По умолчанию командлет запускается в командной строке.
RemotePort	Необязательный	System.Int32	Параметр RemotePort указывает порт, используемый для вызова. Если параметр на задан, порт по умолчанию для протокола TCP — 5060 и 5061 — для протокола mutual TLS.
Secured	Необязательный	System.Boolean	Параметр Secured указывает, будет ли проверка запущена в безопасном режиме SIP.
Timeout	Необязательный	System.Int32	Параметр Timeout указывает время ожидания завершения проверки в секундах. Значение по умолчанию: 600 секунд. Для данного параметра нельзя устанавливать значение менее 60 секунд. Однако рекомендуется всегда устанавливать для данного параметра значение не менее 60 секунд. Максимальное значение этого параметра составляет 1800 секунд.
WhatIf	Необязательный	System.Management.Automation.SwitchParameter	Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять с объектом. С помощью параметра WhatIf можно просмотреть изменения, которые могут произойти, не применяя эти изменения. Указывать значение параметра WhatIf не обязательно.

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

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

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

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

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

Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделе Запись «Сервер единой системы обмена сообщениями» в разделе Разрешения единой системы обмена сообщениями.

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

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

Ошибки

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

Исключения

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

Примеры

ПРИМЕР 1

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

	Скопировать код
Test-UMConnectivity

ПРИМЕР 2

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

	Скопировать код
Test-UMConnectivity -UMIPGateway MyUMIPGateway -Phone 56780 -Secured $false

ПРИМЕР 3

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

	Скопировать код
Test-UMConnectivity -phone sip:sipdp.contoso.com@contoso.com -UMIPGateway MyUMIPGateway -Secured $true -from sip:user1@contoso.com -MediaSecured $true