Test-CsIM

Skype for Business Server 2015
 

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

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

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

Test-CsIM -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-CsIM [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-EmailHost <String>] [-Force <SwitchParameter>] [-IsSsl <$true | $false>] [-OutLoggerVariable <String>] [-OutVerboseVariable <String>] [-Password <String>] [-Port <UInt16>] [-TestLegalIntercept <SwitchParameter>] [-Username <String>] [-WaitSeconds <Int16>]

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

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

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

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

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

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

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

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

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

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

Сначала командлет Test-CsIM пытается выполнить вход на Skype для бизнеса Server 2015 для пары тестовых пользователей. Предполагая, что два входа выполнены успешно, командлет инициирует сеанс обмена мгновенными сообщениями между двумя тестовыми пользователями. (Пользователь 1 приглашает пользователя 2 в сеанс обмена мгновенными сообщениями, а пользователь 2 принимает приглашение.) После проверки Test-CsIM завершает сеанс обмена мгновенными сообщениями и выполняет выход из системы для обоих пользователей.

 

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

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

EmailHost

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

System.String

Узел электронной почты пользователя, участвующего в тесте Legal Intercept (Легальный перехват). Например:

-EmailHost "litwareinc.com"

Force

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

System.Management.Automation.SwitchParameter

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

HybridOnlineUserAuthentication

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

Microsoft.Rtc.Management.SyntheticTransactions.SipSyntheticTransaction+HybridOnlineAuthenticationMechanism

PARAMVALUE: LiveID | OAuth

IsHybridOnlineUser

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

System.Boolean

PARAMVALUE: $true | $false

IsSsl

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

System.Boolean

Если параметр имеет значение True, тест выполняется с помощью протокола SSL.

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

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

Password

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

System.String

Пароль пользователя, участвующего в тесте Legal Intercept (Легальный перехват).

Port

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

System.UInt16

Порт, используемый для службы Legal Intercept (Легальный перехват).

ReceiverSipAddress

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

System.String

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

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

RegistrarPort

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

System.Int32

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

SenderSipAddress

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

System.String

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

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

TestLegalIntercept

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

System.Management.Automation.SwitchParameter

Если этот параметр задан, то он указывает командлету Test-CsIM, что необходимо протестировать службу Legal Intercept (Легальный перехват) для указанного пользователя.

Username

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

System.String

Имя пользователя, участвующего в тесте Legal Intercept (Легальный перехват).

WaitSeconds

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

System.Int16

Указывает период времени (в секундах), в течение которого система должна ожидать ответа службы Legal Intercept (Легальный перехват).

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

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

 
Показ: