Compartir a través de

  • Artículo

Set-CsDeviceUpdateConfiguration

 

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

Modifica una recopilación de opciones de configuración de Servicio web de actualización de dispositivos. Estas configuraciones se usan para administrar el Servicio web de actualización de dispositivos, un componente de Microsoft Lync Server 2010 que permite que los administradores distribuyan actualizaciones de firmware a teléfonos y otros dispositivos que ejecutan Microsoft Lync 2010 Phone Edition.

Sintaxis

Set-CsDeviceUpdateConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-LogCleanUpInterval <TimeSpan>] [-LogCleanUpTimeOfDay <Nullable>] [-LogFlushInterval <TimeSpan>] [-MaxLogCacheLimit <UInt32>] [-MaxLogFileSize <UInt32>] [-ValidLogFileExtensions <PSListModifier>] [-ValidLogFileTypes <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsDeviceUpdateConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LogCleanUpInterval <TimeSpan>] [-LogCleanUpTimeOfDay <Nullable>] [-LogFlushInterval <TimeSpan>] [-MaxLogCacheLimit <UInt32>] [-MaxLogFileSize <UInt32>] [-ValidLogFileExtensions <PSListModifier>] [-ValidLogFileTypes <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

El Servicio web de actualización de dispositivos ofrece a los administradores la posibilidad de distribuir actualizaciones de firmware a dispositivos que se ejecutan con Microsoft Lync 2010 Phone Edition. Periódicamente, los administradores actualizan un nuevo conjunto de reglas de actualización de dispositivos para Microsoft Lync Server 2010. Después de que dichas reglas se corroboran y aprueban, pueden aplicarse a los dispositivos correspondientes a medida que dichos dispositivos se conectan al sistema. Los dispositivos comprueban si existen actualizaciones cuando se los enciende por primera vez y, a continuación, comprueban nuevamente cuando el usuario inicia sesión. A partir de eso, los dispositivos buscarán actualizaciones cada 24 horas.

La configuración de actualización de dispositivos puede aplicarse en el ámbito global o en el ámbito de sitio. El cmdlet Set-CsDeviceUpdateConfiguration le permite implementar modificaciones en una recopilación de configuraciones. Por ejemplo, puede usar este cmdlet para modificar la cantidad de tiempo que se conserva un archivo de registro antes de que el sistema lo elimine automáticamente.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único para las opciones de configuración de actualización de dispositivos que se modificarán. Para hacer referencia a la configuración global, use la siguiente sintaxis: -Identity global. Para hacer referencia a la configuración del sitio, use una sintaxis similar a esta: -Identity "site:Redmond". Tenga en cuenta que no es posible usar comodines al especificar un parámetro Identity.

Instance

Opcional

Objeto DeviceUpdateSettings

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

LogCleanUpInterval

Opcional

Timespan

Especifica la cantidad de tiempo que se almacena un archivo de registro de actualización de dispositivo antes de que el sistema lo elimine.

El valor debe escribirse en el formato dd.hh:mm:ss, donde "dd" es día, "hh" es hora, "mm" es minuto y "ss" es segundo. Para escribir únicamente los días, el valor debe estar seguido de un punto (.).

Valor mínimo: 1.00:00:00 (1 día)

Valor máximo: 365.00:00:00 (1 año)

Valor predeterminado: 10.00:00:00 (10 días)

LogCleanUpTimeOfDay

Opcional

DateTime

Indica el momento del día en que el sistema verifica si hay algún archivo de registro expirado que debe eliminarse. (Los archivos de registro expirados son todos los archivos que sean más antiguos que el valor especificado por la propiedad LogCleanupInterval).

El valor pasado al parámetro LogCleanupTimeOfDay debe estar en el formato de 24 horas hh:mm, donde "hh" representa las horas y "mm" representa los minutos. En este formato, la medianoche se representa como 00:00; 08:30 a. m. se representa como 08:30 y 11:52 p. m. se representa como 23:52.

LogFlushInterval

Opcional

TimeSpan

Indica la frecuencia con que la información almacenada en la memoria caché del archivo de registro es escrita en el archivo de registro. De manera predeterminada, la información de actualización de dispositivos no se escribe inmediatamente en el archivo de registro; en cambio, dicha información se almacena en la memoria caché hasta que: 1) haya expirado el intervalo de tiempo de ingreso de registro; o 2) la memoria caché haya alcanzado su tamaño máximo. Si este valor se establece en 10 minutos (00:10:00), la información en la memoria caché se escribirá en el archivo de registro cada 10 minutos. Una vez que los datos se hayan registrado, la memoria caché se borrará.

El valor debe escribirse en el formato hh:mm:ss, donde "hh" es hora, "mm" es minuto y "ss" es segundo.

Valor mínimo: 00:01:00 (1 minuto)

Valor máximo: 1:00:00 (1 hora)

Valor predeterminado: 00:05:00

MaxLogCacheLimit

Opcional

Integer

Indica la cantidad máxima de información (en bytes) que se puede almacenar en la memoria caché del archivo de registro antes de que deba borrarse esa memoria caché y que los datos deban escribirse en un archivo de registro. De forma predeterminada, los archivos de registro se "vacían" cada cinco minutos. (Para obtener más información detallada, consulte la descripción del parámetro LogFlushInterval). Sin embargo, si la memoria caché alcanza su tamaño máximo, la información contenida en esta se escribirá automáticamente en un archivo de registro (y la memoria caché se borrará), incluso si el intervalo de vaciado del registro no ha expirado aún.

Valor predeterminado: 512000

MaxLogFileSize

Opcional

Integer

Indica el tamaño máximo, en bytes, para un archivo de registro individual. Cuando un archivo alcanza el tamaño máximo, el siguiente lote de datos se escribe automáticamente en un nuevo archivo de registro. El archivo de registro antiguo se conservará hasta que haya expirado el intervalo de limpieza de registro.

Valor predeterminado: 1024000

ValidLogFileExtensions

Opcional

Modificador de lista PS

Indica las extensiones de archivo de registro válidas que se pueden usar con el servicio web de actualización de dispositivos. Esta lista se puede modificar. Sin embargo, no hay motivo para modificar la lista a menos que usted cuente con un dispositivo compatible con Lync 2010 Phone Edition que crea archivos de registro que usan una extensión de archivo diferente.

Valor predeterminado: .dmp, .clg, .clg2, .bak, .kdmp, .dat, .bin, .cat, .xml, .txt, .hex

ValidLogFileTypes

Opcional

Modificador de lista PS

Indica los tipos de archivo de registro retenidos por el sistema de actualización de dispositivo. Los tipos de archivo predeterminados incluyen los siguientes:

Watson. Archivos de registro generados automáticamente por un dispositivo en caso de bloqueo del sistema.

Config. Perfiles de Dispositivo para conferencias Microsoft RoundTable que se crean cada vez que se configura Dispositivo RoundTable.

DiagLog. Datos de autodiagnóstico para Dispositivos RoundTable.

CELog. Registros de teléfonos de Lync 2010, que contienen los resultados de pruebas funcionales y un registro de eventos críticos del sistema.

Los tipos de archivo adicionales pueden agregarse si tiene un dispositivo compatible con Lync 2010 Phone Edition que crea un tipo de archivo de registro diferente. También puede quitar los archivos. Por ejemplo, si no desea almacenar archivos CELog, puede quitar el tipo de archivo CELog.

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.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

WhatIf

Opcional

Parámetro modificador

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

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration. Set-CsDeviceUpdateConfiguration acepta instancias canalizadas del objeto de configuración de la actualización de dispositivos.

Tipos de valores devueltos

Set-CsDeviceUpdateConfiguration no devuelve valores ni objetos. En cambio, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration.

Ejemplo

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

Set-CsDeviceUpdateConfiguration -Identity global -MaxLogFileSize 2048000 -MaxLogCacheLimit 1024000

En el Ejemplo 1, se muestra cómo se puede usar Set-CsDeviceUpdateConfiguration para modificar opciones de configuración globales. En este caso, se modifican dos valores de propiedad: la propiedad MaxLogFileSize se establece en 2048000 bytes y la propiedad MaxLogCacheLimit se establece en 1024000 bytes.

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

Set-CsDeviceUpdateConfiguration -Identity site:Redmond -LogFlushInterval 00:02:00

El comando anterior modifica la propiedad LogFlushInterval para las opciones de configuración de actualización de dispositivos con Identity site:Redmond. Para llevar a cabo esta acción, el parámetro Identity se usa para especificar las configuraciones en el sitio Redmond y el parámetro LogFlushInterval se usa para indicar el valor de propiedad que se debe modificar. En este caso, LogFlushInterval se establece en 2 minutos (00 horas: 02 minutos: 00 segundos).

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

Get-CsDeviceUpdateConfiguration | Set-CsDeviceUpdateConfiguration -LogCleanUpInterval 14.00:00:00

En el ejemplo 3, se modifican todas las opciones de actualización de configuración de dispositivos en la organización para establecer LogCleanUpInterval en 14 días. Para llevar a cabo esta acción, primero se usa Get-CsDeviceUpdateConfiguration para recuperar una recopilación de todas las opciones de configuración de actualización de dispositivos que se encuentran actualmente en uso. Esta recopilación se redirecciona a Set-CsDeviceUpdateConfiguration, que usa el parámetro LogCleanUpInterval para establecer el tiempo de intervalo de limpieza de registro para cada elemento de la recopilación en 14 días (14 días . 00 horas: 00 minutos: 00 segundos).

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

Get-CsDeviceUpdateConfiguration -Filter "site:*" | Set-CsDeviceUpdateConfiguration -LogCleanUpInterval 20.00:00:00

En el Ejemplo 4, se demuestra de qué manera se puede modificar un valor de propiedad para todas las opciones de configuración de actualización de dispositivos que se configuraron en el ámbito del sitio; en este caso, el comando establece LogCleanUpInterval en 20 días (20 días . 00 horas: 00 minutos: 00 segundos). Para llevar a cabo esta acción, el cmdlet Get-CsDeviceUpdateConfiguration se usa junto con el parámetro Filter; el valor de filtro "site:*" limita los datos devueltos que tienen un parámetro Identity que comienza con el valor de cadena "site:". Luego, esta recopilación filtrada se redirecciona a Set-CsDeviceUpdateConfiguration, que cambia el valor del intervalo de limpieza de registro para cada elemento de la recopilación.

-------------------------- Ejemplo 5 --------------------------

Get-CsDeviceUpdateConfiguration | Set-CsDeviceUpdateConfiguration -ValidLogFileTypes @{Remove="CELog"}

El comando anterior quita CELog de la lista de tipos de archivos de registro válidos usados por las opciones de configuración de actualización de dispositivos. En este comando, primero se usa Get-CsDeviceUpdateConfiguration para recuperar una recopilación de todas las opciones de configuración de actualización de dispositivos que se usan actualmente en la organización. Esa recopilación se redirecciona a Set-CsDeviceUpdateConfiguration, que usa el parámetro ValidLogFileTypes para quitar CELog de la lista de tipos de archivos de registro válidos. El valor de parámetro transferido a ValidLogFileTypes, @{Remove="CELog"}, ordena a Set-CsDeviceUpdateConfiguration que quite a CELog del conjunto de tipos de archivos válidos. Para quitar varios tipos de archivos en un comando único, sencillamente, incluya los tipos adicionales como parte de la lista separada por comas. Por ejemplo:

@{Remove="CELog","Watson"}