Compartir a través de


Set-CsUCPhoneConfiguration

 

Última modificación del tema: 2012-03-26

Permite modificar las opciones de administración de Microsoft Lync 2010 Phone Edition. Esto incluye aspectos como el modo de seguridad requerido y si el teléfono debe bloquearse automáticamente tras un período de inactividad especificado.

Sintaxis

Set-CsUCPhoneConfiguration [-Identity <XdsIdentity>] [-CalendarPollInterval <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnforcePhoneLock <$true | $false>] [-Force <SwitchParameter>] [-LoggingLevel <Off | Low | Medium | High>] [-MinPhonePinLength <Byte>] [-PhoneLockTimeout <TimeSpan>] [-SIPSecurityMode <Low | Medium | High>] [-Voice8021p <Byte>] [-VoiceDiffServTag <Byte>] [-WhatIf [<SwitchParameter>]]

Set-CsUCPhoneConfiguration [-CalendarPollInterval <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnforcePhoneLock <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 VoIP (Protocolo de voz sobre IP). Asimismo, este hardware puede actuar como extremo de Lync 2010: puede establecer su estado actual, comprobar el estado de sus contactos de Lync 2010, buscar nuevos contactos y realizar muchas otras actividades que está acostumbrado a hacer con Lync 2010.

Los CsUCPhoneConfiguration permiten usar opciones de configuración para administrar teléfonos que ejecuten Lync 2010 Phone Edition. 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. Al instalar por primera vez Lync Server, se crea un único conjunto de opciones de configuración 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 adaptar la administración del teléfono UC a las necesidades específicas de cada sitio.

Además de crear recopilaciones de opciones de configuración de teléfono UC, puede usar el cmdlet Set-CsUCPhoneConfiguration para modificar los valores de propiedad de una recopilación existente. Por ejemplo, de forma predeterminada el inicio de sesión está deshabilitado para los teléfonos UC. Para habilitar el inicio de sesión en el nivel global, puede usar Set-CsUCPhoneConfiguration para cambiar el valor de la propiedad LoggingLevel de la recopilación global a True.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsUCPhoneConfiguration de manera local: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC), se ha asignado este cmdlet (incluidos los roles RBAC que haya creado usted mismo) para ejecutar el siguiente comando desde el símbolo del sistema de Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsUCPhoneConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Representa el identificador único asignado a la recopilación de opciones de configuración de teléfono UC. Para hacer referencia a la configuración global, use esta sintaxis: -Identity global. Para hacer referencia a una recopilación configurada en el ámbito de sitio, use una sintaxis similar a ésta: -Identity site:Redmond. Tenga en cuenta que no puede usar caracteres comodín para especificar una identidad.

Si se omite este parámetro, Set-CsUCPhoneConfiguration modificará la configuración global.

Instance

Opcional

Objeto UcPhoneSettings

Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales.

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 definir el intervalo de tiempo en 1 hora (el intervalo máximo permitido ), use esta 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 tras el número de minutos especificado por 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 período de tiempo (en minutos) que un teléfono UC permanecerá inactivo antes de bloquearse automáticamente.

Este valor debe ser menor que 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 mediante un teléfono UC.

Los valores válidos son:

Low (permitir cualquier tipo de autorización o transporte).

Medium (se requiere el método NTLM o Kerberos para la autenticación de los usuarios).

High (se requiere el método NTLM o Kerberos para la autenticación de los usuarios y el cifrado TLS 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.

Esta configuración solo resulta eficaz para las redes en que los modificadores y puentes son compatibles con 802.1p. El valor mínimo para esta propiedad es 0 y el valor 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). Este marcado define el comportamiento por salto (PHB) para paquetes IP transferidos por los teléfonos UC que administra este servidor.

Debe ser un valor 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 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.Policy.Voice.UcPhoneSettings. Set-CsUCPhoneConfiguration acepta instancias transferidas del objeto de configuraciones del teléfono UC.

Tipos de valores devueltos

Set-CsUCPhoneConfiguration no devuelve ningún valor ni objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

Set-CsUCPhoneConfiguration -Identity global -SIPSecurityMode "Medium"

El comando que se muestra en el Ejemplo 1 define el modo de seguridad SIP de la configuración global de teléfono UC en Medium.

-------------------------- Ejemplo 2 --------------------------

Set-CsUCPhoneConfiguration -Identity site:Redmond -PhoneLockTimeout "00:30:00"

El comando anterior modifica la configuración de teléfono UC definida para el sitio de Redmond. En este caso, la propiedad PhoneLockTimeout se establece en 30 minutos; para ello, se incluye el parámetro -PhoneLockTimeout y el valor de parámetro "00:30:00" (00 horas: 30 minutos: 00 segundos).

-------------------------- Ejemplo 3 --------------------------

Get-CsUCPhoneConfiguration -Filter "site:*" | Set-CsUCPhoneConfiguration -PhoneLockTimeout "00:30:00"

El Ejemplo 3 es una variación del comando mostrado en el Ejemplo 2, pero esta vez se modifica la propiedad PhoneLockTimeout para todas las configuraciones de teléfono UC definidas en el ámbito del sitio. Para ello, el comando comienza llamando a Get-CsUCPhoneConfiguration; el parámetro Filter y el valor de filtro "site:*" restringen los datos devueltos a la configuración de teléfono definida en el ámbito del sitio. A continuación, la recopilación filtrada se transfiere a Set-CsUCPhoneConfiguration, que usa el parámetro PhoneLockTimeout y el valor de parámetro "00:30:00" (00 horas: 30 minutos: 00 segundos) para definir el valor de tiempo de espera para el bloqueo del teléfono para todos los elementos de la recopilación en 30 minutos.

-------------------------- Ejemplo 4 --------------------------

Get-CsUCPhoneConfiguration | Where-Object {$_.SIPSecurityMode -ne "High"} | Set-CsUCPhoneConfiguration -EnforcePhoneLock $True -PhoneLockTimeout "00:30:00"

El comando anterior configura las propiedades EnforcePhoneLock y PhoneLockTimeout para todas las configuraciones de teléfono UC en que el modo de seguridad SIP esté definido en Low o Medium. Para realizar esta tarea, el comando usa primero Get-CsUCPhoneConfiguration para devolver todas las opciones de configuración de teléfono UC de la organización; a continuación, esta información se transfiere al cmdlet Where-Object, que elige solo aquellas configuraciones donde la propiedad SIPSecurityMode no es igual a High. (Dado que la seguridad SIP solo se puede establecer en Low, Medium o High, esta cláusula seleccionará todas las configuraciones donde la propiedad SIPSecurityMode esté establecida en Low o Medium.) A continuación, la recopilación filtrada se transfiere a Set-CsUCPhoneConfiguration, que usa los parámetros EnforcePhoneLock y PhoneLockTimeout para modificar las propiedades de bloqueo del teléfono y de tiempo de espera para el bloqueo del teléfono.

-------------------------- Ejemplo 5 --------------------------

Get-CsUCPhoneConfiguration | Where-Object {$_.PhoneLockTimeout -lt "00:10:00"} | Set-CsUCPhoneConfiguration -PhoneLockTimeout "00:10:00"

En el Ejemplo 5, el valor de tiempo de espera para el bloqueo del teléfono se establece en 10 minutos para todas las configuraciones de teléfono UC cuya propiedad PhoneLockTimeout tenga un valor inferior a 10 minutos. (De hecho, esto hace que 10 minutos sea el valor mínimo de tiempo de espera para el bloqueo del teléfono en toda la organización.) Para ello, el comando primero usa Get-CsUCPhoneConfiguration para devolver una recopilación de todas las configuraciones de teléfono UC que estén actualmente en uso en la organización. Esta recopilación se transfiere a Where-Object, que solo selecciona las configuraciones en las que la propiedad PhoneLockTimeout sea menor que 10 minutos (00 horas: 10 minutos: 00 segundos). A su vez, la recopilación filtrada se transfiere a Set-CsUCPhoneConfiguration, que define el valor de PhoneLockTimeout en 10 minutos para todos los elementos de la recopilación.