Compartir a través de

  • Artículo

Remove-CsDeviceUpdateConfiguration

 

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

Quita las opciones de configuración de actualización de dispositivos especificadas. Esta configuración facilita la administración del Servicio web de actualización de dispositivos, un componente de Microsoft Lync Server 2010 que permite a los administradores distribuir actualizaciones de firmware a teléfonos y otros dispositivos con Microsoft Lync 2010 Phone Edition.

Sintaxis

Remove-CsDeviceUpdateConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

El Servicio web de actualización de dispositivos permite a los administradores distribuir actualizaciones de firmware a dispositivos que ejecutan Lync 2010 Phone Edition. Los administradores cargan periódicamente en Lync Server 2010 un conjunto de reglas de actualización de dispositivos. Tras comprobar y aprobar estas reglas, se pueden aplicar a los dispositivos pertinentes a medida que se van conectando al sistema. Los dispositivos buscan actualizaciones tanto al encenderse por primera vez como cuando un usuario inicia sesión. Tras ello, buscarán actualizaciones cada 24 horas.

Lync Server usa opciones de configuración de actualización de dispositivos para administrar el Servicio web de actualización de dispositivos; estas opciones de configuración se pueden aplicar en el ámbito global o en el de sitio. De forma predeterminada, las configuraciones solo se encuentran en el ámbito global; sin embargo, puede usar el cmdlet New-CsDeviceUpdateConfiguration para asignar también configuraciones personalizadas en el ámbito de sitio.

Asimismo, puede utilizar el cmdlet Remove-CsDeviceUpdateConfiguration para eliminar configuraciones asignadas al ámbito de sitio. Al ejecutar este cmdlet en el sitio, se quitan las opciones de configuración de actualización de dispositivos asignadas a ese sitio. También puede ejecutar Remove-CsDeviceUpdateConfiguration en la configuración global. Sin embargo, en este caso, la configuración global no se quita, ya que la configuración de actualización de dispositivos global no se puede quitar. En su lugar, las propiedades globales se restablecerán con los valores predeterminados. Por ejemplo, supongamos que ha modificado la propiedad global MaxLogCacheLimit a 1.024.000 bytes. Si ejecuta Remove-CsDeviceUpdateConfiguration en la configuración global, ésta no se quitará; sin embargo, cualquier propiedad que se haya modificado se restablecerá en sus valores predeterminados. Esto quiere decir que MaxLogCacheLimit se restablecerá en 512.000 bytes.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Remove-CsDeviceUpdateConfiguration localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsDeviceUpdateConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Indica la Identity de las opciones de configuración de actualización de dispositivos que se van a quitar. Para hacer referencia a la configuración global, use la siguiente sintaxis: -Identity global. Para hacer referencia a la configuración de sitios, use la sintaxis del siguiente ejemplo: -Identity site:Redmond. Tenga en cuenta que no se pueden utilizar comodines al especificar una Identidad.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no son graves y que pueden surgir 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.DeviceUpdateConfiguration. Remove-CsDeviceUpdateConfiguration acepta instancias transferidas del objeto de configuración de actualización de dispositivos.

Tipos de valores devueltos

Ninguno. En su lugar, el cmdlet Remove-CsDeviceUpdateConfiguration elimina las instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration.

Ejemplo

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

Remove-CsDeviceUpdateConfiguration -Identity global

En el ejemplo 1, se usa Remove-CsDeviceUpdateConfiguration para "quitar" las opciones de configuración de actualización de dispositivos global. Como la configuración global no se puede quitar, el comando no eliminará realmente nada; sin embargo, todas las propiedades de las opciones de configuración de actualización de dispositivos se restablecerán en sus valores predeterminados.

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

Remove-CsDeviceUpdateConfiguration -Identity site:Redmond

El comando anterior quita las opciones de configuración de actualización de dispositivos con Identity site:Redmond. Como esta configuración se definió en el ámbito de sitio, se eliminará y el sitio Redmond dejará de tener su propio conjunto de opciones de configuración de actualización de dispositivos.

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

Get-CsDeviceUpdateConfiguration -Filter "site:*" | Remove-CsDeviceUpdateConfiguration

En el Ejemplo 3, se quitan todas las opciones de configuración de actualización de dispositivos definidas en el ámbito de sitio. Para ello se usan el cmdlet Get-CsDeviceUpdateConfiguration y el parámetro Filter para devolver todas las opciones de configuración cuya Identity empiece con el valor de cadena "site:". Por definición, éstas serán las opciones de configuración que se definieron en el ámbito de sitio. A continuación, esta colección se transfiere al cmdlet Remove-CsDeviceUpdateConfiguration, que quita todos los elementos de la colección.

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

Get-CsDeviceUpdateConfiguration | Where-Object {$_.MaxLogFileSize -lt 1024000} | Remove-CsDeviceUpdateConfiguration

En el ejemplo 4 se eliminan todas las opciones de configuración de actualización de dispositivos que tienen una propiedad MaxLogFileSize superior a 1024000 bytes. Para ello, en primer lugar se llama a Get-CsDeviceUpdateConfiguration para devolver una colección de todas las opciones de configuración de actualización de dispositivos. A continuación, esta colección se transfiere al cmdlet Where-Object, que solo selecciona aquellas opciones de configuración en las que la propiedad MaxLogFileSize sea mayor que 1024000 bytes. A continuación, la colección filtrada se transfiere a Remove-CsDeviceUpdateConfiguration, que elimina cada uno de los elementos de la colección.