Restore-CsDeviceUpdateRule

Skype for Business Server 2015
 

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

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

Restore-CsDeviceUpdateRule [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Restore-CsDeviceUpdateRule [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

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

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

В примере 2 восстанавливаются все правила обновления устройств, настроенных для службы WebServer:atl-cs-001.litwareinc.com. Для этого команда сначала вызывает командлет Get-CsDeviceUpdateRule с параметром Filter; значение фильтра "WebServer:atl-cs-001.litwareinc.com*" обеспечивает извлечение только правил, значение параметра Identity которых начинается со строкового значения "WebServer:atl-cs-001.litwareinc.com". (По умолчанию это все правила обновления устройств, назначенные службе WebServer:atl-cs-001.litwareinc.com.) Эта отфильтрованная коллекция затем передается командлету Restore-CsDeviceUpdateRule , который восстанавливает каждое правило в коллекции.

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

В примере 3 показывается, как можно восстановить все правила обновления устройств для конкретной марки (LG-Nortel). Чтобы выполнить это, команда сначала вызывает командлет Get-CsDeviceUpdateRule без указания параметров, чтобы извлечь коллекцию всех правил обновления устройств, используемых в настоящее время в организации. Эта коллекция затем передается командлету Where-Object , отбирающему из нее только те правила, свойство Brand которых имеет значение LG-Nortel. Отфильтрованная коллекция затем передается командлету Restore-CsDeviceUpdateRule , который восстанавливает все правила в этой отфильтрованной коллекции.

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

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

Каждое новое правило обновления устройства, добавляемое в систему, помечается как "Pending" (ожидающее). Это означает, что данное обновление будет загружено и установлено на соответствующие устройства; однако оно не будет загружено и установлено на все клиентские устройства. Благодаря этому предоставляется возможность для тестирования соответствующих обновлений, а также обеспечивается, что не будет произведено какого-либо нежелательного воздействия на систему до того, как данное обновление станет широкодоступным. Только после того, как администратор убедится, что обновление успешно прошло тестирование и является полезным для организации, он может воспользоваться командлетом Approve-CsDeviceUpdateRule для утверждения данного обновления.

После того, как утверждение обновления будет выполнено, для свойства PendingVersion соответствующего правила обновления назначается значение ApprovedVersion, и свойство PendingVersion очищается. Например, предположим, что версией PendingVersion нового правила обновления является 1.0.0.1. После выполнения командлета Approve-CsDeviceUpdateRule для свойства PendingVersion будет установлено нулевое значение, а для свойства ApprovedVersion – значение 1.0.0.1. Когда клиентское устройство очередной раз выполнит проверку обновлений, данное обновление будет автоматически загружено и установлено.

Кроме того, любая предыдущая версия данного обновления (например, версия 1.0.0.0) будет помечена как RestoreVersion. Эта версия обновления останется в системе и будет использована, если новое обновление потребуется откатить. В случае неожиданного выявления каких-либо проблем администраторы могут воспользоваться командлетом Restore-CsDeviceUpdateRule для отката данного обновления. Когда это произойдет, клиентское устройство при следующей проверке наличия обновлений автоматически удалит новое обновление (версии 1.0.0.1) и повторно установит предыдущее обновление (1.0.0.0).

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

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

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

 

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

Confirm

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

Запрещает на время выполнения команды отображение каких-либо сообщений о некритических ошибках.

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

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

Instance

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

DeviceUpdate.Rule object

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

Объект Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule. Командлет Restore-CsDeviceUpdateRule принимает потоковые экземпляры объекта правила обновления устройства.

Нет. Вместо этого командлет Restore-CsDeviceUpdateRule восстанавливает экземпляры объекта Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule.

 
Показ: