Compartir a través de

  • Artículo

Get-CsDeviceUpdateRule

 

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

Devuelve información acerca de las reglas de actualización de dispositivos configuradas para usarlas en la organización. Las reglas de actualización de dispositivos sirven para asociar actualizaciones de firmware con los dispositivos que ejecutan Microsoft Lync 2010 Phone Edition.

Sintaxis

Get-CsDeviceUpdateRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsDeviceUpdateRule [-Filter <String>] [-LocalStore <SwitchParameter>]

Descripción detallada

Microsoft Lync Server 2010 usa reglas de actualización de dispositivos como una forma de 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 forma predeterminada, los dispositivos buscan nuevas reglas de actualización cada vez que se encienden o se conectan a Lync Server. También buscarán actualizaciones cada 24 horas tras la primera conexión.

Las reglas de actualización de dispositivos se pueden importar al servicio Servicios web y aplicar a éste. El cmdlet Get-CsDeviceUpdateRule permite devolver información acerca de las reglas de actualización de dispositivos que se han importado para usarlas en la organización.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsDeviceUpdateRule localmente: RTCUniversalUserAdmins, 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 "Get-CsDeviceUpdateRule"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único para la regla de actualización de dispositivos. La Identidad de una regla de actualización de dispositivos está compuesta por dos partes: el ámbito de servicio donde se ha aplicado la regla (por ejemplo, service:WebServer:atl-cs-001.litwareinc.com) y el GUID (identificador único global) que se asignó previamente a la regla (por ejemplo, d5ce3c10-2588-420a-82ac-dc2d9b1222ff9). De acuerdo con ello, la Identidad de una determinada regla de actualización de dispositivos tendrá un aspecto similar al siguiente: "service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9 ".

No se permiten comodines cuando se especifica una identidad. Use el parámetro Filter si desea usar caracteres comodín al especificar una regla.

Filter

Opcional

Cadena de caracteres

Permite usar caracteres comodín al especificar la Identidad de una regla de actualización de dispositivos o un conjunto de ellas. Por ejemplo, para devolver todas las reglas de actualización de los dispositivos para WebServer:atl-cs-001.litwareinc.com, use este valor de filtro: "service:WebServer:atl-cs-001.litwareinc.com*".

LocalStore

Opcional

Parámetro modificador

Recupera los datos de regla de actualización de dispositivos a partir de una réplica local de Almacén de administración central en lugar de hacerlo directamente desde Almacén de administración central.

Tipos de entrada

Ninguno. Get-CsDeviceUpdateRule no acepta entradas transferidas.

Tipos de valores devueltos

Get-CsDeviceUpdateRule devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule.

Ejemplo

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

Get-CsDeviceUpdateRule

El comando anterior devuelve información acerca de todas las reglas de actualización de dispositivos que se han aplicado en la organización. La llamada a Get-CsDeviceUpdateRule sin ningún parámetro adicional devuelve siempre la colección completa de reglas de actualización de dispositivos.

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

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

El comando que aparece en el Ejemplo 2 devuelve información acerca de la regla de actualización de dispositivos con Identity "WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9".

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

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

En el Ejemplo 3 se devuelve información acerca de todas las reglas de actualización de dispositivos configuradas para el servicio WebServer:atl-cs-001.litwareinc.com. Para ello, se usa el parámetro Filter junto con el valor de filtro "WebServer:atl-cs-001.litwareinc.com *". Este filtro limita los datos devueltos para reglas de actualización de dispositivos cuya Identity comienza por el valor de cadena "service:WebServer:atl-cs-001.litwareinc.com".

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

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

El comando anterior devuelve todas las reglas de actualización de dispositivos en las que la propiedad Brand es igual a "LG-Nortel". Para ello, se llama a Get-CsDeviceUpdateRule para devolver una colección de todas las reglas de actualización de los dispositivos de la organización. Esta colección se transfiere a continuación al cmdlet Where-Object, que selecciona solo aquellas reglas en las que Brand es igual a "LG-Nortel".

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

Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -eq $Null}

En el Ejemplo 5 se devuelve una colección de todas las reglas de actualización de dispositivos que no se han aprobado. Esto se hace mediante usando Get-CsDeviceUpdateRules para devolver una colección de todas las reglas y, a continuación, transferirla a Where-Object. A su vez, Where-Object selecciona solo las reglas en las que la propiedad Approved es igual a un valor nulo. Si la propiedad Approved es nula, significa que estas reglas no están aprobadas.

-------------------------- Ejemplo 6 ------------------------

Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -ne $Null -and $_.Brand -eq "LG-Nortel"}

El comando anterior devuelve una colección de todas las reglas de actualización de dispositivos que cumplen dos criterios: la regla está aprobada y hace referencia a dispositivos de LG-Nortel. Para lograrlo, se llama primero a Get-CsDeviceUpdateRule para devolver una colección de todas las reglas de actualización de dispositivos de la organización. A continuación, esta colección se transfiere a Where-Object, que filtra la colección en función de dos criterios: la propiedad Approved no debe ser nula (es decir, debe tener un valor de cualquier clase) y Brand debe ser igual a "LG-Nortel".