New-CsClientVersionPolicyRule

Skype for Business Server 2015
 

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

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

New-CsClientVersionPolicyRule -Identity <XdsIdentity> <COMMON PARAMETERS>
New-CsClientVersionPolicyRule -Parent <String> -RuleId <String> <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>] [-InMemory <SwitchParameter>] [-MajorVersion <UInt16>] [-MinorVersion <UInt16>] [-Priority <Int32>] [-QfeNumber <UInt16>] [-Tenant <Guid>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]

Пример 1 показывает, как можно создать новое правило политики версий клиентов. Правила политики имеют удостоверения, состоящие из двух частей: области, которой следует назначить это правило, и 36-символьного идентификатора GUID. При создании удостоверения для новой политики версий клиентов сначала необходимо с помощью метода NewGuid платформы .NET Framework создать новый GUID. Это действие реализуется в первой команде данного примера, и полученный GUID сохраняется в переменной $x.

После создания GUID можно создать новое правило с помощью командлета New-CsClientVersionPolicyRule . Эта команда использует четыре параметра: Parent со значением, представляющим область (site:Redmond) для нового правила; RuleId со значением $x (представляющим только что созданный GUID); MajorVersion (4); UserAgent (InHouse). В данном случае параметр UserAgent представляет внутреннее клиентское приложение.

$x = [guid]::NewGuid()

New-CsClientVersionPolicyRule -Parent "site:Redmond" -RuleId $x -MajorVersion 4 -UserAgent InHouse

Команды, показанные в примере 2, представляют вариант команд, показанных в примере 1, но в данном случае новое правило сначала создается только в памяти, а потом добавляется в Skype для бизнеса Server 2015. Для выполнения данной задачи первая команда в примере создает часть GUID удостоверения. Во второй команде создается правило политики версий клиентов только в памяти; параметр InMemory гарантирует, что правило существует только в памяти и не добавляется в инфраструктуру Skype для бизнеса Server 2015 немедленно. Как и в примере 1, параметры Parent и RuleId используются для указания области и GUID нового правила, которые являются двумя частями, составляющими удостоверение правила.

После создания виртуального правила с помощью следующих двух команд выполняется установка значений для свойств MajorVersion и UserAgent соответственно. После завершения этих задач с помощью последней команды в примере и командлета Set-CsClientVersionPolicyRule создается фактическое правило политики версий клиентов, которое назначается узлу Redmond.

$x = [guid]::NewGuid()

$z = New-CsClientVersionPolicyRule -Parent "site:Redmond" -RuleId $x -InMemory
$z.MajorVersion = 4 
$z.UserAgent = "Inhouse"
Set-CsClientVersionPolicyRule -Instance $z

Правила политики, касающиеся версий клиентов, используются для определения клиентских приложений, которые могут выполнять вход на 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 будет автоматически обновлена до последней версии Skype для бизнеса. Обновление выполняется с помощью Центра обновления Майкрософт или служб Windows Server Update Services (в зависимости от конфигурации вашей системы).

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

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

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

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

Правила политик версий клиентов собираются в политики версий клиентов, которые затем можно настраивать на глобальном уровне, на уровне узла, на уровне службы (службы регистратора) или на уровне пользователя. Новые правила политики версий клиентов создаются с помощью командлета New-CsClientVersionPolicyRule . При создании нового правила необходимо также указать для него удостоверение (параметр Identity); это удостоверение состоит из области (например, site:Redmond) и глобального уникального идентификатора (GUID). Можно либо самостоятельно поместить их вместе в параметр Identity, либо предоставить область (параметр Parent) и GUID (параметр RuleId), чтобы Identity создал командлет New-CsClientVerisonPolicyRule .

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

 

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

Вместо параметра Identity можно использовать параметры Parent и RuleId, чтобы командлет New-CsClientVerisonPolicyRule создал этот параметр Identity.

Parent

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

System.String

Информация об области действия нового правила. Если требуется с помощью параметра Parent создать новое правило для глобальной политики, применяется следующий синтаксис: -Parent global. При создании нового правила для политики сайта применяется, например, следующий синтаксис: -Parent "site:Redmond". При создании нового правила для политики службы применяется, например, следующий синтаксис: -parent "Registrar:atl-cs-001.litwareinc.com". При создании нового правила для политики, относящейся к конкретному пользователю, применяется, например, следующий синтаксис: -Parent "RedmondClientVersionPolicy".

При создании нового правила следует использовать либо параметр Identity, либо оба параметра Parent и RuleId.

RuleId

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

System.String

Глобальный уникальный идентификатор (GUID) для правила. В Windows PowerShell можно создать GUID с помощью следующей команды:

$x = [guid]::NewGuid()

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 ($False), то правило будет игнорироваться при каждой попытке входа пользователя с помощью указанного ПО. Значение по умолчанию — True.

Force

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

System.Management.Automation.SwitchParameter

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

InMemory

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

System.Management.Automation.SwitchParameter

Создает ссылку на объект без фиксации объекта в качестве постоянного изменения. Если выходные данные этого командлета, вызванного с помощью указанного параметра, назначаются переменной, можно внести изменения в свойства ссылки на объект и затем зафиксировать эти изменения, вызвав соответствующий командлет Set-<cmdlet> .

MajorVersion

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

System.UInt16

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

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.

UserAgentFullName

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

System.String

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

Нет. Командлет New-CsClientVersionPolicyRule не принимает входные данные из конвейера.

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

 
Показ: