Remove-CsClientPolicy

Skype for Business Server 2015
 

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

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

Remove-CsClientPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Tenant <Guid>] [-WhatIf [<SwitchParameter>]]

В примере 1 показано удаление политики клиента со свойством Identity, имеющим значение SalesPolicy, с помощью командлета Remove-CsClientPolicy .

Remove-CsClientPolicy -Identity SalesPolicy

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

Get-CsClientPolicy -Filter "tag:*" | Remove-CsClientPolicy

В примере 3 показано удаление всех клиентских политик, у которых свойство EnableAppearOffline имеет значение True. Командлет Get-CsClientPolicy , вызываемый без дополнительных параметров, возвращает коллекцию всех клиентских политик, заданных в организации. Полученная коллекция передается командлету Where-Object , который выбирает только те политики, у которых свойство EnableAppearOffline имеет значение True. Затем полученная коллекция передается командлету Remove-CsClientPolicy , который удаляет каждую политику в коллекции.

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

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

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

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

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsClientPolicy"}

 

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор клиентской политики, которую необходимо удалить. Чтобы "удалить" глобальную политику, используйте следующий синтаксис: -Identity global. (Обратите внимание, что глобальная политика не удаляется, а всем свойствам этой политики присваиваются значения по умолчанию.) Чтобы удалить политику на уровне сайта, используйте синтаксис, похожий на этот: -Identity "site:Redmond". Чтобы удалить политику на уровне пользователя, используйте синтаксис, похожий на этот: -Identity "SalesDepartmentPolicy". При указании идентификатора политики нельзя использовать подстановочные знаки.

Confirm

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

Если этот параметр указан, то политика будет автоматически удалена, даже если она назначена хотя бы одному пользователю. Если этот параметр не указан, то командлет Remove-CsClientPolicy не будет удалять политику на уровне пользователя, если она назначена хотя бы одному пользователю. На экране появится запрос на удаление политики. Для продолжения работы команды и удаления политики потребуется ответить "Да" (нажав клавишу Y).

Tenant

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

System.Guid

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

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

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

Get-CsTenant | Select-Object DisplayName, TenantID

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

 
Показ: