Test-CsClientAuthentication

Skype for Business Server 2015
 

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

Определяет, может ли пользователь входить в Skype для бизнеса Server 2015 с помощью сертификата, загружаемого из службы подготовки сертификатов. Данный командлет впервые появился в Lync Server 2013.

Test-CsClientAuthentication -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-LiveIdAuthentication <SwitchParameter>] [-OutLoggerVariable <String>] [-OutVerboseVariable <String>] [-RegistrarPort <Int32>] [-TargetFqdn <String>] [-TargetUri <String>]

Команды в примере 1 проверяют, может ли пользователь litwareinc\kenmyer заходить в пул регистратора atl-cs-001.litwareinc.com с помощью сертификата клиента. Для этого первая команда в примере создает объект учетных данных пользователя с помощью командлета Get-Credential . Полученный объект учетных данных (для которого требуется ввести пароль пользователя) сохраняется в переменной $cred1.

Затем вторая команда вызывает командлет Test-CsClientAuthentication , определяющий полное доменное имя пула регистратора (TargetFqdn), SIP-адрес пользователя (UserSipAddress) и объект учетных данных, созданный предыдущей командой (UserCredential).

$cred1 = Get-Credential "litwareinc\kenmyer"

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

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

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

Чтобы получить список всех ролей управления доступом на основе ролей (RBAC), которым назначен этот командлет (включая все самостоятельно созданные роли RBAC), выполните в командной строке Windows PowerShell следующую команду:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsClientAuthentication"}

 

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

UserCredential

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

System.Management.Automation.PSCredential

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

$x = Get-Credential "litwareinc\kenmyer"

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

UserSipAddress

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

System.String

SIP-адрес пользователя, использующийся при проверке. Пример: -UserSipAddress sip:kenmyer@litwareinc.com.

Force

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

System.Management.Automation.SwitchParameter

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

LiveIdAuthentication

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

System.Management.Automation.SwitchParameter

Проверяет, есть ли у пользователя, для которого выполняется тест, право заходить в систему с помощью учетных данных OrgId (Business LiveId).

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.

TargetFqdn

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

System.String

Полное имя домена (FQDN) пула регистратора, где выполняется проверка клиента. Например: -TargetFqdn "atl-cs-001.litwareinc.com".

TargetUri

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

System.String

URL-адрес службы предоставления сертификатов. Если этот параметр не указан, командлет Test-CsClientAuthentication задействует службу предоставления сертификатов, настроенную для пула регистратора.

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

 
Показ: