Set-CsTestDevice
Última modificación del tema: 2012-03-25
Modifica uno o varios de los dispositivos de prueba de administración de actualizaciones de dispositivos que fueron configurados para su uso 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
Set-CsTestDevice [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Identifier <String>] [-IdentifierType <MACAddress | SerialNumber>] [-WhatIf [<SwitchParameter>]]
Set-CsTestDevice [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Identifier <String>] [-IdentifierType <MACAddress | SerialNumber>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
La identificación de teléfonos específicos que ejecuten Microsoft Lync 2010 Phone Edition 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 serán descargadas e instaladas por los dispositivos de prueba relevantes. É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, 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 crean por medio del cmdlet New-CsTestDevice. Una vez creado el dispositivo de prueba, puede usar el cmdlet Set-CsTestDevice para cambiar los parámetros Identifier o IdentifierType de ese dispositivo o de cualquier otro dispositivo de prueba.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsTestDevice 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-CsTestDevice"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Indica el parámetro Identity de la cuenta de usuario que se modificará. Por ejemplo: -Identity site:Redmond/UCPhoneTestDevice. Tenga en cuenta que no es posible usar comodines al especificar un parámetro Identity. |
Instance |
Opcional |
Objeto de dispositivo de prueba |
Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales. |
Identifier |
Requerido |
Cadena de caracteres |
En función del IdentifierType, indica la dirección Media Access Control (MAC) o el número de serie del nuevo dispositivo de prueba. Los números de serie se pueden especificar mediante números, letras, guiones y guiones bajos, por ejemplo: -Identifier "AB37_679e" Las direcciones MAC deben especificarse como seis o más pares de dos caracteres, según la dirección MAC. Estos pares pueden ser un valor de cadena de caracteres único, o bien, pueden separarse con guiones o dos puntos. (Tenga en cuenta que las direcciones MAC pueden incluir tanto letras como números). Cada uno de los siguientes ejemplos son direcciones MAC válidas: 010203040506 01-02-03-04-05-06 01:02:03:04:05:06 Una dirección MAC como 01-02-03-04-05 no podrá aceptarse porque no cuenta con por lo menos seis pares de dos caracteres. |
IdentifierType |
Requerido |
Cadena de caracteres |
Indica si el dispositivo de prueba se identificará únicamente por medio de su dirección MAC o por su número de serie. Para identificar un dispositivo por medio de su dirección MAC, defina el IdentifierType en MACAddress. Para identificar un dispositivo por medio de su número de serie, defina el IdentifierType en SerialNumber. MACAddress y SerialNumber son los únicos valores permitidos. |
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. |
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. Set-CsTestDevice acepta entradas canalizadas del objeto de dispositivo de prueba.
Tipos de valores devueltos
Set-CsTestDevice no devuelve un valor ni un objeto. En cambio, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsTestDevice -Identity site:Redmond/UCPhone -Identifier "09768-ABDR-83295"
El comando anterior modifica la propiedad Identifier del dispositivo de prueba llamado UCPhone que está asignado al sitio Redmond.
-------------------------- Ejemplo 2 --------------------------
Set-CsTestDevice -Identity site:Redmond/UCPhone -IdentifierType SerialNumber -Identifier "09768-ABDR-83295"
El comando que se muestra en el Ejemplo 2 también modifica el dispositivo de prueba llamado UCPhone que está asignado al sitio Redmond. En esta caso, sin embargo, el comando no solo especifica un nuevo Identifier sino que también asigna un nuevo IdentifierType: SerialNumber.