Grant-CsClientVersionPolicy

Skype for Business Server 2015
 

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

Назначает политику версий клиентов на глобальном уровне, уровне сайта, службы и пользователей. Политики версий клиентов позволяют указать, какие клиенты (например, Microsoft Office Communicator 2007 R2) могут входить в систему Skype для бизнеса Server 2015. Данный командлет впервые появился в Lync Server 2010.

Grant-CsClientVersionPolicy -Identity <UserIdParameter> -PolicyName <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

В примере 1 политика версий клиентов RedmondClientVersionPolicy назначается пользователю Ken Myer.

Grant-CsClientVersionPolicy -Identity "Ken Myer" -PolicyName "RedmondClientVersionPolicy"

Команда, показанная в примере 2, назначает политику версий клиентов RedmondClientVersionPolicy всем пользователям, работающим в городе Редмонд. Для этого она сначала вызывает командлет Get-CsUser с параметром LdapFilter, который извлекает соответствующую коллекцию учетных записей пользователей. Значение фильтра "l=Redmond" (где "l" — это строчная буква L, имя атрибута LDAP, означающее "расположение") позволяет извлечь данные только для пользователей, работающих в городе Редмонд. Эта коллекция затем передается в командлет Grant-CsClientVersionPolicy , который назначает указанную политику каждому пользователю в коллекции.

Get-CsUser -LdapFilter "l=Redmond" | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"

В примере 3 всем пользователям, относящимся к определенному подразделению, назначается политика версий клиентов RedmondClientVersionPolicy. Для выполнения этой задачи команда сначала вызывает командлет Get-CsUser с параметром OU. Значение параметра представляет собой различающееся имя подразделения, пользователям которого необходимо назначить политику версий клиентов (ou=Redmond,ou=North America,dc=litwareinc,dc=com). После получения учетных записей пользователей коллекция передается в командлет Grant-CsClientVersionPolicy , который назначает политику RedmondClientVersionPolicy каждому из этих пользователей.

Get-CsUser -OU "ou=Redmond,ou=North America,dc=litwareinc,dc=com" | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"

В примере 4 политика версий клиентов RedmondClientVersionPolicy назначается всем пользователям, которым ранее была назначена политика голосовой связи RedmondVoicePolicy. Для этого команда сначала вызывает командлет Get-CsUser с параметром Filter. Значение фильтра {VoicePolicy -eq "RedmondVoicePolicy"} позволяет выбрать только те учетные записи пользователей, свойство VoicePolicy которых имеет значение "RedmondVoicePolicy". Полученные учетные записи затем передаются в командлет Grant-CsClientVersionPolicy , с помощью которого им назначается политика версий клиентов RedmondClientVersionPolicy.

Get-CsUser -Filter {VoicePolicy -eq "RedmondVoicePolicy"} | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"

В примере 5 для всех пользователей в организации отменяется назначение всех политик версий клиентов, ранее назначенных им на уровне пользователя. Для этого команда сначала вызывает командлет Get-CsUser , который возвращает коллекцию всех пользователей организации с включенной поддержкой Skype для бизнеса Server 2015. Затем эта коллекция передается в командлет Remove-CsClientVersionPolicy , который удаляет все политики версий клиентов, назначенные этим учетным записям на уровне пользователя. Для этого параметру PolicyName присваивается значение $null.

Get-CsUser | Grant-CsClientVersionPolicy -PolicyName $Null

Политики версий клиентов представляют собой коллекции правил версий клиентов; правила же, в свою очередь, используются для определения того, каким клиентским приложениям разрешен вход в Skype для бизнеса Server 2015. Когда пользователь пытается войти в Skype для бизнеса Server 2015, его клиентское приложение отправляет на сервер заголовок SIP; этот заголовок содержит подробные сведения о самом приложении, включая основной и дополнительный номера версии, а также номер построения. Затем сведения о версии, включенные в заголовок SIP, сравниваются с коллекцией правил версий клиентов для поиска правил, применимых к этому конкретному приложению. Если такое правило существует, то Skype для бизнеса Server 2015 будет выполнять действие, указанное в правиле. Например, правило может указывать серверу Skype для бизнеса Server 2015 на то, что необходимо разрешить вход, заблокировать его или разрешить вход, но затем без предупреждения обновить клиентское приложение до последней версии (например, обновить Office Communicator 2007 R2 до Skype для бизнеса).

Политики версий клиентов, которые можно применять на глобальном уровне, уровне сайта, службы (только для службы регистратора) или пользователя, предоставляют гибкие возможности по определению того, каким клиентским приложениям разрешено получать доступ к системе. Например, можно запретить пользователям входить в Skype для бизнеса Server 2015 с помощью Communicator 2007 R2, поскольку это устаревшее клиентское приложение не поддерживает функций и возможностей Skype для бизнеса. Однако из-за конфликтов оборудования или программного обеспечения для определенной группы пользователей обновление до Skype для бизнеса может оказаться невозможным. В этом случае можно создать отдельное правило (и отдельную политику версий клиентов), разрешающее этим пользователям выполнять вход из Communicator 2007 R2.

Командлет Grant-CsClientVersionPolicy позволяет назначать политики версий клиентов отдельным пользователям. Политика, созданная на уровне пользователя, не назначается автоматически ни одному из пользователей. Чтобы назначить ее пользователю или группе пользователей явным образом, необходимо вызвать командлет Grant-CsClientVersionPolicy .

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

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

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Grant-CsClientVersionPolicy"}

 

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

Identity

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

Microsoft.Rtc.Management.AD.UserIdParameter

Указывает удостоверение учетной записи пользователя, которой назначается политика. Удостоверения пользователей можно указать в одном из четырех форматов: 1) SIP-адрес пользователя; 2) имя участника-пользователя (UPN); 3) доменное имя пользователя и его имя для входа в формате "домен\логин" (например, litwareinc\kenmyer); 4) отображаемое имя пользователя в Active Directory (например, Ken Myer). Удостоверения пользователей также можно указывать с помощью различающихся имен пользователей Active Directory.

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

PolicyName

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

System.String

Имя назначаемой политики. Значение свойства PolicyName представляет собой попросту идентификатор политики без области ее действия ("tag:"). Например, для политики с идентификатором tag:Redmond свойство PolicyName имеет значение Redmond, а для политики с идентификатором tag:RedmondClientVersionPolicy — значение RedmondClientVersionPolicy. Чтобы отменить назначение политики на уровне пользователя, задайте для свойства PolicyName пустое значение ($null).

Confirm

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

System.Management.Automation.SwitchParameter

Запрашивает подтверждение перед выполнением команды.

DomainController

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

Microsoft.Rtc.Management.Deploy.Fqdn

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

PassThru

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

System.Management.Automation.SwitchParameter

Если параметр указан, командлет передает объект пользователя (или объекты) через конвейер Windows PowerShell. По умолчанию командлет Grant-CsClientVersionPolicy не передает объекты через конвейер.

WhatIf

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

System.Management.Automation.SwitchParameter

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

Строковое значение или объект Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Командлет Grant-CsClientVersionPolicy принимает в качестве входных данных переданные по конвейеру строковые значения, представляющие удостоверение учетной записи пользователя (а также объекты пользователей).

По умолчанию командлет Grant-CsClientVersionPolicy не возвращает значений или объектов. Но если указать параметр PassThru, командлет вернет экземпляры объекта Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact.

 
Показ: