Compartir a través de

  • Artículo

Reset-CsDeviceUpdateRule

 

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

Rechaza una regla de actualización de dispositivo importada al sistema.

Sintaxis

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

Reset-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. Periódicamente, los administradores actualizan un nuevo conjunto de reglas de actualización de dispositivos para Lync Server 2010. Después de la prueba y la aprobación de esas reglas, éstas se descargan automáticamente y se aplican a los dispositivos correspondientes a medida que se conectan los dispositivos al sistema. De manera predeterminada, los dispositivos comprueban las reglas cada vez que se encienden y se conectan a Lync Server. Asimismo, los dispositivos comprueban la presencia de actualizaciones cada 24 horas después 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 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.

Por otro lado, es posible que los administradores concluyan que una actualización determinada no debe usarse en la organización (por ejemplo, si la actualización podría entrar en conflicto con el software interno). En ese caso, los administradores pueden usar el cmdlet Reset-CsDeviceUpdateRule para rechazar la actualización. Cuando ello ocurre, el parámetro PendingVersion de la regla de actualización se define en un valor nulo. A su vez, eso significa que los dispositivos de prueba que inicien sesión en el sistema desinstalarán la actualización y volverán a instalar la versión aprobada de ésta. Y, debido a que nunca se aprobó la actualización, ésta nunca será instalada por otro dispositivo excepto el de prueba. Como resultado, no afectará la población de usuarios en general.

El cmdlet Reset-CsDeviceUpdateRule solamente puede usarse con reglas de actualización de dispositivos en estado Pendiente. Si una regla ya fue aprobada, necesitará usar el cmdlet Restore-CsDeviceUpdateRule para revertir la implementación de la actualización del dispositivo.

Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Reset-CsDeviceUpdateRule en forma local: 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 "Reset-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á restableciendo. 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-oo1.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9".

Instance

Opcional

Regla de actualización de dispositivos

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

Force

Opcional

Parámetro modificador

Suprime cualquier aviso de confirmación o mensaje de error leve que se pueda producir al ejecutar el cmdlet.

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. Reset-CsDeviceUpdateRule acepta instancias canalizadas del objeto de regla de actualización de dispositivos.

Tipos de valores devueltos

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

Ejemplo

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

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

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

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

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

El comando anterior restablece todas las reglas de actualización de dispositivo configuradas para el servicio WebServer:atl-cs-001.litwareinc.com. Esto es llevado a cabo llamando, en primer lugar, a Get-CsDeviceUpdateRule junto con el parámetro –Filter; el valor de filtro "WebServer:atl-cs-001.litwareinc.com*" asegura que se recuperen únicamente las reglas cuyo parámetro Identity comienza con los caracteres "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). Luego, la recopilación filtrada se canaliza al cmdlet Reset-CsDeviceUpdateRule, el cual restablece cada regla de la recopilación.

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

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

El comando que se muestra en el Ejemplo 3 restablece todas las reglas de actualización de dispositivo de la marca 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. Después, la recopilación filtrada se canaliza al cmdlet Reset-CsDeviceUpdateRule, el cual procede a restablecer todas las reglas de dicha recopilación.