Get-CsDeviceUpdateRule

Skype for Business Server 2015
 

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

Возвращает сведения о правилах обновления устройств, настроенных для использования в организации. Правила обновления устройств используются для связи обновлений встроенного ПО с устройствами под управлением Skype для бизнеса. Данный командлет впервые появился в Lync Server 2010.

Get-CsDeviceUpdateRule [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Get-CsDeviceUpdateRule [-Filter <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-LocalStore <SwitchParameter>]

Skype для бизнеса Server 2015 использует правила обновления устройств для доставки обновлений встроенного ПО на устройства под управлением Skype для бизнеса. Администраторы периодически отправляют набор правил обновления устройств в Skype для бизнеса Server 2015. После выполнения проверки и утверждения эти правила автоматически загружаются и применяются к соответствующим устройствам при их подключении к системе. По умолчанию устройства проверяют наличие новых обновлений при каждом включении и подключении к Skype для бизнеса Server 2015. Кроме того, после выполнения входа устройства повторяют проверку на наличие обновлений через каждые 24 часа.

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

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

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

 

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

Filter

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

System.String

Позволяет использовать подстановочные знаки при указании идентификатора правила обновления устройства или набора правил. Например, для получения всех правил обновления устройств для WebServer:atl-cs-001.litwareinc.com можно использовать значение фильтра "service:WebServer:atl-cs-001.litwareinc.com*".

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор правила обновления устройства. Этот идентификатор состоит из двух частей: области службы, в которой применяется правило (например, service:WebServer:atl-cs-001.litwareinc.com), и глобального уникального идентификатора (GUID), предварительно присвоенного правилу (например, d5ce3c10-2588-420a-82ac-dc2d9b1222ff9). Таким образом, идентификатор данного правила обновления устройства будет выглядеть так: "service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9".

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

LocalStore

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

System.Management.Automation.SwitchParameter

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

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

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

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

Get-CsDeviceUpdateRule

Команда, показанная в примере 2, возвращает сведения о правиле обновления устройства с идентификатором "WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9".

Get-CsDeviceUpdateRule -Identity service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9

В примере 3 возвращаются сведения о всех правилах обновления устройств, настроенных для службы WebServer:atl-cs-001.litwareinc.com. Для выполнения этой задачи используется параметр Filter со значением "WebServer:atl-cs-001.litwareinc.com*". Этот фильтр позволяет получить сведения только о тех правилах обновления устройств, идентификатор которых начинается со строкового значения "service:WebServer:atl-cs-001.litwareinc.com".

Get-CsDeviceUpdateRule -Filter service:WebServer:atl-cs-001.litwareinc.com*

В примере 4 возвращаются все правила обновления устройств, у которых свойство Brand имеет значение "LG-Nortel". Для этого вызывается командлет Get-CsDeviceUpdateRule , который возвращает коллекцию из всех правил обновления устройств в организации. Затем эта коллекция передается в командлет Where-Object , который выбирает только те правила, у которых свойство Brand имеет значение "LG-Nortel".

Get-CsDeviceUpdateRule | Where-Object {$_.Brand -eq "LG-Nortel"}

В примере 5 возвращается коллекция из всех правил обновления устройств, которые не утверждены. Для этого используется командлет Get-CsDeviceUpdateRules , который возвращает коллекцию из всех правил. Затем эта коллекция передается в командлет Where-Object . Командлет Where-Object выбирает только те правила, у которых свойство Approved имеет значение Null. Если свойство Approved имеет значение Null, значит правило не утверждено.

Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -eq $Null}

Эта команда возвращает коллекцию из всех правил обновления устройств, которые соответствуют следующим условиям: правило утверждено и связано с устройствами LG-Nortel. Для выполнения этой задачи сначала вызывается командлет Get-CsDeviceUpdateRule , который возвращает коллекцию из всех правил обновления устройств в организации. Затем эта коллекция передается в командлет Where-Object , который фильтрует ее по двум критериям: свойство Approved не должно иметь значение Null (т. е. должно иметь определенное значение) и свойство Brand должно иметь значение "LG-Nortel".

Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -ne $Null -and $_.Brand -eq "LG-Nortel"}
 
Показ: