Remove-CsClientVersionPolicyRule

Skype for Business Server 2015
 

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

Удаляет одно или несколько правил политики клиентских версий, используемых в вашей организации. Данный командлет впервые появился в Lync Server 2010.

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

Команда из примера 1 удаляет правило политики клиентских версий с идентификатором site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820. Так как идентификаторы уникальны, данная команда удалит максимум одно правило.

Remove-CsClientVersionPolicyRule -Identity site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820

В примере 2 удаляются все правила политики клиентских версий, заданные для сайта Redmond. Для этого команда сначала вызывает командлет Get-CsClientVersionPolicyRule с фильтром "site:Redmond/*", что позволяет вернуть только правила с идентификаторами, которые начинаются со строки "site:Redmond/". Затем отфильтрованная коллекция передается в командлет Remove-CsClientVersionPolicyRule , который удаляет каждый ее элемент.

Get-CsClientVersionPolicyRule -Filter "site:Redmond/*" | Remove-CsClientVersionPolicyRule

В примере 3 удаляются все отключенные правила политики клиентских версий. Для этого команда сначала вызывает без каких-либо параметров командлет Get-CsClientVersionPolicyRule , чтобы получить коллекцию всех используемых правил политики версий. Затем коллекция передается в командлет Where-Object , который отбирает только те правила, у которых свойство Enabled имеет значение False. Отфильтрованная коллекция передается в командлет Remove-CsClientVersionPolicyRule , который удаляет каждый ее элемент.

Get-CsClientVersionPolicyRule | Where-Object {$_.Enabled -eq $False} | Remove-CsClientVersionPolicyRule

Правила политики клиентских версий используются для определения клиентских приложений, которым разрешено выполнение входа в Skype для бизнеса Server 2015. Когда пользователь пытается выполнить вход в Skype для бизнеса Server 2015, его клиентское приложение отсылает серверу SIP-заголовок. Данный заголовок содержит подробные сведения о самом приложении, включая основную и дополнительную версию программного обеспечения, а также номер выпуска. Сведения о версии сравниваются с коллекцией правил политики версий для определения правил, которые относятся к данному приложению. Предположим, что пользователь пытается выполнить вход с помощью Microsoft Office Communicator 2007 R2. Перед выполнением входа система ищет правило, которое относится к Office Communicator 2007 R2. Если такое правило существует, то Skype для бизнеса Server 2015 выполняет действие, описанное в правиле. Действие может быть следующим:

Allow. Пользователю будет разрешено выполнить вход.

AllowAndUpgrade. Пользователю будет разрешено выполнить вход, и его копия Communicator 2007 R2 будет автоматически обновлена до последней версии Lync. Обновление выполняется с помощью Центра обновления Майкрософт или служб Windows Server Update Services (в зависимости от конфигурации вашей системы).

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

Block. Пользователю не будет разрешено выполнить вход.

BlockAndUpgrade. Пользователю не будет разрешено выполнить вход, но его версия Communicator 2007 R2 будет автоматически обновлена до последней версии Lync. Пользователь затем может попытаться выполнить вход с помощью нового клиентского приложения. Обновление выполняется с помощью Центра обновления Майкрософт или служб Windows Server Update Services (в зависимости от конфигурации вашей системы).

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

Правила клиентских версий содержатся в политиках клиентских версий, которые могут быть заданы на глобальном уровне, на уровне сайта, службы (службы Registrar) или для отдельных пользователей. Командлет Remove-CsClientVersionPolicyRule позволяет удалять одно или несколько правил политики клиентских версий, используемых в вашей организации. Правила могут быть удалены из любой политики, даже из глобальной.

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

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

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

 

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор удаляемого правила политики клиентских версий. Идентификатор правила состоит из области действия правила и глобального уникального идентификатора (GUID). Это значит, что у правила будет идентификатор следующего вида: site:Redmond/1987d3c2-4544-489d-bbe3-59f79f530a83.

Confirm

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

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

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.ClientVersion.Rule. Командлет Remove-CsClientVersionPolicyRule принимает из конвейера экземпляры объекта правила клиентских версий.

Нет. Командлет Remove-CsClientVersionPolicyRule удаляет экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule.

 
Показ: