Get-CsTestDevice
Última modificación del tema: 2012-03-23
Recupera información acerca de los dispositivos de prueba de administración de actualización de dispositivos que se configuraron para usar en la organización. Los dispositivos de prueba ofrecen un modo para que los administradores prueben las actualizaciones de firmware antes de que las actualizaciones se distribuyan a todos los dispositivos de la organización.
Sintaxis
Get-CsTestDevice [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsTestDevice [-Filter <String>] [-LocalStore <SwitchParameter>]
Descripción detallada
La identificación de teléfonos específicos compatibles con Microsoft Lync 2010 Phone Edition u otros dispositivos de prueba permite a los administradores comprobar y aprobar actualizaciones de firmware antes de implementarlas en todos los dispositivos pertinentes de la organización. Cuando se importan reglas de actualización de dispositivos a Microsoft Lync Server 2010, dichas reglas se marcan como "pendiente", lo que significa que las actualizaciones correspondientes no se descargarán ni se instalarán automáticamente en los dispositivos afectados.
En cambio, las reglas pendientes serán descargadas e instaladas por los dispositivos de prueba relevantes. Ésta es la finalidad de los dispositivos de prueba: las nuevas reglas de actualización de dispositivos se aplican automáticamente a los dispositivos de prueba, lo cual les permite a los administradores comprobar que las actualizaciones de firmware funcionen como se espera. Si lo hacen, esos administradores entonces pueden marcar las reglas como aprobadas. Luego, los dispositivos relevantes en la organización descargan e instalan las reglas aprobadas.
Los dispositivos de prueba se pueden asignar al ámbito global o del sitio. Puede usar el cmdlet Get-CsTestDevice para recuperar información sobre los dispositivos de prueba configurados actualmente para su uso en la organización.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsTestDevice localmente: RTCUniversalUserAdmins, 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 "Get-CsTestDevice"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Indica la Identity del dispositivo de prueba que se devolverá. Para hacer referencia a un dispositivo individual denominado UCPhone (almacenado en la recopilación global), use esta sintaxis: -Identity global/UCPhone. Para hacer referencia a un dispositivo encontrado en una recopilación del sitio, use una sintaxis similar a esta: -Identity site:Redmond/UCPhone. Para hacer referencia a una recopilación completa, deje el nombre del dispositivo. Por ejemplo, esta sintaxis devuelve todos los dispositivos de prueba configurados para Redmond site: -Identity site:Redmond. Tenga en cuenta que no es posible usar comodines al especificar un parámetro Identity. |
Filter |
Opcional |
Cadena de caracteres |
Ofrece un modo para que use caracteres comodín cuando especifica el dispositivo de prueba (o los dispositivos) que se van a devolver. Por ejemplo, para devolver todas las recopilaciones de dispositivos de prueba que se configuraron en el ámbito del sitio, use esta sintaxis: -Filter "site:*". Para devolver todos los dispositivos con el término "EMEA" en el parámetro Identity, use esta sintaxis: -Filter "*EMEA*". Observe que Filter actúa solamente en el parámetro Identity de la recopilación de dispositivos de prueba; no puede filtrar otras propiedades de recopilación. |
LocalStore |
Opcional |
Parámetro modificador |
Recupera los datos de dispositivos de prueba de la réplica local de Almacén de administración central, en lugar de Almacén de administración central. |
Tipos de entrada
Ninguno. Get-CsTestDevice no acepta entradas canalizadas.
Tipos de valores devueltos
Get-CsTestDevice devuelve una o más instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsTestDevice
El Ejemplo 1 devuelve todos los dispositivos de prueba de la organización. Por medio del llamado de Get-CsTestDevice sin parámetros adicionales, se devolverán todos los dispositivos de prueba que están en uso actualmente.
-------------------------- Ejemplo 2 --------------------------
Get-CsTestDevice -Identity site:Redmond/UCPhone
El ejemplo anterior devuelve el dispositivo de prueba denominado UCPhone que se asignó a Redmond site.
-------------------------- Ejemplo 3 --------------------------
Get-CsTestDevice -Identity site:Redmond
En el Ejemplo 3, el comando devuelve todos los dispositivos de prueba configurados para Redmond site.
-------------------------- Ejemplo 4 --------------------------
Get-CsTestDevice -Filter site:*
El comando anterior devuelve todos los dispositivos de prueba que se configuraron en el ámbito del sitio. Para llevar a cabo esta acción, el comando usa el parámetro Filter; el valor de filtro "site:*" limita los datos devueltos a los dispositivos de prueba que tienen un parámetro Identity que comienza con el valor de cadena "site:".