Test-CsAddressBookWebQuery

Skype for Business Server 2015
 

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

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

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

Test-CsAddressBookWebQuery -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-CsAddressBookWebQuery -TargetUri <String> -UserSipAddress <String> [-Authentication <TrustedServer | Negotiate | ClientCertificate | LiveID | OAuth>] [-WebCredential <PSCredential>] <COMMON PARAMETERS>

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

В примере 1 проверяется служба Служба веб-запросов к адресной книге из пула atl-cs-001.litwareinc.com путем поиска контакта с SIP-адресом sip:kenmyer@litwareinc.com. Эта команда будет работать только в том случае, если для пула atl-cs-001.litwareinc.com указаны тестовые пользователи. Если они имеются, команда будет выполняться с использованием учетных данных первого тестового пользователя, указанного для пула.

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

Test-CsAddressBookWebQuery -TargetFqdn atl-cs-001.litwareinc.com  -TargetSipAddress "sip:kenmyer@litwareinc.com"

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

Во второй команде используется командлет Test-CsAddressBookWebQuery , проверяющий службу Служба веб-запросов к адресной книге пула atl-cs-001.litwareinc.com. Для выполнения этой команды с использованием учетных данных Кена Майера в нее включен параметр UserCredential со значением $cred1. Также используется параметр TargetSipAddress, который указывает, что необходимо найти контакт с SIP-адресом sip:kenmyer@litwareinc.com в адресной книге.

$cred1 = Get-Credential "litwareinc\kenmyer"

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

В примере 3 представлен способ проверки службы Служба веб-запросов к адресной книге для пула atl-cs-001.litwareinc.com. В его рамках вызывается командлет Test-CsAddressBookWebQuery с тремя параметрами: TargetUri (указывает URI службы Служба веб-запросов к адресной книге), UserSipAddress (содержит SIP-адрес Windows PowerShell учетной записи пользователя, которая будет использоваться в ходе проверки) и TargetSipAddress с SIP-адресом искомой учетной записи пользователя.

Test-CsAddressBookWebQuery -TargetUri https://atl-cs-001.litwareinc.com/groupexpansion -UserSipAddress "sip:packerman@litwareinc.com" -TargetSipAddress "sip:kenmyer@litwareinc.com"

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

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

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

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

 

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

TargetFqdn

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

System.String

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

Обратите внимание, что нельзя использовать оба параметра (TargetUri и TargetFqdn) в одной команде.

TargetUri

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

System.String

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

Обратите внимание, что нельзя использовать оба параметра (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.

SkypeSearchQuery

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

System.String

PARAMVALUE: String

TargetSipAddress

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

System.String

SIP-адрес контакта, ожидаемого от службы Служба веб-запросов к адресной книге. Например: -TargetSipAddress "sip:kenmyer@litwareinc.com".

UserSipAddress

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

System.String

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

WebCredential

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

System.Management.Automation.PSCredential

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

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

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

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

 
Показ: