Test-CsPresence

Skype for Business Server 2015
 

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

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

Test-CsPresence -TargetFqdn <String> [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] [-PublisherSipAddress <String>] [-RegistrarPort <Int32>] [-SubscriberSipAddress <String>] [-TimeoutInSeconds <UInt32>] <COMMON PARAMETERS>

Test-CsPresence -PublisherCredential <PSCredential> -PublisherSipAddress <String> -SubscriberCredential <PSCredential> -SubscriberSipAddress <String> [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] [-HybridOnlineUserAuthentication <LiveID | OAuth>] [-IsHybridOnlineUser <$true | $false>] [-RegistrarPort <Int32>] [-TargetFqdn <String>] [-TimeoutInSeconds <UInt32>] <COMMON PARAMETERS>

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

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

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

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

Test-CsPresence -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-CsPresence со следующими параметрами: TargetFqdn (полное доменное имя пула Registrar); SubscriberSipAddress (SIP-адрес первого тестового пользователя); SubscriberCredential (объект Windows PowerShell, содержащий учетные данные первого пользователя); PublisherSipAddress (SIP-адрес второго тестового пользователя); PublisherCredential (объект Windows PowerShell, содержащий учетные данные второго пользователя).

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

Test-CsPresence -TargetFqdn atl-cs-001.litwareinc.com -SubscriberSipAddress "sip:pilar@litwareinc.com" -SubscriberCredential $cred1 -PublisherSipAddress "sip:kenmyer@litwareinc.com" -PublisherCredential $cred2

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

Обычно искусственные транзакции выполняются двумя разными способами. Многие администраторы применяют командлеты CsHealthMonitoringConfiguration , чтобы настроить тестовых пользователей для каждого пула Registrar. Обычно это тестовые учетные записи, не принадлежащие реальным пользователям. С помощью настроенных для пула тестовых пользователей администраторы могут легко запускать искусственную транзакцию в рамках пула без необходимости указывать идентификаторы (и предоставлять учетные данные) для применяемых в тесте пользовательских учетных записей.

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

Командлет Test-CsPresence определяет, может ли пара тестовых пользователей войти в Skype для бизнеса Server 2015 и обменяться сведениями о присутствии. Сначала командлет выполняет вход в систему от имени этих пользователей. Если удается выполнить оба входа, первый тестовый пользователь запрашивает сведения о присутствии у второго пользователя. Второй пользователь публикует эти сведения, а командлет Test-CsPresence проверяет, что они успешно переданы первому пользователю. После обмена сведениями о присутствии тестовые пользователи выходят из Skype для бизнеса Server 2015.

 

Параметр Применение Тип Описание

PublisherCredential

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

System.Management.Automation.PSCredential

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

$x = Get-Credential "litwareinc\kenmyer"

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

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

SubscriberCredential

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

System.Management.Automation.PSCredential

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

$y = Get-Credential "litwareinc\pilar"

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

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

TargetFqdn

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

System.String

Полное доменное имя (FQDN) тестируемого пула.

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

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

PublisherSipAddress

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

System.String

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

-PublisherSipAddress "sip:kenmyer@litwareinc.com"

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

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

RegistrarPort

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

System.Int32

SIP-порт, используемый службой Registrar. Указание данного параметра не требуется, если служба регистратора использует стандартный порт 5061.

SubscriberSipAddress

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

System.String

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

-SubscriberSipAddress "sip:pilar@litwareinc.com"

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

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

TimeoutInSeconds

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

System.UInt32

PARAMVALUE: UInt32

Отсутствуют. Командлет Test-CsPresence не принимает конвейерные входные данные.

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

 
Показ: