Test-UMConnectivity

Модуль:: Exchange PowerShell

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

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

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

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

Синтаксис

TuiLogonSpecific

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>]

EndToEnd

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>]

PinReset

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

TuiLogonGeneral

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

LocalLoop

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-шлюзы, УАТС и кабели. Если параметр 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 (внешний интерфейс). С этим параметром не нужно указывать значение.

Свойства параметров

Тип:	SwitchParameter
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

LocalLoop

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-CertificateThumbprint

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

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

TuiLogonSpecific

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

EndToEnd

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

TuiLogonGeneral

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

LocalLoop

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Confirm

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

Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.

Свойства параметров

Тип:	SwitchParameter
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	cf

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DiagDtmfDurationInMilisecs

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

Свойства параметров

Тип:	Int32
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

EndToEnd

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DiagDtmfSequence

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

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

EndToEnd

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DiagInitialSilenceInMilisecs

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

Свойства параметров

Тип:	Int32
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

EndToEnd

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DiagInterDtmfDiffGapInMilisecs

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

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

EndToEnd

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DiagInterDtmfGapInMilisecs

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

Свойства параметров

Тип:	Int32
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

EndToEnd

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DomainController

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Свойства параметров

Тип:	Fqdn
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-From

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

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

EndToEnd

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ListenPort

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

Свойства параметров

Тип:	Int32
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

TuiLogonSpecific

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

EndToEnd

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

TuiLogonGeneral

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

LocalLoop

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-MediaSecured

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

Свойства параметров

Тип:	Boolean
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

TuiLogonSpecific

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

EndToEnd

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

TuiLogonGeneral

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

LocalLoop

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-MonitoringContext

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

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

Свойства параметров

Тип:	Boolean
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Phone

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

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

TuiLogonSpecific

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

EndToEnd

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-PIN

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

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

TuiLogonSpecific

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-RemotePort

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

Свойства параметров

Тип:	Int32
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

TuiLogonSpecific

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

TuiLogonGeneral

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

LocalLoop

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ResetPIN

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

Свойства параметров

Тип:	Boolean
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

PinReset

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Secured

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

Свойства параметров

Тип:	Boolean
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

TuiLogonSpecific

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

EndToEnd

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

TuiLogonGeneral

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

LocalLoop

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Timeout

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

Свойства параметров

Тип:	Int32
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

TuiLogonSpecific

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

EndToEnd

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

TuiLogonGeneral

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

LocalLoop

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-TUILogon

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

Свойства параметров

Тип:	Boolean
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

TuiLogonSpecific

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-TUILogonAll

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

Свойства параметров

Тип:	Boolean
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

TuiLogonGeneral

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-UMDialPlan

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

Свойства параметров

Тип:	UMDialPlanIdParameter
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

TuiLogonSpecific

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-UMIPGateway

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

Свойства параметров

Тип:	UMIPGatewayIdParameter
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

EndToEnd

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-WhatIf

Переключатель WhatIf показывает, что команда делает без каких-либо изменений. С этим параметром не нужно указывать значение.

Свойства параметров

Тип:	SwitchParameter
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	wi

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.

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

Input types

Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.

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

Output types

Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.

Обратная связь

Были ли сведения на этой странице полезными?