Set-CsClientVersionPolicy

Skype for Business Server 2015
 

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

Изменяет существующую политику версий клиентов. Политики версий клиентов позволяют указать, какие клиенты (например, Microsoft Office Communicator 2007 R2) могут входить в систему Skype для бизнеса Server 2015. Данный командлет впервые появился в Lync Server 2010.

Set-CsClientVersionPolicy [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsClientVersionPolicy [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Rules <PSListModifier>] [-Tenant <Guid>] [-WhatIf [<SwitchParameter>]]

Команды, показанные в примере 1, копируют все правила версий клиентов из одной политики версий клиентов в другую. Для этого первая команда в примере вызывает командлет Set-CsClientVersionPolicy , который удаляет все правила из политики site:Redmond. С этой целью свойству Rules присваивается значение null. После удаления правил вторая команда в примере вызывает командлет Get-CsClientVersionPolicy , который извлекает все правила версий клиентов, настроенные для политики site:Dublin. Эти правила хранятся в переменной с именем $x.

В последней команде командлет Set-CsClientVersionPolicy вызывается повторно, но на этот раз он присваивает свойству Rules политики Redmond значение $x. В результате все правила копируются из политики site:Dublin и добавляются в политику site:Redmond.

Set-CsClientVersionPolicy -Identity site:Redmond -Rules $Null

$x = Get-CsClientVersionPolicy -Identity site:Dublin | Select-Object -ExpandProperty Rules

Set-CsClientVersionPolicy -Identity site:Redmond -Rules $x

Политики версий клиентов представляют коллекции правил версий клиентов; правила же в свою очередь используются для определения, каким клиентским приложениям разрешен вход на Skype для бизнеса Server 2015. Когда пользователь пытается войти на Skype для бизнеса Server 2015, его клиентское приложение отправляет на сервер заголовок SIP; этот заголовок содержит подробные сведения о самом приложении, включая основной и дополнительный номера версии, а также номер построения. Затем сведения о версии, включенные в заголовок SIP, проверяются в коллекции правил версий клиентов, чтобы найти правила, применимые к этому конкретному приложению. Если такое правило существует, то Skype для бизнеса Server 2015 будет выполнять действие, указанное правилом. Например, правило может указывать Skype для бизнеса Server 2015 разрешить вход, заблокировать его, а также разрешить, но затем без предупреждения обновить клиентское приложение до последней версии (например, обновить Communicator 2007 R2 до Skype для бизнеса).

Политики версий клиентов, которые можно применять на глобальном уровне, уровне сайта, службы (только для службы регистратора) или пользователя, предоставляют гибкие возможности по определению того, каким клиентским приложениям разрешено получать доступ к системе. Например, можно запретить пользователям входить в Skype для бизнеса Server 2015 с помощью Communicator 2007 R2, поскольку это приложение не поддерживает функций и возможностей Skype для бизнеса. Однако из-за конфликтов оборудования или программного обеспечения для определенной группы пользователей обновление до Skype для бизнеса может оказаться невозможным. В этом случае можно создать отдельное правило (и отдельную политику версий клиентов), разрешающее этим пользователям выполнять вход из Communicator 2007 R2.

Политики версий клиентов можно изменять в любой момент. Изменение политики версий клиентов, как правило, подразумевает добавление новых правил, удаление существующих правил или изменение свойств существующего правила (например, изменение действия правила с "Разрешить" на "Блокировать"). Для внесения этих изменений можно использовать командлет Set-CsClientVersionPolicy . Однако, возможно, проще будет использовать командлет CsClientVersionPolicyRule .

С другой стороны, командлет Set-CsClientVersionPolicy позволяет легко скопировать весь набор правил из одной политики версий клиентов в другую. Подробные сведения см. в подразделе "Примеры" данного раздела справки.

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

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

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

 

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

Confirm

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

System.Management.Automation.SwitchParameter

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

Description

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

System.String

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

Force

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

System.Management.Automation.SwitchParameter

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор политики, которую необходимо изменить. Чтобы изменить глобальную политику, используйте следующий синтаксис: -Identity global. Чтобы изменить политику, настроенную на уровне сайта, используйте следующий синтаксис: -Identity "site:Redmond". Чтобы изменить политику, настроенную на уровне службы, используйте следующий синтаксис: -Identity "Registrar:atl-cs-001.litwareinc.com". Служба регистратора — это единственная служба, к которой можно применить политику версий клиентов.

С помощью этого командлета можно также изменять политики уровня пользователя. Для этого используйте следующий синтаксис: -Identity "SalesDepartmentPolicy".

Если этот параметр не задан, командлет Set-CsClientVersionPolicy изменяет глобальную политику.

Instance

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

Объект ClientVersionPolicy

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

Rules

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

System.Management.Automation.PSListModifier

Коллекция отдельных правил версий клиентов, назначенных политике.

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.ClientVersionPolicy. Командлет Set-CsClientVersionPolicy принимает из конвейера экземпляры объекта, представляющего политику версий клиентов.

Командлет Set-CsClientVersionPolicy не возвращает значений или объектов. Вместо этого он настраивает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy.

 
Показ: