Remove-CsTestDevice
Última modificación del tema: 2012-03-27
Quita el dispositivo de prueba especificado de administración de actualizaciones de dispositivos. Los dispositivos de prueba permiten a los administradores probar actualizaciones de firmware antes de distribuirlas a todos los dispositivos de una organización.
Sintaxis
Remove-CsTestDevice -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
La identificación de teléfonos compatibles con Microsoft Lync 2010 Phone Edition específicos u otros dispositivos de prueba permite a los administradores comprobar y aprobar actualizaciones de firmware antes de implantarlas en todos los dispositivos relevantes 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 se descargarán y se instalarán en los dispositivos de prueba pertinentes. Ésa es precisamente la finalidad de los dispositivos de prueba: las nuevas reglas de actualización de dispositivos se aplican automáticamente a los dispositivos de prueba, gracias a lo cual los administradores pueden comprobar que las actualizaciones de firmware funcionan como se espera. Si es así, pueden marcar las reglas como "aprobada". A partir de entonces, las reglas aprobadas se descargan y se instalan en todos los dispositivos relevantes de la organización.
Los dispositivos de prueba son dispositivos de hardware que ejecutan Lync 2010 Phone Edition. Estos dispositivos se crean mediante el cmdlet New-CsTestDevice. Cuando se han creado, se pueden quitar si se ejecuta el cmdlet Remove-CsTestDevice. Tenga en cuenta que el hecho de quitar el dispositivo como dispositivo de prueba no afecta al dispositivo en sí; por ejemplo, el teléfono compatible con Lync 2010 Phone Edition se puede seguir usando para obtener acceso a Lync Server 2010. La única diferencia es que, dado que el dispositivo ya no es de prueba, no seguirá descargando reglas de actualización de dispositivos con estado pendiente. En cambio, el dispositivo tendrá que esperar a que las reglas sean aprobadas antes de descargarlas e instalarlas.
Se puede utilizar Remove-CsTestDevice para quitar dispositivos de prueba individuales configurados en el ámbito global o de sitio. También puede utilizar el cmdlet para quitar todos los dispositivos de prueba configurados para un ámbito determinado.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Remove-CsTestDevice de forma local: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsTestDevice"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Indica la identidad del dispositivo de prueba que se debe quitar. Para quitar un dispositivo específico, incluya el ámbito (por ejemplo, site:Redmond) y el nombre del dispositivo, por ejemplo: -Identity "site:Redmond/UCPhoneTest". Para quitar todos los dispositivos de un sitio concreto use la sintaxis del siguiente ejemplo: -Identity "site:Redmond". Los dispositivos de prueba se pueden quitar también del ámbito global. La colección de dispositivos de prueba global no se puede quitar. Sin embargo, el comando siguiente elimina todos los dispositivos almacenados en una colección global: Remove-CsTestDevice –Identity global |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan ocurrir 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.TestDevice. Remove-CsTestDevice acepta la entrada transmitida del objeto de dispositivo de prueba.
Tipos de valores devueltos
Remove-CsTestDevice no devuelve ningún valor ni objeto. En su lugar, el cmdlet elimina las instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Remove-CsTestDevice -Identity site:Redmond
El comando anterior quita todos los dispositivos de prueba del sitio Redmond. De este modo se quitarán los dispositivos de prueba individuales y también la colección de dispositivos.
-------------------------- Ejemplo 2 ------------------------
Get-CsTestDevice | Remove-CsTestDevice
El comando del Ejemplo 2 quita todos los dispositivos de prueba configurados para la organización; para ello se utiliza Get-CsTestDevice, que devuelve todas las recopilaciones de dispositivos de prueba; a continuación, se transfieren esos elementos a Remove-CsTestDevice. Tenga en cuenta que la colección de dispositivos de prueba global no se puede quitar; sin embargo, este comando eliminará todos los dispositivos de prueba individuales configurados en el nivel global.
-------------------------- Ejemplo 3 ------------------------
Get-CsTestDevice -Filter "site:" | Remove-CsTestDevice
En el ejemplo 3, se quitan todos los dispositivos de prueba configurados en el ámbito de sitio. Para realizar esta tarea, se utiliza Get-CsTestDevice y el parámetro Filter para devolver todos los dispositivos de prueba con una identidad que empiece por el valor de cadena "site:". A continuación, la colección filtrada se transfiere a Remove-CsTestDevice, que elimina todos los elementos de la colección.
-------------------------- Ejemplo 4 ------------------------
Get-CsTestDevice | Where-Object {$_.Name -match "LG-Nortel Phone"} | Remove-CsTestDevice
El comando en el ejemplo 4 elimina todos los dispositivos de prueba LG-Nortel. Para ello, en primer lugar el comando llama a Get-CsTestDevice para devolver todos los dispositivos de prueba configurados para su uso en la organización. A continuación, esa información se transfiere al cmdlet Where-Object, que utiliza el operador -match para devolver cualquier dispositivo con el valor de cadena "LG-Nortel" en la propiedad Name. Cualquier dispositivo de prueba que cumpla este criterio se eliminará con Remove-CsTestDevice.