Grant-CsClientPolicy

Skype for Business Server 2015
 

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

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

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

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

Grant-CsClientPolicy -Identity "Ken Myer" -PolicyName SalesPolicy

В примере 2 клиентская политика SalesPolicy назначается всем пользователям, которые относятся к отделу Sales (отдел сбыта). Сначала команда вызывает командлет Get-CsUser с параметром LdapFilter, который возвращает коллекцию всех пользователей, являющихся сотрудниками отдела Sales. Затем эта коллекция передается в командлет Grant-CsClientPolicy , который назначает политику SalesPolicy каждому пользователю из нее.

Get-CsUser -LDAPFilter "Department=Sales" | Grant-CsClientPolicy -PolicyName SalesPolicy

В примере 3 клиентская политика RedmondAccountingPolicy назначается всем пользователям, отвечающим двум условиям: 1) пользователь должен занимать должность бухгалтера (Accountant) и 2) работать в городе Редмонд. Для этого команда сначала вызывает командлет Get-CsUser с параметром LdapFilter, который возвращает коллекцию всех пользователей, работающих в городе Редмонд на должности бухгалтера. Значение фильтра "(&(Title=Accountant)(l=Redmond))" ограничивает возвращаемые данные только теми пользователями, которые занимают должность бухгалтера (Title=Accountant) и (&) работают в городе Редмонд (l=Redmond). (Символ "l" — это строчная буква L, которая представляет местонахождение пользователя.)

Полученная коллекция затем передается в командлет Grant-CsClientPolicy , который назначает политику RedmondAccountingPolicy каждому входящему в нее пользователю.

Get-CsUser -LDAPFilter "(&(Title=Accountant)(l=Redmond))" | Grant-CsClientPolicy -PolicyName RedmondAccountingPolicy

В примере 4 политика AccountingPolicy назначается всем пользователям, отвечающим одному из двух условий: пользователь должен занимать должность бухгалтера (Accountant) или старшего бухгалтера (Senior Accountant). Для выполнения этой задачи вызывается командлет Get-CsUser с параметром LdapFilter, который возвращает коллекцию пользователей с должностью бухгалтера или старшего бухгалтера. Значение фильтра "(|(Title=Accountant)(Title=Senior Accountant))" ограничивает возвращаемые данные только теми пользователями, которые занимают должность бухгалтера (Title=Accountant) или (|) старшего бухгалтера (Title=Senior Accountant). Отфильтрованная коллекция затем передается в командлет Grant-CsClientPolicy , который назначает клиентскую политику AccountingPolicy каждому входящему в коллекцию пользователю.

Get-CsUser -LdapFilter "(|(Title=Accountant)(Title=Senior Accountant))" | Grant-CsClientPolicy -PolicyName AccountingPolicy

В примере 5 клиентская политика AtlantaBranchPolicy назначается всем пользователям, учетные записи которых включены в пул регистратора atl-cs-001.litwareinc.com. Для этого сначала вызывается командлет Get-CsUser , который возвращает соответствующие учетные записи пользователей. Параметр Filter со значением {RegistrarPool -eq "atl-cs-001.litwareinc.com"} позволяет выбрать только те учетные записи пользователей, которые размещены в пуле регистратора atl-cs-001.litwareinc.com. Эта коллекция затем передается в командлет Grant-CsClientPolicy , который назначает клиентскую политику AtlantaBranchPolicy каждому пользователю.

Get-CsUser -Filter {RegistrarPool -eq "atl-cs-001.litwareinc.com"} | Grant-CsClientPolicy -PolicyName AtlantaBranchPolicy

Клиентские политики применяются при входе в систему независимо от способа входа в систему и устройства, используемого для входа. Как и другие политики Skype для бизнеса Server 2015, клиентские политики можно применять к выбранным группам пользователей. Более того, вы можете создать пользовательскую политику и назначить ее конкретному пользователю.

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

 

Параметр Применение Тип Описание

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:RedmondConferencingPolicy — значение RedmondConferencingPolicy.

Если задать для свойства PolicyName пустое значение (null), команда отменит назначение всех политик для пользователя. Пример:

Grant-CsClientPolicy -Identity "Ken Myer" -PolicyName $Null

Confirm

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

System.Management.Automation.SwitchParameter

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

DomainController

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

Microsoft.Rtc.Management.Deploy.Fqdn

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

PassThru

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

System.Management.Automation.SwitchParameter

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

 
Показ: