Test-CsDialInConferencing

Skype for Business Server 2015
 

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

Командлет Test-CsDialInConferencing выполняет проверку, может ли пользователь принять участие в сеансе конференц-связи с телефонным подключением. Данный командлет впервые появился в Lync Server 2010.

Test-CsDialInConferencing -TargetFqdn <String> [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] [-RegistrarPort <Int32>] [-TargetPstnPhoneNumber <String>] [-UserSipAddress <String>] [-VerifyConferenceJoin <$true | $false>] <COMMON PARAMETERS>

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

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

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

В примере 1 выполняется проверка, может ли предварительно настроенный тестовый пользователь принять участие в сеансе конференц-связи с телефонным подключением в пуле atl-cs-001.litwareinc.com. Эта команда будет работать только в том случае, если тестовые пользователи определены для пула atl-cs-001.litwareinc.com. Если это так, то команда определит, может ли первый тестовый пользователь войти в Skype для бизнеса Server 2015.

Если тестовые пользователи не определены, то команда завершится неудачно, поскольку она не будет знать, который пользователь вошел. Если тестовые пользователи для пула не определены, то необходимо включить параметр UserCredential и учетные данные пользователя, которые команда должна использовать при попытке входа.

Test-CsDialInConferencing -TargetFqdn atl-cs-001.litwareinc.com 

Команды, показанные в примере 2, проверяют, может ли конкретный пользователь (litwareinc\pilar) принять участие в конференц-связи с телефонным подключением в пуле atl-cs-001.litwareinc.com. Для этого первая команда в примере с помощью командлета Get-Credential создает объект учетных данных Windows PowerShell, содержащий имя и пароль пользователя Pilar Ackerman. (Поскольку имя для входа litwareinc\pilar включена как параметр, администратор должен только указать пароль для учетной записи Pilar Ackerman в диалоговом окне запроса учетных данных Windows PowerShell.) Затем полученный в результате объект учетных данных сохраняется в переменной с именем $cred1.

Вторая команда проверяет, может ли пользователь Pilar Ackerman войти в пул atl-cs-001.litwareinc.com и принять участие в сеансе конференц-связи с телефонным подключением. Для выполнения этой задачи вызывается командлет Test-CsDialInConferencing с тремя параметрами: TargetFqdn (полное доменное имя пула регистратора), UserCredential (объект Windows PowerShell , содержащий учетные данные пользователя Pilar Ackerman) и UserSipAddress (SIP-адрес, соответствующий указанным учетным данным пользователя).

$cred1 = Get-Credential "litwareinc\pilar"

Test-CsDialInConferencing -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress "sip:pilar@litwareinc.com" -UserCredential $cred1

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

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

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

Командлет Test-CsDialInConferencing пытается выполнить вход тестового пользователя в систему. (При наличии нескольких тестовых пользователей командлет Test-CsDialInConferencing будет использовать первую тестовую учетную запись, созданную для этого пула.) Если вход выполняется успешно, то затем командлет использует учетные данные и разрешения этого пользователя, чтобы попытаться набрать имеющиеся номера доступа к конференц-связи с телефонным подключением. Успех или неудача каждой попытки набора номера будет регистрироваться, а затем будет выполнен выход тестового пользователя из Skype для бизнеса Server 2015.

Командлет Test-CsDialInConferencing только проверяет, могут ли быть установлены соответствующие подключения. В действительности он не выполняет никаких телефонных звонков и не создает никаких конференций с телефонным подключением, к которым могли бы присоединиться другие пользователи.

 

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

TargetFqdn

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

System.String

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

UserCredential

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

System.Management.Automation.PSCredential

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

$x = Get-Credential "litwareinc\kenmyer"

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

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, используемый службой регистратора. Этот параметр не обязателен, если регистратор использует порт по умолчанию, 5061.

TargetPstnPhoneNumber

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

System.String

Номер телефона для телефона ТСОП, который будет использоваться для проверки возможности подключения к конференции пользователей ТСОП. Например:

-TargetPstnPhoneNumber "+12065551219"

Обратите внимание, что TargetPstnPhoneNumber должен быть включен только при использовании параметра VerifyConferenceJoinType.

UserSipAddress

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

System.String

SIP-адрес для тестируемой учетной записи пользователя. Например: -UserSipAddress "sip:kenmyer@litwareinc.com". Параметр UserSipAddress должен ссылаться на ту же учетную запись пользователя, что и параметр UserCredential. Этот параметр не требуется, если тестирование проводится с использованием параметров конфигурации наблюдения за работоспособностью системы.

VerifyConferenceJoin

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

System.Boolean

Если задано значение True, проверяет возможность подключения к конференции с помощью телефона ТСОП. При выполнении этой проверки также можно дополнительно включить параметр TargetPstnPhoneNumber. Если включено, для TargetPstnPhoneNumber необходимо указать телефон ТСОП, который будет использоваться для подключения. Если TargetPstnPhoneNumber не используется, то командлет Test-CsDialInConferencing будет использовать предварительно назначенные телефонные номера для соответствующего региона конференц-связи с телефонным подключением.

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

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

 
Показ: