Set-CsClientVersionPolicyRule

Skype for Business Server 2015
 

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

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

Set-CsClientVersionPolicyRule [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsClientVersionPolicyRule [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Action <Allow | AllowAndUpgrade | AllowWithUrl | Block | BlockAndUpgrade | BlockWithUrl>] [-ActionUrl <String>] [-BuildNumber <UInt16>] [-CompareOp <EQL | NEQ | GTR | GEQ | LSS | LEQ>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-MajorVersion <UInt16>] [-MinorVersion <UInt16>] [-Priority <Int32>] [-QfeNumber <UInt16>] [-Tenant <Guid>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]

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

Set-CsClientVersionPolicyRule -Identity site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820 -Enabled $False

В примере 2 добавляется общее описание для всех правил политики клиентской версии, назначенных сайту Redmond. Для этого команда вызывает командлет Get-CsClientVersionPolicyRule с параметром Filter. Значение фильтра "site:Redmond/*" ограничивает возвращаемые данные правилами политики, назначенными сайту Redmond. Полученная коллекция передается в командлет Set-CsClientVersionPolicyRule , который присваивает описание "Client policy rules for Redmond" (Правила политики клиентской версии для сайта Redmond) каждому элементу коллекции.

Get-CsClientVersionPolicyRule -Filter "site:Redmond*" | Set-CsClientVersionPolicyRule -Description "Client policy rules for Redmond"

В примере 3 показано блокирование клиентов Unified Communications Client Platform (UCCP) для всех правил политики клиентской версии, которые используют UCCP в качестве агента пользователя. Чтобы получить коллекцию правил политики клиентской версии, используемых в организации, команда сначала вызывает командлет Get-CsClientVersionPolicyRule . Полученная коллекция передается в командлет Where-Object , который выбирает только те правила, свойство UserAgent которых имеет значение (-eq) UCCP. Затем полученная коллекция передается в командлет Set-CsClientVersionPolicyRule , который присваивает свойству Action каждого элемента коллекции значение Block.

Get-CsClientVersionPolicyRule | Where-Object {$_.UserAgent -eq "UCCP"} | Set-CsClientVersionPolicyRule -Action "Block"

Правила клиентской версии используются для указания клиентских приложений, которым разрешен вход на Skype для бизнеса Server 2015. Когда пользователь пытается войти на Skype для бизнеса Server 2015, клиентское приложение отправляет серверу заголовок SIP. Этот заголовок содержит подробные сведения о приложении, включая сведения об основном номере версии, дополнительном номере версии и номере построения приложения. Сведения о версии сравниваются с коллекцией правил политики клиентской версии, чтобы проверить, применяются ли какие-нибудь правила к этому приложению. Например, пользователь пытается выполнить вход с помощью Microsoft Office Communicator 2007 R2. Прежде чем пользователь сможет войти на Skype для бизнеса Server 2015, система проверит наличие правил клиентской версии, применяемых к 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) или на уровне пользователя. С помощью командлета Set-CsClientVersionPolicyRule можно изменить свойства существующего правила клиентской версии.

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

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

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

 

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

Action

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

Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Action

Действие, которое должно выполняться каждый раз, когда срабатывает правило (т.е. каждый раз, когда кто-либо пытается войти с использованием указанного ПО). Допускаются следующие значения:

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

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

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

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

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

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

ActionUrl

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

System.String

URL-адрес, по которому пользователи могут загрузить последнюю версиюLync. Это свойство необходимо, если для параметра Action установлено значение BlockWithUrl или AllowWithUrl.

BuildNumber

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

System.UInt16

Номер построения ПО. Например, если копия Communicator имеет версию 2.0.6362.111, то номер построения — 6362. Номера построений представляют внутренние версии ПО во время процесса разработки и помогают убедиться, что используется окончательная, а не предварительная версия.

CompareOp

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

Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.CompareOp

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

EQL (равно)

NEQ (не равно)

GTR (больше)

GEQ (больше или равно)

LSS (меньше)

LEQ (меньше или равно)

Confirm

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

System.Management.Automation.SwitchParameter

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

Description

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

System.String

Позволяет администраторам предоставить дополнительные сведения о правиле версий клиентов. Например, параметр Description может содержать сведения о том, к кому следует обратиться, если требуется изменение правила.

Enabled

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

System.Boolean

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

Force

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

System.Management.Automation.SwitchParameter

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

Instance

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

Объект правила

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

MajorVersion

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

System.UInt16

Основной номер версии приложения. Например, если ваша копия Communicator имеет версию 2.0.6362.111, то свойство MajorVersion имеет значение 2. Основные номера версий соответствуют основным выпускам приложения.

MinorVersion

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

System.UInt16

Дополнительный номер версии ПО. Например, если копия Communicator имеет версию 2.0.6362.111, то дополнительный номер версии — 0. Дополнительные номера версий приравниваются к номерам промежуточных выпусков ПО.

Priority

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

System.Int32

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

QfeNumber

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

System.UInt16

Номер исправления QFE этого ПО. Например, если копия Communicator имеет версию 2.0.6362.111, то номер исправления QFE — 111. Номера QFE представляют запланированные обновления приложения, которые становятся доступными после официального выпуска ПО.

Tenant

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

System.Guid

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

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

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

Get-CsTenant | Select-Object DisplayName, TenantID

UserAgent

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

System.String

Обозначение, используемое для идентификации клиента приложения. Например, OC — обозначение агента пользователя для Communicator. Командлет Get-CsClientVersionConfiguration предоставляет соответствующие понятные имена для каждого обозначения агента пользователя.

UserAgentFullName

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

System.String

Позволяет администраторам предоставить понятное имя для агента пользователя. Например, вместо ссылки на агента пользователя UCCP администраторы могут указать полное имя: Microsoft Unified Communications Client.

WhatIf

Optional

System.Management.Automation.SwitchParameter

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

Объект Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule. Командлет Set-CsClientVersionPolicyRule принимает из конвейера экземпляры объекта правила клиентских версий.

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

 
Показ: