Test-CsRegistration

Skype for Business Server 2015
 

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

Проверяет возможность входа пользователя в систему Skype для бизнеса Server 2015. Командлет Test-CsRegistration является "искусственной транзакцией", т.е. имитацией типичных действий Skype для бизнеса Server 2015, используемых для мониторинга работоспособности и производительности. Данный командлет впервые появился в Lync Server 2010.

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

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

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

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

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

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

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

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

Вторая команда проверяет, может ли пользователь выполнить вход в пул atl-cs-001.litwareinc.com. Чтобы выполнить эту задачу, вызывается командлет Test-CsRegistration с тремя параметрами: TargetFqdn (полное доменное имя пула регистратора), UserCredential (объект Windows PowerShell, содержащий учетные данные пользователя Pilar Ackerman) и UserSipAddress (адрес SIP, соответствующий предоставленным учетным данным пользователя).

$cred1 = Get-Credential "litwareinc\pilar"

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

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

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

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

Командлет Test-CsRegistration позволяет убедиться в том, что пользователи в организации могут войти в Skype для бизнеса Server 2015. Для выполнения этой проверки командлету Test-CsRegistration требуется одна тестовая учетная запись. Если вы настроили тестовых пользователей для пула, где будет проводиться проверка, то указывать учетную запись не требуется; командлет Test-CsRegistration будет автоматически использовать первую тестовую учетную запись, назначенную пулу. (Дополнительные сведения см. в разделе справки по командлету New-CsHealthMonitoringConfiguration.) Другой вариант проведения теста заключается в использовании учетной записи, которая не была назначена пулу. Это позволяет запустить тесты даже в том случае, если тестовые пользователи не настроены. Это также позволяет проверить возможность входа в Skype для бизнеса Server 2015 конкретного пользователя. (Если выбран этот подход, необходимо предоставить имя пользователя и пароль проверяемой учетной записи.)

Во время запуска командлета Test-CsRegistration он пытается выполнить вход от имени тестового пользователя в Skype для бизнеса Server 2015 и затем, в случае успешного входа, отключает тестового пользователя от системы. Все эти действия осуществляются без участия со стороны пользователя и не затрагивают реальных пользователей. Например, предположим, что тестовая учетная запись sip:kenmyer@litwareinc.com соответствует реальному пользователю с учетной записью Skype для бизнеса Server 2015. В этом случае тест будет проводиться без какого-либо вмешательства в работу реального пользователя Ken Myer. Когда тестовая учетная запись Ken Myer выйдет из системы, личная учетная запись Ken Myer останется в системе.

Добавление параметра Verbose позволяет получить подробные сведения обо всех действиях, выполненных командлетом Test-CsRegistration для проведения теста.

 

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

TargetFqdn

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

System.String

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

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

Force

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

System.Management.Automation.SwitchParameter

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

HybridOnlineUserAuthentication

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

Microsoft.Rtc.Management.SyntheticTransactions.SipSyntheticTransaction+HybridOnlineAuthenticationMechanism

PARAMVALUE: LiveID | OAuth

HybridOnlineUserCredential

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

System.Management.Automation.PSCredential

PARAMVALUE: PSCredential

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 тестируемой учетной записи пользователя, например:

-UserSipAddress "sip:kenmyer@litwareinc.com"

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

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

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

 
Показ: