Test-CsAddressBookService

Skype for Business Server 2015
 

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

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

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

Test-CsAddressBookService -UserCredential <PSCredential> -UserSipAddress <String> [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] [-External <SwitchParameter>] [-HybridOnlineUserAuthentication <LiveID | OAuth>] [-IsHybridOnlineUser <$true | $false>] [-RegistrarPort <Int32>] [-TargetFqdn <String>] <COMMON PARAMETERS>

Test-CsAddressBookService -TargetUri <String> -UserSipAddress <String> [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] [-WebCredential <PSCredential>] <COMMON PARAMETERS>

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

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

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

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

Во второй команде командлет Test-CsAddressBookService используется для тестирования веб-службы загрузки адресной книги для пула atl-cs-001.litwareinc.com. Для выполнения этой команды с использованием учетных данных пользователя Ken Myer включен параметр UserCredential со значением $cred1. Кроме того, необходимо предоставить SIP-адрес пользователя Ken с использованием параметра UserSipAddress.

$cred1 = Get-Credential "litwareinc\kenmyer"

Test-CsAddressBookService -TargetFqdn atl-cs-001.litwareinc.com -UserCredential $cred1 -UserSipAddress "sip:kenmyer@litwareinc.com"

Пример 3 иллюстрирует возможность проверки службы загрузки адресной книги для atl-cs-001.litwareinc.com. Для этого вызывается командлет Test-CsAddressBookService с двумя параметрами: TargetUri, указывающим назначенный службе загрузки адресной книги код URI, и UserSipAddress, содержащим адрес SIPWindows PowerShell для тестируемой учетной записи пользователя.




Test-CsAddressBookService -TargetUri https://atl-cs-001.litwareinc.com/abs/handler -UserSipAddress "sip:kenmyer@litwareinc.com"

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

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

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

Командлет Test-CsAddressBookService позволяет проверить, может ли пользователь подключиться к веб-службе загрузки адресной книги. При запуске командлет Test-CsAddressBookService подключается к веб-службе загрузки адресной книги в указанном пуле и запрашивает расположение файлов адресной книги. Если веб-служба загрузки адресной книги предоставляет это расположение, тест считается пройденным успешно. Если такой запрос отклоняется, то тест считается непройденным.

Можно осуществлять тестирование веб-службы загрузки адресной книги двумя разными способами: посредством тестирования самой службы или посредством тестирования сопоставленной веб-службы.

 

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

TargetFqdn

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

System.String

Полное доменное имя пула регистраторов, где будет проведено испытание службы загрузки адресной книги. Пример: -TargetFqdn "atl-cs-001.litwareinc.com".

Нельзя использовать оба параметра TargetUri и TargetFqdn в одной команде.

TargetUri

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

System.String

Универсальный код ресурса (URI), назначенный службе Служба веб-запросов к адресной книге. Пример: -TargetUri "https://atl-cs-001.litwareinc.com/abs/handler".

Нельзя использовать оба параметра TargetUri и TargetFqdn в одной команде.

UserCredential

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

System.Management.Automation.PSCredential

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

$x = Get-Credential "litwareinc\kenmyer"

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

Authentication

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

Microsoft.Rtc.Management.SyntheticTransactions.SipSyntheticTransaction+AuthenticationMechanism

Тип проверки подлинности, используемой в тесте. Разрешенные значения:

* TrustedServer

* Negotiate

* ClientCertificate

* LiveID

External

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

System.Management.Automation.SwitchParameter

Позволяет проверить, могут ли внешние пользователи использовать веб-службу загрузки адресной книги.

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

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

RegistrarPort

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

System.Int32

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

UserSipAddress

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

System.String

SIP-адрес пользователя, используемого при тестировании. Если этот параметр не задан, то Test-CsAddressBookService выполняет проверки с использованием учетной записи пользователя, выполнившего вход в систему.

WebCredential

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

System.Management.Automation.PSCredential

Объект, содержащий учетные данные пользователя для доступа к службе информирования о местонахождении. Этот объект можно извлечь, вызвав командлет Get-Credential и предоставив соответствующие учетные данные.

Этот параметр необходим, если указаны параметры TargetUri и UserSipAddress, и компьютер, на котором выполняется команда, не имеет сертификат сервера.

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

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

 
Показ: