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.
Vea también
Otros recursos
Get-CsUCPhoneConfiguration
New-CsUCPhoneConfiguration
Remove-CsUCPhoneConfiguration