Test-CsGroupIM

Skype for Business Server 2015
 

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

Проверяет возможность двух пользователей проводить конференцию обмена мгновенными сообщениями. Test-CsGroupIM — это "искусственная транзакция", моделирование распространенных действий Skype для бизнеса Server 2015, используемых для мониторинга работоспособности и производительности. Данный командлет впервые появился в Lync Server 2010.

Test-CsGroupIM -TargetFqdn <String> [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] [-ReceiverSipAddress <String>] [-RegistrarPort <Int32>] [-SenderSipAddress <String>] <COMMON PARAMETERS>

Test-CsGroupIM -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] [-HybridOnlineUserAuthentication <LiveID | OAuth>] [-IsHybridOnlineUser <$true | $false>] [-RegistrarPort <Int32>] [-TargetFqdn <String>] <COMMON PARAMETERS>

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

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

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

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

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

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

После получения двух объектов учетных данных третья команда в примере определяет, могут ли два пользователя войти в Skype для бизнеса Server 2015 и участвовать в конференции обмена мгновенными сообщениями. Для выполнения этой задачи вызывается командлет Test-CsGroupIM со следующими параметрами: TargetFqdn (полное доменное имя пула службы Registrar); SenderSipAddress (SIP-адрес первого пользователя); SenderCredential (учетные данные первого пользователя); ReceiverSipAddress (SIP-адрес второго пользователя); ReceiverCredential (учетные данные второго пользователя).

$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"

Test-CsGroupIm -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:pilar@litwareinc.com" -SenderCredential $cred1 -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -ReceiverCredential $cred2

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

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

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

Командлет Test-CsGroupIM позволяет проверить, могут ли пользователи организации проводить конференции. Для командлета Test-CsGroupIM требуется две учетной записи пользователя для выполнения тестов. Если вы настроили тестовых пользователей для пула, в котором будет проводиться тест, вам не нужно указывать эти учетные записи. Вместо этого Test-CsGroupIM автоматически использует тестовые учетные записи, назначенные пулу. (Дополнительные сведения см. в разделе справки для командлета New-CsHealthMonitoringConfiguration.) Или же вы можете выполнить тест с использованием учетных записей, отличных от тех, которые назначены службе Registrar. Это позволяет проводить тесты, даже если вы не настроили тестовых пользователей для пула. Это также позволяет проверять возможность двух определенных пользователей проводить конференцию. Если вы выбрали этот подход, вам понадобится указать имя пользователя и пароль для обоих пользователей.

После запуска Test-CsGroupIM командлет пытается выполнить вход в Skype для бизнеса Server 2015 для обоих пользователей. При успешном входе Test-CsGroupIM создает конференцию с помощью первого тестового пользователя, а затем приглашает второго пользователя присоединиться к конференции. После обмена сообщениями оба пользователя отключаются от системы. Все эти действия осуществляются без каких-либо действий со стороны пользователя и не затрагивают никаких действительных пользователей. Например, предположим, что тестовая учетная запись sip:kenmyer@litwareinc.com соответствует реальному пользователю с существующей учетной записью Skype для бизнеса Server 2015. В этом случае тест будет проводиться без какого-либо вмешательства в работу реального пользователя Ken Myer. Например, даже если тестовая учетная запись Кена Майера выходит из системы, сам Кен Майер останется в системе. Аналогичным образом, реальный Кен Майер не получит приглашение на присоединение к конференции. Оно будет отправлено и принято тестовой учетной записью.

Добавление параметра Verbose позволяет получить подробные сведения обо всех действиях, выполненных командлетом Test-CsGroupIM для выполнения теста.

 

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

ReceiverCredential

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

System.Management.Automation.PSCredential

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

$y = Get-Credential "litwareinc\pilar"

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

Учетные данные получателя не требуются, если тест выполняется с параметрами конфигурации наблюдения за работоспособностью пула.

SenderCredential

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

System.Management.Automation.PSCredential

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

$x = Get-Credential "litwareinc\kenmyer"

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

Учетные данные отправителя не требуются, если тест выполняется с параметрами конфигурации наблюдения за работоспособностью для пула.

TargetFqdn

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

System.String

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

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

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

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

ReceiverSipAddress

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

System.String

Адрес SIP для первой из двух испытываемых учетных записей пользователей. Пример: -ReceiverSipAddress "sip:pilar@litwareinc.com". Параметр ReceiverSipAddress должен относиться к той же учетной записи пользователя, что и параметр ReceiverCredential.

Если при проведении испытания применяются параметры конфигурации наблюдения за работоспособностью для данного пула, адрес SIP не требуется.

RegistrarPort

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

System.Int32

Порт SIP, используемый службой регистратора. Этот параметр не обязателен, если регистратор использует порт по умолчанию, 5061.

SenderSipAddress

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

System.String

Адрес SIP для второй из двух испытываемых учетных записей пользователей. Пример: -SenderSipAddres "sip:kenmyer@litwareinc.com". Параметр SenderSipAddress должен относиться к той же учетной записи пользователя, что и параметр SenderCredential.

Если при проведении испытания применяются параметры конфигурации наблюдения за работоспособностью для данного пула, адрес SIP не требуется.

TestJoinLauncher

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

System.Management.Automation.SwitchParameter

Если этот параметр используется, проверяется возможность участия в аудио- или видеоконференции компонента обеспечения процесса присоединения. Компонент обеспечения процесса присоединения помогает пользователям мобильных устройств (и, соответственно, пользователям службы Mobility Service) принимать участие в конференциях.

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

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

 
Показ: