Test-UMConnectivity

 

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

Последнее изменение раздела: 2008-01-30

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

Синтаксис

test-UMConnectivity [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Fax <$true | $false>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-RemotePort <Int32>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]

test-UMConnectivity -TUILogonAll <$true | $false> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-RemotePort <Int32>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]

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

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

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

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

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

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

Для выполнения командлета Test-UMConnectivity используемой учетной записи необходимо делегировать роль администратора сервера Exchange Server и членство в локальной группе администраторов целевого сервера.

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

Параметры

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

Phone

Обязательный

System.String

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

PIN

Обязательный

System.String

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

ResetPIN

Обязательный

System.Boolean

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

TUILogon

Обязательный

System.Boolean

Данный параметр указывает, следует ли использовать командлет, чтобы попытаться войти в один или несколько почтовых ящиков с включенной поддержкой единой системы обмена сообщениями. Для почтовых ящиков должна быть включена поддержка единой системой обмена сообщениями, их также необходимо связать с абонентской группой единой системы обмена сообщениями, к которой принадлежит сервер единой системы обмена сообщениями. Значение по умолчанию — «ложь» (false).

TUILogonAll

Обязательный

System.Boolean

Данный параметр указывает, следует ли проверять все почтовые ящики текущего узла Active Directory, а затем проверять подключение к каждому почтовому ящику с включенной поддержкой единой системы обмена сообщениями. Значение по умолчанию — «ложь» (false).

UMDialPlan

Обязательный

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

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

UMIPGateway

Обязательный

Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter

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

Confirm

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

System.Management.Automation.SwitchParameter

Этот параметр используется для приостановки команды и требует подтверждения ее выполнения. По умолчанию он имеет значение «$true».

DiagDtmfDurationInMilisecs

Дополнительно

System.Int32

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

DiagDtmfSequence

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

System.String

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

DiagInitialSilenceInMilisecs

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

System.Int32

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

DiagInterDtmfDiffGapInMilisecs

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

System.String

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

DiagInterDtmfGapInMilisecs

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

System.Int32

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

DomainController

Дополнительно

Microsoft.Exchange.Data.Fqdn

Этот параметр определяет полное доменное имя контроллера домена, который записывает это изменение конфигурации в службу каталогов Active Directory.

Fax

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

System.Boolean

Этот параметр указывает, что выполняется проверка факс-вызова. Значение по умолчанию — $true.

From

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

System.String

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

ListenPort

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

System.Int32

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

MediaSecured

Дополнительно

System.Boolean

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

MonitoringContext

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

System.Boolean

Этот параметр указывает, будет ли командлет запущен в командной строке или объект вывода будет передан в Microsoft Operations Manager. По умолчанию командлет запускается из командной строки.

RemotePort

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

System.Int32

Этот параметр определяет порт, который будет использоваться для вызова. Если он не указан, по умолчанию используется порт 5060 для протокола TCP и порт 5061 для протокола MTLS.

Secured

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

System.Boolean

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

Timeout

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

System.Int32

Этот параметр показывает время ожидания завершения выполнения операции (в секундах). Значение по умолчанию: 180 секунд. Для данного параметра можно установить значение менее 5 секунд. Однако рекомендуется всегда устанавливать для данного параметра значение не менее 5 секунд.

WhatIf

Дополнительно

System.Management.Automation.SwitchParameter

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

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

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

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

В четвертом примере с помощью универсального кода ресурса (URI) SIP проверяется автосекретарь. Этот пример используется в среде, в которую входит Communications Server 2007.

Test-UMConnectivity

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

Test-UMConnectivity -UMIPGateway OCSGateway1 -Phone "sip:SIPdialplan.contoso.com@contoso.com"

Test-UMConnectivity -UMIPGateway OCSGateway1 -Phone "sip:SIPAutoAttendant.SIPDialPlan.contoso.com@contoso.com"