Test-CsPersistentChatMessage

Skype for Business Server 2015
 

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

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

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

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

COMMON PARAMETERS: [-ChatRoomUri <String>] [-Force <SwitchParameter>] [-OutLoggerVariable <String>] [-OutVerboseVariable <String>] [-Setup <$true | $false>] [-TestUser1SipAddress <String>] [-TestUser2SipAddress <String>]

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

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

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

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

Командлет Test-CsPersistentChatMessage проверяет, может ли пара тестовых пользователей обмениваться сообщениями с помощью службы Persistent Chat. Для этого командлет выполняет вход этих двух пользователей на сервер Skype для бизнеса Server 2015, подключает их к комнате сохраняемого чата, выполняет обмен парой сообщений, затем покидает комнату чата и выполняет выход этих двух пользователей. Обратите внимание, что вызов данного командлета закончится неудачно, если не создана ни одна комната чата, или если учетным записям тестовых пользователей не была назначена политика сохраняемого чата, предоставляющая им доступ в службу Persistent Chat.

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

 

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

ReceiverCredential

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

System.Management.Automation.PSCredential

Объект учетных данных пользователя для первой из двух тестируемых учетных записей. Значение, передаваемое для ReceiverCredential, должно быть ссылкой на объект, полученной с помощью командлета 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

ChatRoomUri

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

System.String

Расположение комнаты чата, состоящее из полного доменного имени сервера сохраняемого чата и имени комнаты чата. Например:

-ChatRoomIdentity "atl-persistentchat-001.litwareinc.com\ITChatRoom"

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

SenderSipAddress

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

System.String

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

-SenderSipAddress "sip:kenmyer@litwareinc.com"

Параметр SenderSipAddress должен ссылаться на ту же учетную запись, что и SenderCredential.

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

Setup

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

System.Boolean

Позволяет командлету выполняться в компьютере узла-наблюдателя, которые не имеет доступа к топологии Skype для бизнеса Server 2015. Чтобы это разрешить, сначала на компьютере, имеющем доступ к топологии, выполняется командлет Test-CsPersistentChatMessage с параметром Setup. Затем можно будет выполнить данный командлет на компьютерах узла-наблюдателя.

При использовании параметра Setup необходимо также использовать параметры TestUser1SipAddress и TestUser2SipAddress.

TestUser1SipAddress

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

System.String

SIP-адрес первого тестового пользователя используется вместе с параметром Setup.

TestUser2SipAddress

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

System.String

SIP-адрес второго тестового пользователя используется вместе с параметром Setup.

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

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

 
Показ: