Compartir a través de


Approve-CsDeviceUpdateRule

 

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

Aprueba una regla de actualización de dispositivos que se importa al sistema. Tras la aprobación de una regla de actualización de dispositivos, los dispositivos cliente afectados por la actualización descargan e instalan automáticamente la actualización correspondiente.

Sintaxis

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

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

Descripción detallada

Microsoft Lync Server 2010 usa las reglas de actualización de dispositivos para proporcionar actualizaciones de firmware a los dispositivos que ejecutan Lync 2010 Phone Edition. Los administradores cargan un conjunto de reglas de actualización de dispositivos en Lync Server 2010 de manera periódica; una vez comprobadas y aprobadas las reglas, se descargan y aplican automáticamente en los dispositivos correspondientes cuando se conectan al sistema. De manera predeterminada, los dispositivos comprueban si existen nuevas reglas de actualización cada vez que se activan y se conectan a Lync Server 2010. Aparte de eso, los dispositivos vuelven a comprobar si hay actualizaciones cada 24 horas después de ese primer inicio de sesión.

Cada regla de actualización de dispositivos nueva que se agrega al sistema se marca como "Pendiente". Esto significa que los dispositivos de prueba adecuados descargarán e instalarán la actualización; no obstante, los dispositivos cliente generales no lo harán. De este modo, es posible probar las actualizaciones y asegurarse de que no se producen efectos adversos antes de poner a disposición la actualización de forma general. Cuando esté convencido de que la actualización ha superado todas sus pruebas y que funcionará en su organización, podrá utilizar Approve-CsDeviceUpdateRule para aprobar la actualización.

Cuando se aprueba una actualización, la propiedad PendingVersion de la regla de actualización asociada se asigna a ApprovedVersion, y se borra la propiedad PendingVersion. Por ejemplo, supongamos que la propiedad PendingVersion de una nueva regla de actualización es la versión 1.0.0.1. Después de ejecutar Approve-CsDeviceUpdateRule, la propiedad PendingVersion se configurará con un valor null y ApprovedVersion se configurará como 1.0.0.1. La próxima vez que un dispositivo cliente inicie sesión, comprobará automáticamente si se han aprobado actualizaciones que se le apliquen. De ser así, la actualización se descargará e instalará automáticamente.

Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Approve-CsDeviceUpdateRule: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Cadena de caracteres

Identificador único de la regla de actualización de dispositivos que se va a aprobar. La identidad de una regla de actualización de dispositivos consta de 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 dispositivos configurada para el sitio de Redmond tendrá una identidad similar a la siguiente: 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 ocurrir 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. Approve-CsDeviceUpdateRule acepta las instancias transferidas del objeto de regla de actualización de dispositivos.

Tipos de valores devueltos

Ninguno. En su lugar, Approve-CsDeviceUpdateRule aprueba instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule.

Ejemplo

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

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

El comando del Ejemplo 1 aprueba la regla de actualización de dispositivos 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* | Approve-CsDeviceUpdateRule

El comando anterior aprueba todas las reglas de actualización de dispositivos que se han configurado para el servicio WebServer:atl-cs-001.litwareinc.com. Para realizar esto, el comando primero llama a Get-CsDeviceUpdateRule junto con el parámetro Filter; el valor de filtro "service:WebServer:atl-cs-001.litwareinc.com*" garantiza que solo se recuperarán las reglas cuyo parámetro Identity comience con el valor de cadena "service:WebServer:atl-cs-001.litwareinc.com". (Por definición, son todas las reglas de actualización de dispositivos que se hayan asignado al servicio WebServer:atl-cs-001.litwareinc.com). A continuación, esta colección filtrada se transfiere al cmdlet Approve-CsDeviceUpdateRule, que aprueba cada una de las reglas de la colección.

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

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

El comando del Ejemplo 3 aprueba todas las reglas de actualización de dispositivos de la marca especificada (LG-Nortel). Para ello, el comando primero llama a Get-CsDeviceUpdateRule para devolver una colección de todas las reglas de actualización de dispositivos que están en uso en la organización. A continuación, esta colección se transfiere al cmdlet Where-Object, que solo selecciona las reglas cuya propiedad Brand sea igual a LG-Nortel. A continuación, esta colección filtrada se transfiere a Approve-CsDeviceUpdateRule, que aprueba cada una de las reglas de la colección.