Compartir a través de


Remove-CsDeviceUpdateRule

 

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

Quita una regla de actualización de dispositivo configurada en su organización. Las reglas de actualización de dispositivos se usan para asociar actualizaciones de firmware con dispositivos que ejecutan Microsoft Lync 2010 Phone Edition.

Sintaxis

Remove-CsDeviceUpdateRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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. 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 forma predeterminada, los dispositivos comprueban las nuevas reglas de actualización cada vez que se activan y se conectan a Lync Server. Los dispositivos también buscan posibles actualizaciones cada 24 horas a partir del inicio de sesión inicial.

Los administradores no pueden crear sus propias reglas de actualización de dispositivo. Las reglas de actualización solo pueden crearse descargando e importando los conjuntos de reglas del sitio web de Microsoft. Esto significa que, con el transcurso del tiempo, probablemente recopilará reglas obsoletas o sin utilidad en su organización. (Por ejemplo, si su organización ha dejado de usar teléfonos LG-Nortel, ya no necesita las actualizaciones de firmware para esos dispositivos). Si bien estas reglas innecesarias no crean ningún problema, pueden complicar la administración: puede ser confuso ejecutar el cmdlet Get-CsDeviceUpdateRule para devolver una recopilación de todas sus reglas de actualización de dispositivos, sólo para detectar que gran parte de esas reglas no son aplicables en su organización. Para atenuar esta confusión, Remove-CsDeviceUpdateRule puede usarse para eliminar cualquier regla (o conjunto de reglas) de actualización de dispositivos que se haya importado para su uso.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Remove-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 "Remove-CsDeviceUpdateRule"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único para la regla de actualización de dispositivo. La identidad de una regla de actualización de dispositivo se compone de dos partes: El ámbito de servicio donde se ha aplicado la regla (por ejemplo, service:WebServer:atl-cs-001.litwareinc.com) y el identificador único global (GUID) que se asignó previamente a la regla (por ejemplo, d5ce3c10-2588-420a-82ac-dc2d9b1222ff9). Según esto, la identidad para una regla de actualización de dispositivo determinada será algo así: "service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9".

No se permiten comodines cuando se especifica una identidad.

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

Tipos de valores devueltos

Remove-CsDeviceUpdateRule no devuelve objetos ni valores. En cambio, el cmdlet elimina instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.Rule.

Ejemplo

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

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

El comando anterior elimina la regla de actualización de dispositivo con el valor Identity service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9. Después de que la regla se haya eliminado, la actualización de firmware correspondiente ya no estará disponible para su uso.

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

Get-CsDeviceUpdateRule | Remove-CsDeviceUpdateRule

El comando que se muestra en el Ejemplo 2 quita todas las reglas de actualización de dispositivo que se han configurado en su organización. Esto se lleva a cabo mediante el llamado de Get-CsDeviceUpdateRule (sin ningún parámetro) para devolver una recopilación de todas las reglas de actualización de dispositivos actualmente en uso. Esa recopilación luego se redirecciona a Remove-CsDeviceUpdateRule que, a su vez, elimina cada regla en la recopilación.

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

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

En el Ejemplo 3, se quitan todas las reglas de actualización de dispositivo que se han importado al servicio WebServer:atl-cs-001.litwareinc.com. Para llevar a cabo esta acción, el comando primero usa Get-CsDeviceUpdateRule y el parámetro Filter para recuperar todas las reglas de actualización de dispositivos que tengan un parámetro Identity que comience con el valor de cadena "service:WebServer:atl-cs-001.litwareinc.com ". Esta recopilación se redirecciona a Remove-CsDeviceUpdateRule, que elimina cada regla de la recopilación.

-------------------------- Ejemplo 4 --------------------------

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

El comando anterior elimina todas las reglas de actualización de dispositivos que tienen un valor Brand igual a "LG-Nortel". Para ello, el cmdlet primero llama a Get-CsDeviceUpdateRule sin ningún parámetro adicional, a fin de recuperar 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 selecciona solamente las reglas donde el valor Brand es igual a "LG-Nortel". La recopilación filtrada luego se redirecciona a Remove-CsDeviceUpdateRule, que elimina cada regla de la recopilación.