Test-CsLisConfiguration

Skype for Business Server 2015
 

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

Тестирование конфигурации Location Information Server (LIS). Данный командлет впервые появился в Lync Server 2010.

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

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

COMMON PARAMETERS: [-BssId <String>] [-ChassisId <String>] [-Force <SwitchParameter>] [-Mac <String>] [-OutLoggerVariable <String>] [-OutVerboseVariable <String>] [-PortId <String>] [-PortIdSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-Subnet <String>]

В этом примере тестируется конфигурация LIS в полном доменном имени (FQDN) atl-cs-001.litwareinc.com. Тестирование считается успешным, если возможно подключение к веб-службе LIS в этом полном доменном имени с использованием текущих учетных данных пользователя. При обнаружении расположения, сопоставляемого с IP-адресом подсети 192.168.0.0, возвращается адрес этого расположения.

Для успешного выполнения этой команды требуется наличие конфигурации мониторинга работоспособности, содержащей пользователей искусственных транзакций. Для проверки наличия такой конфигурации выполните командлет Get-CsHealthMonitoringConfiguration . Для создания новой конфигурации мониторинга работоспособности выполните командлет New-CsHealthMonitoringConfiguration .

Test-CsLisConfiguration -TargetFqdn atl-cs-001.litwareinc.com -Subnet 192.168.0.0

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

Test-CsLisConfiguration -TargetFqdn atl-cs-001.litwareinc.com -Subnet 192.168.0.0 -UserSipAddress sip:kmyer@litwareinc.com

Первая строка данного примера демонстрирует вызов командлета Windows PowerShell Get-Credential , который запрашивает идентификатор пользователя и пароль. Эта информация хранится в зашифрованном виде в переменной $cred/

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

$cred = Get-Credential
Test-CsLisConfiguration -TargetFqdn atl-cs-001.litwareinc.com -Subnet 192.168.0.0 -UserSipAddress sip:kmyer@litwareinc.com -UserCredential $cred

Первая строка данного примера демонстрирует вызов командлета nm-winshell-2nd Get-Credential , который запрашивает идентификатор пользователя и пароль. Эта информация хранится в зашифрованном виде в переменной $cred/

Строка два проверяет конфигурацию LIS путем вызова URI веб-службы (https://atl-cs-001.litwareinc.com/locationinformation/lisservice.svc), используя SIP-адрес удаленного пользователя (sip:kmyer@litwareinc.com) и учетные данные, полученные в строке 1, посредством передачи их в параметр WebCredential. Тест считается успешным, если возможно подключение к веб-службе LIS с таким URI с использованием указанных учетных данных пользователя. При обнаружении расположения, сопоставляемого с IP-адресом подсети 192.168.0.0, MAC-адресом 0A-23-00-00-00-AA или идентификатором порта 4500 и ChassisId 0A-23-00-00-00-AA, будет возвращаться адрес такого расположения.

Эту команду рекомендуется использовать в тех случаях, когда компьютер, на котором выполняется эта команда, не содержит сертификата сервера.

$cred = Get-Credential
Test-CsLisConfiguration -TargetUri https://atl-cs-001.litwareinc.com/locationinformation/lisservice.svc -UserSipAddress sip:kmyer@litwareinc.com -WebCredential $cred -Subnet 192.168.0.0 -Mac 0A-23-00-00-00-AA -PortId 4500 -ChassisId 0A-23-00-00-00-AA

Этот пример идентичен примеру 4 за исключением того, что команда не использует параметр WebCredential (и следовательно, не выполняет вызов Get-Credential ). Эту команду рекомендуется использовать в тех случаях, когда компьютер, на котором выполняется эта команда, не содержит сертификата сервера.

Test-CsLisConfiguration -TargetUri https://atl-cs-001.litwareinc.com/locationinformation/lisservice.svc -UserSipAddress sip:kmyer@litwareinc.com -Subnet 192.168.0.0 -Mac 0A-23-00-00-00-AA -PortId 4500 -ChassisId 0A-23-00-00-00-AA

Этот командлет определяет возможность обращения к веб-службе Location Information Server (LIS), используя информацию в предоставленных параметрах. Если обращение к веб-службе возможно, и обнаружено расположение, соответствующее любому из предоставленных параметров, тест считается пройденным, и расположение будет отображено. Даже в том случае, когда расположение не обнаружено, если возможно обращение к веб-службе, тест считается пройденным, но без информации о расположении. Кроме того, при вызове этого командлета без указания необязательных параметров тест все равно считается пройденным, если возможно обращение к веб-службе. Тем не менее, информация о расположении не возвращается.

 

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

TargetFqdn

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

System.String

Полное доменное имя (FQDN) (в виде server.litwareinc.com) сервера, используемое для тестирования.

Этот параметр является обязательным, если не задан параметр TargetUri, и в этом случае задать параметр TargetFqdn нельзя.

TargetUri

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

System.String

Универсальный код ресурса (URI), назначенный службе информирования о местонахождении. Для извлечения кода URI, назначенного службеинформирования о местонахождении, можно выполнить следующую команду: Get-CsService -WebServer | Select-Object LisServiceInternalUri

При указании значения для этого параметр необходимо также задать параметр UserSipAddress. Если компьютер, на котором выполняется команда, не содержит сертификат сервера, необходимо также задать значение для параметр WebCredential.

Этот параметр является обязательным, если не задан параметр TargetFqdn.

UserCredential

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

System.Management.Automation.PSCredential

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

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

Authentication

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

Microsoft.Rtc.Management.SyntheticTransactions.SipSyntheticTransaction+AuthenticationMechanism

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

TrustedServer

Negotiate

ClientCertificate

LiveID

BssId

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

System.String

Идентификатор основного набора служб (BSSID) для беспроводной точки доступа 12-34-56-78-90-ab.

ChassisId

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

System.String

MAC-адрес сетевого коммутатора. Значение должно указываться в виде nn-nn-nn-nn-nn-nn, например, 12-34-56-78-90-ab или IP-адрес.

External

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

System.Management.Automation.SwitchParameter

Этот параметр не поддерживается для Location Information Server.

Force

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

System.Management.Automation.SwitchParameter

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

HybridOnlineUserAuthentication

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

Microsoft.Rtc.Management.SyntheticTransactions.SipSyntheticTransaction+HybridOnlineAuthenticationMechanism

PARAMVALUE: LiveID | OAuth

IsHybridOnlineUser

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

System.Boolean

PARAMVALUE: $true | $false

Mac

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

System.String

MAC-адрес коммутатора порта. Это значение должно указываться в виде nn-nn-nn-nn-nn-nn, например 12-34-56-78-90-ab.

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

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

PortId

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

System.String

Идентификатор порта, связанный с расположением, которое необходимо тестировать. Расположение также может содержать MAC-адрес или IP-адрес.

PortIdSubType

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

Microsoft.Rtc.Management.SyntheticTransactions.PortIDSubType

Подтип порта. Это значение может представлять собой комбинацию цифр или строку, но при этом подтип должен быть действительным. К действительным подтипам относятся:

1: InterfaceAlias;

5: InterfaceName;

7: LocallyAssigned.

RegistrarPort

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

System.Int32

Номер порта службы Registrar.

Subnet

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

System.String

IP-адрес подсети. Это значение должно иметь вид адреса Ipv4 (числа с разделением точками - например, 192.0.2.0).

UserSipAddress

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

System.String

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

При указании значения для этого параметра необходимо также задать параметр TargetFqdn или TargetUri.

Этот параметр является обязательным, если задан параметр TargetFqdn только в том случае, если не указаны пользователи искусственных транзакций. Чтобы проверить, указаны ли пользователи искусственных транзакций, выполните командлет Get-CsHealthMonitoringConfiguration .

WebCredential

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

System.Management.Automation.PSCredential

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

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

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

 
Показ: