New-CsTestDevice
Última modificación del tema: 2012-03-26
Crea un nuevo dispositivo de prueba de administración de actualización de dispositivo. 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
New-CsTestDevice -Identity <XdsIdentity> -Identifier <String> -IdentifierType <MACAddress | SerialNumber> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
New-CsTestDevice -Identifier <String> -IdentifierType <MACAddress | SerialNumber> -Name <String> -Parent <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
La identificación de teléfonos específicos compatibles con Microsoft Lync 2010 Phone Edition u otros dispositivos (por ejemplo, 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. É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. Estos dispositivos pueden configurarse en el ámbito global o en el ámbito del sitio.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-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 "New-CsTestDevice"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Indica la identidad para el nuevo dispositivo de prueba. Una identidad consiste en el ámbito donde el dispositivo de prueba debe asignarse (por ejemplo, site:Redmond) y en el nombre para el nuevo dispositivo (por ejemplo, UCPhone). Para asignar un dispositivo de prueba llamado UCPhone al sitio Redmond, el parámetro Identity debe ser de la siguiente manera: -Identity "site:Redmond/UCPhone". |
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; en función de la dirección MAC, estos pares pueden unirse en una sola cadena o pueden separarse por medio de 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. |
Name |
Opcional |
Cadena de caracteres |
Nombre para el nuevo dispositivo de prueba (los nombres deben ser únicos dentro de un ámbito determinado). El parámetro Name solamente debe usarse cuando se usa el parámetro Parent. |
Parent |
Opcional |
Cadena de caracteres |
Nombre del ámbito (por ejemplo, site:Redmond) donde se debe asignar el nuevo dispositivo de prueba. Si usa el parámetro Parent, entonces también debe usar el parámetro Name, por ejemplo: -Parent site:Redmond –Name UCPhone. Si usa el parámetro Parent, no debe usar el parámetro Identity, y viceversa. |
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-CsTestDevice no acepta entradas canalizadas.
Tipos de valores devueltos
Crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
New-CsTestDevice -Identity site:Redmond/UCPhone -IdentifierType SerialNumber -Identifier "07823-A345"
El comando anterior crea un nuevo dispositivo de prueba (llamado UCPhone) para el sitio Redmond. Tenga en cuenta la sintaxis usada para especificar el dispositivo: Identity: el ámbito del dispositivo (site:Redmond) seguido del carácter /, seguido del nombre del dispositivo (UCPhone). Este dispositivo usa el número de serie como el valor IdentifierType y tiene un número de serie de 07823-A345.
-------------------------- Ejemplo 2 --------------------------
New-CsTestDevice -Parent Redmond -Name UCPhone -IdentifierType SerialNumber -Identifier "07823-A345"
El comando que se muestra en el Ejemplo 2 es una variación del comando que se muestra en el Ejemplo 1. Sin embargo, en el Ejemplo 2 no se usa el parámetro Identity. En cambio, se usa el parámetro Parent para especificar el ámbito del nuevo dispositivo de prueba (site:Redmond), y el parámetro Name se usa para indicar el nombre del nuevo dispositivo (UCPhone). El cmdlet New-CsTestDevice tomará esos dos valores de parámetros y construirá automáticamente la identidad del dispositivo de prueba (site:Redmond/UCPhone).