Test-CsPstnOutboundCall

Skype for Business Server 2015
 

Дата изменения раздела:2017-03-28

Проверяет, может ли пользователь осуществлять телефонные звонки в телефонной сети общего пользования (PSTN). Данный командлет впервые появился в Lync Server 2010.

Test-CsPstnOutboundCall -TargetFqdn <String> -TargetPstnPhoneNumber <String> [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] [-RegistrarPort <Int32>] [-UserSipAddress <String>] <COMMON PARAMETERS>

Test-CsPstnOutboundCall -TargetPstnPhoneNumber <String> -UserCredential <PSCredential> -UserSipAddress <String> [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] [-HybridOnlineUserAuthentication <LiveID | OAuth>] [-HybridOnlineUserCredential <PSCredential>] [-IsHybridOnlineUser <$true | $false>] [-RegistrarPort <Int32>] [-TargetFqdn <String>] <COMMON PARAMETERS>

Test-CsPstnOutboundCall [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-Force <SwitchParameter>] [-OutLoggerVariable <String>] [-OutVerboseVariable <String>]

Пример 1 проверяет, может ли предварительно настроенный тестовый пользователь войти в пул atl-cs-001.litwareinc.com и осуществить телефонный звонок через шлюз PSTN. Эта команда будет работать, только если для пула atl-cs-001.litwareinc.com были определены тестовые пользователи. В этом случае команда определит, может ли первый тестовый пользователь войти в систему и выполнить телефонный звонок в сети общего пользования.

Если тестовые пользователи не заданы, команда завершится ошибкой, так как не сможет определить, какого пользователя использовать при проверке. Если вы не определили тестовых пользователей для пула, укажите учетную запись пользователя для выполнения проверки с помощью параметра UserSipAddress. Тогда при выполнении проверок командлет Test-CsPstnOutboundCall будет использовать указанного пользователя.

Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -TargetPstnPhoneNumber "+15551234567" 

В примере 2 показаны команды, которые проверяют возможность тестового пользователя (litwareinc\kenmyer) выполнить вход в Skype для бизнеса Server 2015 и осуществить телефонный звонок через шлюз PSTN. Для этого в первой команде используется командлет Get-Credential для создания объекта учетных данных Windows PowerShell, содержащего имя и пароль пользователя Ken Myer. (Поскольку имя входа litwareinc\kenmyer включено в качестве параметра, администратор должен ввести в диалоговом окне запроса учетных данных Windows PowerShell только пароль для учетной записи Ken Myer.) После этого результирующий объект учетных данных сохраняется в переменной $cred1.

Используя полученный объект учетных данных, вторая команда определяет, может ли тестовый пользователь войти в Skype для бизнеса Server 2015 и позвонить по заданному номеру телефона (+15551234567). Для выполнения этой задачи вызывается командлет Test-CsPstnOutboundCall со следующими параметрами: TargetFqdn (полное доменное имя пула Registrar); UserSipAddress (SIP-адрес пользователя, осуществляющего звонок); UserCredential (объект Windows PowerShell, содержащий учетные данные тестового пользователя); TargetPstnPhoneNumber (набираемый номер телефона).

$cred1 = Get-Credential "litwareinc\kenmyer"

Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -TargetPstnPhoneNumber "+15551234567" -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $cred1

Пример 3 иллюстрирует применение командлета Test-CsPstnOutboundCall в режиме серверной платформы. В этом режиме указан SIP‑адрес пользователя без учетных данных. Подлинность тестового пользователя в системе Skype для бизнеса Server 2015 проверяется по сертификатам.

Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress sip:kenmyer@litwareinc.com -TargetPstnPhoneNumber "+15551234567"

Командлет Test-CsPstnOutboundCall является примером "искусственной транзакции" Skype для бизнеса Server 2015. Искусственные транзакции используются в Skype для бизнеса Server 2015 для проверки возможности успешного выполнения пользователями таких действий, как выполнение входа, отправка мгновенных сообщений, выполнение звонков на номер стандартной телефонной сети (PSTN). Подобные тесты могут быть проведены вручную администратором или же автоматически с помощью приложения, подобного Microsoft System Center Operations Manager (ранее Microsoft Operations Manager).

Обычно искусственные транзакции выполняются двумя разными способами. Многие администраторы применяют командлеты CsHealthMonitoringConfiguration , чтобы задать тестовых пользователей для каждого из своих пулов Registrar. Тестовые пользователи представляют собой пару пользователей, предварительно настроенных для применения с искусственными транзакциями. (Обычно это тестовые учетные записи, не принадлежащие реальным пользователям.) С помощью настроенных для пула тестовых пользователей администраторы могут легко запускать искусственную транзакцию в рамках пула без необходимости указывать идентификаторы (и предоставлять учетные данные) для применяемых в тесте пользовательских учетных записей.

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

Командлет Test-CsPstnOutboundCall также можно использовать в режиме платформы сервера. В этом случае необходимо указать только SIP-адрес пользователя, а для проверки подлинности Skype для бизнеса Server 2015 будет использовать сертификаты.

Командлет Test-CsPstnOutboundCall сначала пытается выполнить вход в Skype для бизнеса Server 2015 от имени тестового пользователя. Если вход выполнен успешно, командлет пытается осуществить телефонный звонок через шлюз PSTN. Этот звонок выполняется с использованием абонентской группы, политики голосовой службы и других политик и параметров, назначенных для тестовой учетной записи. После ответа на вызов командлет отправляет по сети коды DTMF для проверки соединения.

При проведении этой проверки командлет Test-CsPstnOutboundCall осуществляет реальный телефонный звонок: для успешного выполнения проверки целевой телефон должен принять вызов и ответить на него. Администратор должен завершить этот вызов вручную.

 

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

TargetFqdn

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

System.String

Полное доменное имя (FQDN) тестируемого пула.

TargetPstnPhoneNumber

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

System.String

Номер телефона PSTN, который будет вызван при проведении проверки. Целевой номер телефона лучше всего указывать в формате E.164, т. е. в виде "+14255551298" — со знаком "плюс" (+), за которым следует код страны/региона (1), код зоны (425) и номер телефона (5551298). При указании номера телефона не используйте тире, скобки и другие символы.

Если формат E.164 не используется, к номеру будет добавлена абонентская группа тестового пользователя. Skype для бизнеса Server 2015 будет использовать абонентскую группу для нормализации номера в формат E.164. Если нормализовать номер не удастся, вызов не будет выполнен и проверка завершится ошибкой.

UserCredential

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

System.Management.Automation.PSCredential

Объект учетных данных пользователя для тестируемой учетной записи. Значение, передаваемое для UserCredential, должно быть ссылкой на объект, полученной с помощью командлета Get-Credential . Например, следующий код возвращает объект учетных данных для пользователя litwareinc\kenmyer и сохраняет его в переменной $x:

$x = Get-Credential "litwareinc\kenmyer"

При выполнении данной команды требуется указать пароль пользователя.

Этот параметр не нужен, если в команде используются тестовые пользователи, настроенные с помощью командлетов CsHealthMonitoringConfiguration. Этот параметр также не нужно указывать, если проверка проводится в режиме платформы сервера. В этом случае Skype для бизнеса Server 2015 попытается выполнить проверку подлинности пользователя с помощью сертификатов.

Authentication

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

Microsoft.Rtc.Management.SyntheticTransactions.SipSyntheticTransaction+AuthenticationMechanism

Тип проверки подлинности, используемой в тесте. Допустимые значения:

* TrustedServer

* Negotiate

* ClientCertificate

* LiveID

Force

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

System.Management.Automation.SwitchParameter

Запрещает на время выполнения команды отображение каких-либо сообщений о некритических ошибках.

HybridOnlineUserAuthentication

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

Microsoft.Rtc.Management.SyntheticTransactions.SipSyntheticTransaction+HybridOnlineAuthenticationMechanism

PARAMVALUE: LiveID | OAuth

HybridOnlineUserCredential

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

System.Management.Automation.PSCredential

PARAMVALUE: PSCredential

IsHybridOnlineUser

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

System.Boolean

PARAMVALUE: $true | $false

OutLoggerVariable

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

System.String

При указании переменной подробный отчет о выполнении командлета будет записан в эту переменную. Данная переменная содержит пару методов, ToHTML и ToXML, с помощью которых отчет может быть сохранен в HTML- или XML-файл.

Чтобы сохранить результаты в переменную средства ведения журнала с именем $TestOutput, используется следующий синтаксис:

-OutLoggerVariable TestOutput

Примечание. Не добавляйте символ $ к указываемому имени переменной. Для записи данных, хранимых в переменной средства ведения журнала, в HTML-файл используйте следующую команду:

$TestOutput.ToHTML() > C:\Logs\TestOutput.html

Чтобы записать в XML-файл данные, хранящиеся в переменной средства ведения журнала, используйте следующую команду:

$TestOutput.ToXML() > C:\Logs\TestOutput.xml

OutVerboseVariable

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

System.String

При указании переменной подробный отчет о выполнении командлета будет записан в эту переменную. Например, чтобы сохранить выходные данные в переменную под названием $TestOutput, используйте следующий синтаксис:

-OutVerboseVariable TestOutput

При указании имени переменной не добавляйте к нему символ $.

RegistrarPort

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

System.Int32

SIP-порт, используемый службой Registrar. Указание данного параметра не требуется, если служба регистратора использует стандартный порт 5061.

UserSipAddress

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

System.String

SIP‑адрес учетной записи тестируемого пользователя. Пример:

-SenderSipAddress "sip:kenmyer@litwareinc.com"

Параметр UserSipAddress должен относиться к той же учетной записи пользователя, что и UserCredential

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

Нет. Командлет Test-CsPstnOutboundCall не принимает конвейерные входные данные.

Командлет Test-CsPstnOutboundCall возвращает экземпляр объекта Microsoft.Rtc.SyntheticTransactions.TaskOutput.

 
Показ: