Get-CsClientVersionPolicyRule

Skype for Business Server 2015
 

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

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

Get-CsClientVersionPolicyRule [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Get-CsClientVersionPolicyRule [-Filter <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-LocalStore <SwitchParameter>] [-Tenant <Guid>]

В примере 1 возвращаются сведения обо всех правилах политики, касающихся версий клиентов, которые в настоящее время используются в организации.

Get-CsClientVersionPolicyRule

В примере 2 возвращаются сведения о правиле политики, касающемся версий клиентов: правило с параметром Identity Global/2336c611-a243-4c5d-994b-eea8a524d0e4.

Get-CsClientVersionPolicyRule -Identity "Global/2336c611-a243-4c5d-994b-eea8a524d0e4"

Пример 3 возвращает все правила политики, касающиеся версий клиентов, которые были настроены в глобальной области. Для этого используется команда с параметром Filter и значением "Global/*". Это значение фильтра возвращает только те правила, которые имеют удостоверение, начинающееся со строкового значения "Global /".

Get-CsClientVersionPolicyRule -Filter "Global/*"

Команда, показанная в примере 4, возвращает все правила политики, касающиеся версий клиентов, которые в настоящее время отключены. Для этого команда сначала использует командлет Get-CsClientVersionPolicy , чтобы возвратить коллекцию всех правил политики, касающихся версий клиентов. Эта коллекция затем поступает по конвейеру в командлет Where-Object , который распознает правила, в которых свойство Enabled установлено в значение False.

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

Пример 5 возвращает все правила политики, касающиеся версий клиентов, блокирующие вход в систему клиентскому приложению. Для этого команда сначала использует командлет Get-CsClientVersionPolicy без параметров, который возвращает коллекцию всех правил, используемых в настоящий момент. Эта коллекция затем поступает по конвейеру в командлет Where-Object , который выбирает только те правила, в которых свойство Action установлено в значение Block.

Get-CsClientVersionPolicyRule | Where-Object {$_.Action -eq "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 будет автоматически обновлена до последней версии 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 подобный сайт не создается автоматически.

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

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

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

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

 

Параметр Применение Тип Описание

Filter

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

System.String

Позволяет использовать подстановочные знаки при задании возвращаемых правил политики, касающихся версий клиентов. Например, для возврата всех правил политики, которые были настроены для веб-сайта Редмонд, используйте этот синтаксис: -Filter "site:Redmond/*".

В одной команде нельзя одновременно использовать параметры Filter и Identity.

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

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

LocalStore

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

System.Management.Automation.SwitchParameter

Возвращает данные о правиле политики, касающегося версий клиентов, из локальной реплики центрального хранилища управления, а не из самого центрального хранилища управления.

Tenant

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

System.Guid

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

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

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

Get-CsTenant | Select-Object DisplayName, TenantID

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

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

 
Показ: