Test-CsXmppIM

Skype for Business Server 2015
 

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

Проверяет, можно ли отправить мгновенное сообщение через шлюз XMPP. Шлюзы XMPP позволяют пользователям Skype для бизнеса Server 2015 обмениваться мгновенными сообщениями и сведениями о присутствии с пользователями других служб обмена мгновенными сообщениями и сведениями о присутствии, использующих протокол XMPP. Данный командлет впервые появился в Lync Server 2013.

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

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

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

В приведенном выше примере проверяется возможность передачи мгновенных сообщений по протоколу XMPP для пула atl-cs-001.litwareinc.com. Эта команда будет работать, только если для пула atl-cs-001.litwareinc.com были определены тестовые пользователи. В этом случае команда проверит, может ли первый тестовый пользователь отправить мгновенное сообщение по протоколу XMPP пользователю с адресом SIP adelaney@contoso.com.

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

Test-CsXmppIM -TargetFqdn "atl-cs-001.litwareinc.com" -Receiver "adelany@contoso.com"

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

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

$credential = Get-Credential "litwareinc\kenmyer"

Test-CsXmppIM -TargetFqdn "atl-cs-001.litwareinc.com" -Receiver "adelany@contoso.com" -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $credential

XMPP — это стандартный протокол связи для обмена сообщениями через Интернет на основе XML. Протокол XMPP изначально назывался Jabber. Этот протокол поддерживается различными интернет-приложениями для обмена сообщениями, включая Google Talk и Facebook Chat. Командлет Test-CsXmppIM позволяет проверить, может ли пользователь обмениваться мгновенными сообщениями с другим пользователем в сети XMPP. Чтобы эта проверка завершилась успешно, вам потребуется действительный SIP-адрес пользователя XMPP, который зарегистрирован в сети, которая входит в число разрешенных партнеров XMPP.

Панель Панель управления Skype для бизнеса Server: функции, выполняемые командлетом Test-CsXmppIM , недоступны в панели Панель управления Skype для бизнеса Server.

 

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

Receiver

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

System.String

Адрес SIP пользователя, которому адресовано сообщение.

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

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

$x = Get-Credential "litwareinc\kenmyer"

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

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.

UserSipAddress

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

System.String

Адрес SIP тестируемой учетной записи пользователя, например:

-UserSipAddress "sip:kenmyer@litwareinc.com"

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

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

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

 
Показ: