Compartir a través de

  • Artículo

New-CsDeviceUpdateConfiguration

 

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

Crea una nueva instancia de configuraciones de actualización de dispositivo. 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

New-CsDeviceUpdateConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 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 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 continuación, los dispositivos comprueban si existen actualizaciones cada 24 horas.

Las opciones de configuración de actualización de dispositivos, que se usan para administrar el Servicio web de actualización de dispositivos, se pueden asignar a nivel global o al ámbito del sitio. A fin de crear una nueva recopilación de configuraciones para un sitio, use el cmdlet New-CsDeviceUpdateConfiguration. Tenga en cuenta que solo puede crear configuraciones nuevas en el ámbito del sitio; el comando provocará un error si intenta crear una nueva recopilación de configuraciones en el ámbito global. Además, el comando producirá un error si intenta crear una nueva recopilación de configuraciones para, por ejemplo, el sitio Redmond, y ese sitio ya hospeda una recopilación de configuraciones de actualización de dispositivo. Eso se debe a que solamente puede tener una recopilación de configuraciones de actualización de dispositivo por sitio.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Indica la identidad de las nuevas configuraciones de actualización de dispositivo. Debido a que las nuevas configuraciones sólo se pueden crear en el ámbito del sitio, la identidad debe ser similar a esto: -Identity "site:Redmond".

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 ese formato, la media noche se representa como 00:00; 8:30 A.M. se representa como 08:30 y 11:52 P.M. se representa como 23:52. El valor predeterminado es nulo.

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

UInt32

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 manera predeterminada, los archivos de registro se "vacían" cada X cantidad de 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

UInt32

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 salvo que usted tenga 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 que se ejecutan con 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 que ejecute Lync 2010 Phone Edition, que cree 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.

InMemory

Opcional

Parámetro modificador

Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - 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

Ninguno. New-CsDeviceUpdateConfiguration no acepta entradas canalizadas.

Tipos de valores devueltos

El cmdlet New-CsDeviceUpdateConfiguration crea instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration.

Ejemplo

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

New-CsDeviceUpdateConfiguration -Identity site:Redmond

El comando que se muestra en el Ejemplo 1 crea una nueva recopilación de configuración de actualización de dispositivo con el valor Identity site:Redmond. Debido a que no se incluyen otros parámetros en el comando, esta nueva recopilación de configuraciones usará los valores predeterminados para cada propiedad.

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

New-CsDeviceUpdateConfiguration -Identity site:Redmond -MaxLogFileSize 204800 -LogCleanUpInterval 7.00:00:00

El comando anterior también crea una nueva recopilación de configuraciones de actualización de dispositivo con el valor Identity site:Redmond. En este caso, se usan dos parámetros adicionales para personalizar las nuevas configuraciones: MaxLogFileSize se usa para establecer el tamaño de archivo de registro máximo en 2048000 bytes, mientras que LogCleanUpInterval se usa para establecer el tiempo de intervalo de limpieza de registro en 7 días (7 días. 00 horas: 00 minutos: 00 segundos).