Compartir a través de

  • Artículo

Restore-CsDeviceUpdateRule

 

Última modificación del tema: 2012-03-27

Permite "revertir" una regla de actualización de dispositivo que se aprobó para ser usada en la organización. Al restaurar una regla de actualización de dispositivo, la versión aprobada de esa regla se restablece para reflejar la actualización que estaba en uso antes de que se aprobara la regla. A su vez, los dispositivos de cliente que inician sesión en el sistema desinstalarán de manera automática la actualización más reciente; y, a continuación, descargarán y reinstalarán la versión anterior de esa actualización.

Sintaxis

Restore-CsDeviceUpdateRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Restore-CsDeviceUpdateRule [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Microsoft Lync Server 2010 usa reglas de actualización de dispositivos como una manera de brindarles actualizaciones de firmware a dispositivos que ejecutan Lync 2010 Phone Edition. De manera periódica, los administradores cargan un conjunto de reglas de actualización de dispositivos a Lync Server 2010; una vez que dichas reglas fueron evaluadas y aprobadas, se las descarga automáticamente y se las aplica a los dispositivos correspondientes a medida que éstos se conectan al sistema. De forma predeterminada, los dispositivos buscan nuevas reglas de actualización cada vez que se encienden y se conectan a Lync Server; asimismo, buscan actualizaciones cada 24 horas, a partir del inicio de sesión inicial.

Cada nueva regla de actualización de dispositivo que se agrega al sistema se marca como "Pendiente". Eso significa que la actualización se descargará e instalará en los dispositivos de prueba correspondientes, pero no se descargará ni instalará en los dispositivos de cliente en general. Esto le brinda la oportunidad de probar las actualizaciones y asegurarse de que no existan efectos adversos, antes de que la actualización esté disponible de manera general. Después de tener la seguridad de que la actualización ha pasado las pruebas y de que funcionará en su organización, puede usar Approve-CsDeviceUpdateRule para aprobar la actualización.

Cuando se aprueba una actualización, PendingVersion de la regla de actualización asociada se asigna a ApprovedVersion y se desactiva la propiedad ApprovedVersion. Por ejemplo, suponga que PendingVersion de una regla de actualización nueva es versión 1.0.0.1. Después de ejecutar Approve-CsDeviceUpdateRule, la propiedad PendingVersion se configurará con un valor nulo y ApprovedVersion se configurará como 1.0.0.1. La próxima vez que un dispositivo de cliente busque actualizaciones, la actualización se descargará e instalará de manera automática.

Además de esto, cualquier versión anterior de la actualización (por ejemplo, la versión 1.0.0.0.) se marcará como RestoreVersion. Esta versión de la actualización permanecerá en el sistema y se usará cuando se deba revertir la actualización nueva. Si comienzan a surgir problemas, los administradores pueden usar el cmdlet Restore-CsDeviceUpdateRule para revertir la actualización. Cuando sucede eso, la próxima vez que un dispositivo de cliente busque actualizaciones, éste desinstalará automáticamente la nueva actualización (versión 1.0.0.1) y volverá a instalar la actualización anterior (1.0.0.0).

Tenga en cuenta que esto sucede solamente si hay una actualización anterior para instalar. Si no es el caso, la actualización que se está revirtiendo simplemente se desinstalará.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Restore-CsDeviceUpdateRule localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Cadena de caracteres

Identificador único de la regla de actualización de dispositivo que se está restaurando. El parámetro Identity de una regla de actualización de dispositivo está formado por dos partes: el servicio al que se ha asignado la regla de actualización de dispositivos (por ejemplo, service:WebServer:atl-cs-001.litwareinc.com) y un identificador único global (GUID). Por consiguiente, una regla de actualización de dispositivo configurada para el sitio Redmond tendrá un parámetro Identity similar a: service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9.

Instance

Opcional

Objeto DeviceUpdate.Rule

Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan producirse al ejecutar el comando.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule. Restore-CsDeviceUpdateRule acepta instancias canalizadas del objeto de regla de actualización de dispositivos.

Tipos de valores devueltos

Ninguno. En cambio, Restore-CsDeviceUpdateRule restaura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

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

El comando que se muestra en el Ejemplo 1 restaura la regla de actualización de dispositivo d5ce3c10-2588-420a-82ac-dc2d9b1222ff9 que se encuentra en el servicio WebServer:atl-cs-001.litwareinc.com.

-------------------------- Ejemplo 2 --------------------------

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

El comando anterior restaura todas las reglas de actualización de dispositivo configuradas para el servicio WebServer:atl-cs-001.litwareinc.com. Para llevar a cabo esta acción, el comando primero llama a Get-CsDeviceUpdateRule junto con el parámetro Filter; el valor de filtro "WebServer:atl-cs-001.litwareinc.com*" asegura que sólo se recuperarán las reglas cuyo parámetro Identity comienza con el valor de cadena "WebServer:atl-cs-001.litwareinc.com". (Por definición, estas son todas las reglas de actualización de dispositivo asignadas al servicio WebServer:atl-cs-001.litwareinc.com). La recopilación filtrada se redirecciona al cmdlet Restore-CsDeviceUpdateRule, el cual restaura cada regla de la recopilación.

-------------------------- Ejemplo 3 --------------------------

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

En el Ejemplo 3 se muestra cómo puede restaurar todas las reglas de actualización de dispositivo para una marca específica (LG-Nortel). Para ello, el comando primero llama a Get-CsDeviceUpdateRule sin ningún parámetro adicional, a fin de devolver una recopilación de todas las reglas de actualización de dispositivos que se encuentran actualmente en uso en la organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que sólo selecciona las reglas cuya propiedad Brand sea igual a LG-Nortel. Esta recopilación filtrada se redirecciona a Restore-CsDeviceUpdateRule, el cual restaura cada regla de la recopilación filtrada.