Get-CsClientPolicy

Skype for Business Server 2015
 

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

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

Get-CsClientPolicy [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Get-CsClientPolicy [-Filter <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-LocalStore <SwitchParameter>] [-Tenant <Guid>]

В примере 1 командлет Get-CsClientPolicy вызывается без дополнительных параметров. При этом возвращается коллекция всех клиентских политик, настроенных для использования в организации.

Get-CsClientPolicy

В примере 2 командлет Get-CsClientPolicy возвращает клиентскую политика уровня пользователя с идентификатором SalesPolicy. Поскольку идентификаторы являются уникальными, эта команда возвращает не более одного объекта.

Get-CsClientPolicy -Identity SalesPolicy

В примере 3 используется параметр Filter, с помощью которого возвращаются все клиентские политики, настроенные на уровне пользователя. Значение фильтра "tag:*" указывает командлету Get-CsClientPolicy на то, что необходимо вернуть только те политики, идентификаторы которых начинаются со строки "tag:".

Get-CsClientPolicy -Filter "tag:*"

В примере 4 возвращается коллекция всех клиентских политик, свойство DisableSavingIM которых имеет значение True. Для этого сначала вызывается командлет Get-CsClientPolicy без параметров, который возвращает коллекцию всех клиентских политик, настроенных для использования в организации. Эта коллекция затем передается в командлет Where-Object , который выбирает только те политики, свойство DisableSavingIM которых имеет значение True.

Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True}

В примере 5 возвращаются только те клиентские политики, которые соответствуют двум условиям: свойство DisableSavingIM должно иметь значение True, а свойство EnableIMAutoArchiving — значение False. Для этого команда сначала вызывает командлет Get-CsClientPolicy , который возвращает коллекцию всех клиентских политик, настроенных для использования в организации. Эта коллекция затем передается в командлет Where-Object , который выбирает только те политики, которые соответствуют двум условиям: свойство DisableSavingIM должно иметь значение True, а свойство EnableIMAutoArchiving — значение False. Оператор -and указывает командлету Where-Object на то, что необходимо выбрать только те объекты, которые удовлетворяют всем указанным условиям.

Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True -and $_.EnableIMAutoArchiving -eq $False}

В примере 6 показана видоизмененная команда из примера 5. Однако в этом случае выбираются политики, удовлетворяющие по крайней мере одному из следующих условий: свойство DisableSavingIM имеет значение True или свойство EnableIMAutoArchiving имеет значение False. Для выполнения этой задачи команда сначала вызывает командлет Get-CsClientPolicy , который возвращает коллекцию всех клиентских политик, настроенных для использования в организации. Эта коллекция затем передается в командлет Where-Object , выбирающий только те политики, которые соответствуют по крайней мере одному из следующих условий: свойство DisableSavingIM имеет значение True или свойство EnableIMAutoArchiving имеет значение False. Оператор -or указывает командлету Where-Object на то, что необходимо выбрать все объекты, которые удовлетворяют по крайней мере одному из указанных условий.

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

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

 

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

Filter

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

System.String

Позволяет использовать подстановочные знаки при указании политики (или политик), которую необходимо вернуть. Например, чтобы вернуть все политики, настроенные на уровне сайта, используйте следующий синтаксис: -Filter "site:*". Чтобы вернуть коллекцию всех политик уровня пользователя, используйте следующий синтаксис: -Filter "tag:*".

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор клиентской политики, которую необходимо вернуть. Для указания глобальной политики, используйте следующий синтаксис: -Identity global. Для указания политики уровня сайта, используйте следующий синтаксис: -Identity site:Redmond. Для указания политики уровня пользователя, используйте следующий синтаксис: -Identity SalesDepartmentPolicy.

Если этот параметр не задан, возвращаются все клиентские политики, настроенные для использования в организации.

LocalStore

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

System.Management.Automation.SwitchParameter

Данные клиентских политик извлекаются из локальной реплики центрального хранилища управления, а не из самого центрального хранилища управления.

Tenant

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

System.Guid

Уникальный глобальный идентификатор (GUID) учетной записи клиента Skype для бизнеса Online, для которой выполняется возврат клиентских политик. Пример:

-Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"

Идентификатор каждого из клиентов Skype для бизнеса Online можно получить с помощью следующей команды:

Get-CsTenant | Select-Object DisplayName, TenantID

Отсутствуют. Командлет Get-CsClientPolicy не принимает входные данные из конвейера.

Командлет Get-CsClientPolicy возвращает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Policy.Client.ClientPolicy.

 
Показ: