New-CsUCPhoneConfiguration
Última modificación del tema: 2012-03-26
Crea una nueva colección de valores empleados para administrar Microsoft Lync 2010 Phone Edition. Estos valores permiten configurar aspectos como el modo de seguridad requerido y especificar si el teléfono se bloquea automáticamente después de un periodo especificado de inactividad.
Sintaxis
New-CsUCPhoneConfiguration -Identity <XdsIdentity> [-CalendarPollInterval <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnforcePhoneLock <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LoggingLevel <Off | Low | Medium | High>] [-MinPhonePinLength <Byte>] [-PhoneLockTimeout <TimeSpan>] [-SIPSecurityMode <Low | Medium | High>] [-Voice8021p <Byte>] [-VoiceDiffServTag <Byte>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Lync 2010 Phone Edition constituye la combinación del teléfono y Microsoft Lync 2010. Lync 2010 Phone Edition usa hardware especial (es decir, un teléfono compatible con Lync 2010) que puede funcionar como un teléfono de voz sobre IP. Asimismo, este hardware puede actuar como extremo de Lync 2010: puede establecer su estado actual, comprobar el estado de los contactos de Lync 2010, buscar nuevos contactos y realizar otras muchas actividades que está acostumbrado a hacer con Lync 2010.
Lync Server 2010 incluye una amplia variedad de cmdlet que permiten administrar los teléfonos que ejecutan Lync 2010; por ejemplo, puede controlar aspectos como la longitud mínima del número de identificación personal (PIN) usado para iniciar sesión en el teléfono y si el teléfono se bloqueará automáticamente tras un período especificado de inactividad.
Las opciones de configuración del teléfono de comunicaciones unificadas (UC) pueden aplicarse al ámbito global o al ámbito del sitio. (Los valores aplicados como ámbito local tienen precedencia sobre los valores aplicados como ámbito global). Cuando instala por primera vez Lync Server, se crea una configuración única de teléfono UC y se aplica al ámbito global. No obstante, después de esto puede usar en cualquier momento el cmdlet New-CsUCPhoneConfiguration para crear una recopilación de opciones de configuración que se aplicarán al ámbito del sitio. Esto le permite administrar el teléfono UC según las necesidades únicas de cada sitio.
New-CsUCPhoneConfiguration permite crear nuevos valores de teléfono de UC en el ámbito de sitio. Tenga en cuenta que solo puede haber una colección de valores por sitio. Por ejemplo, suponga que intenta crear una colección de valores que tiene Identity site:Redmond, pero Redmond ya tiene un conjunto de valores de teléfono UC asignados. En ese caso, el comando dará error. Tendrá que seguir uno de los dos métodos siguientes: puede eliminar la configuración existente y usar New-CsUCPhoneConfiguration para crear una nueva colección de opciones de configuración, o bien usar Set-CsUCPhoneConfiguration para modificar las opciones existentes.
No puede crear una nueva colección de valores en el ámbito global. Lo único que puede hacer en el ámbito global es usar Set-CsUCPhoneConfiguration para modificar las opciones de configuración existentes.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet New-CsUCPhoneConfiguration localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basados en rol (RBAC) a los que este cmdlet rol se ha asignado (incluido cualquier otro rol RBAC personalizado que haya creado), ejecute el siguiente comando desde el símbolo del sistema de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsUCPhoneConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Representa el identificador único que se asigna a la nueva colección de valores de configuración del teléfono UC. Como solo puede crear nuevas colecciones en el ámbito del sitio, la Identidad siempre será el prefijo "site:" seguida del nombre del sitio; por ejemplo, "site:Redmond". |
CalendarPollInterval |
Opcional |
TimeSpan |
Indica con qué frecuencia el dispositivo UC recupera información de su calendario de Microsoft Outlook. El valor debe especificarse con el formato horas:minutos:segundos. Por ejemplo, para establecer el intervalo en una hora (el intervalo máximo permitido), use la siguiente sintaxis: -CalendarPollInterval "01:00:00". El valor predeterminado es 3 minutos (00:03:00). |
EnforcePhoneLock |
Opcional |
Booleano |
Determina si los teléfonos UC se bloquean automáticamente pasados los minutos especificado en PhoneLockTimeout. El valor predeterminado es True. |
LoggingLevel |
Opcional |
Cadena de caracteres |
Permite iniciar sesión en el dispositivo UC. Los valores válidos son Off, Low, Medium y High. El valor predeterminado es Off. |
MinPhonePinLength |
Opcional |
Byte |
Especifica el número mínimo de dígitos requeridos para los números de identificación personal (PIN). Valor mínimo: 4 Valor máximo: 15 Valor predeterminado: 6 |
PhoneLockTimeout |
Opcional |
Timespan |
Especifica el tiempo, en minutos, que el teléfono UC permanece inactivo antes de bloquearse automáticamente. Este valor debe ser inferior a 01:00:00 (1 hora). El valor predeterminado es 00:10:00 (10 minutos). |
SIPSecurityMode |
Opcional |
SIPSecurityMode |
Especifica el nivel de seguridad que el servidor aplica a las sesiones SIP iniciadas en el teléfono UC. Los valores válidos son: Low (permite cualquier tipo de autorización o transporte). Medium (NTLM o Kerberos son necesarios para la autenticación del usuario). High (son necesarios NTLM o Kerberos para la autenticación del usuario y TLS es necesario para las conexiones SIP). El valor predeterminado es High. |
Voice8021p |
Opcional |
Byte |
Especifica el valor de prioridad del usuario (el valor 802.1p) para el tráfico de voz en la implementación de Lync Server 2010. Esta configuración solo resulta eficaz en las redes en las que los conmutadores y los puentes son compatibles con 802.1p. El valor mínimo de esta propiedad es 0 y el máximo, 7. El valor predeterminado es 0. |
VoiceDiffServTag |
Opcional |
Byte |
Especifica la representación decimal del marcado de prioridad de 6 bits del Punto de código de servicios diferenciados (DSCP), que define el comportamiento por salto (PHB) de los paquetes IP transferidos por los teléfonos UC que administra este servidor. Este valor debe encontrarse entre 0 y 63, ambos incluidos. El valor predeterminado es 40. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no son graves y que pueden surgir 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-CsUCPhoneConfiguration no acepta entradas transferidas.
Tipos de valores devueltos
Crea instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
New-CsUCPhoneConfiguration -Identity site:Redmond -CalendarPollInterval "00:10:00" -LoggingLevel "Medium"
El comando anterior crea una nueva colección de valores de teléfono UC para el sitio Redmond. En este ejemplo, se incluyen dos parámetros opcionales junto al parámetro requerido Identity: CalendarPollInterval, que configura el análisis de calendario cada 10 minutos (00 horas: 10 minutos: 00 segundos) y LoggingLevel, que establece el nivel de inicio de sesión del teléfono UC en Medium. En cuanto se completa el comando, los nuevos valores se aplicarán a la ubicación Redmond y los usuarios de dicho sitio tendrán los teléfonos UC controlados por los nuevos valores. Tenga en cuenta que este comando dará error si la ubicación Redmond ya tiene una colección de valores de teléfono UC.
-------------------------- Ejemplo 2 ------------------------
$x = New-CsUCPhoneConfiguration -Identity site:Redmond -InMemory
$x.CalendarPollInterval = "00:10:00"
$x.LoggingLevel = "Medium"
Set-CsUCPhoneConfiguration -Instance $x
En el ejemplo 2 se muestra el uso del parámetro InMemory. Este parámetro permite crear un nuevo conjunto de opciones de configuración de teléfono UC que exista solo en la memoria. (Estos valores se almacenan en la variable $x). Después de haber creado la colección virtual, puede modificar los valores de la memora usando comandos similares a los mostrados en las líneas 2 y 3 del ejemplo: en la línea 2, la propiedad CalendarPollInterval se configura como 10 minutos (00 horas: 10 minutos: 00 segundos) y, en la línea 3, la propiedad LoggingLevel se configura como Medium.
Cuando haya acabado de modificar los valores de las propiedades, puede usar Set-CsUCPhoneConfiguration para convertir los valores virtuales almacenados en $x en una colección real de valores aplicados al sitio de Redmond. Tenga en cuenta que, con el uso del parámetro InMemory, las opciones de configuración no se aplican realmente hasta que no se llama a Set-CsUCPhoneConfiguration. Si no llama a este cmdlet, las opciones de configuración virtuales desaparecerán cuando finalice la sesión en Windows PowerShell o cuando elimine la variable $x.
Vea también
Otros recursos
Get-CsUCPhoneConfiguration
Remove-CsUCPhoneConfiguration
Set-CsUCPhoneConfiguration