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 |
Этот параметр указывает, что выполняется проверка факс-вызова. Значение по умолчанию — |
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"