Compartir a través de

  • Artículo

Get-CsUCPhoneConfiguration

 

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

Devuelve información con relación a opciones de administración de Microsoft Lync 2010 Phone Edition. Incluye cosas como el modo de seguridad requerido y si el teléfono se debe o no se debe bloquear automáticamente después de un período de inactividad especificado.

Sintaxis

Get-CsUCPhoneConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsUCPhoneConfiguration [-Filter <String>] [-LocalStore <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 Protocolo de Internet (VoIP). 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 realizar con Lync 2010.

Los cmdlets CsUCPhoneConfiguration permiten administrar sus teléfonos 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 así como si el teléfono se bloqueará automáticamente tras un periodo especificado de inactividad.

Las opciones de configuración del teléfono pueden aplicarse al ámbito global o al ámbito de sitio. (La configuración del ámbito de sitio tendrá prioridad sobre la aplicada en el ámbito global). El cmdlet Get-CsUCPhoneConfiguration le permite recuperar información sobre las opciones de configuración de los teléfonos que se emplean actualmente en la organización.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los grupos siguientes están autorizados a ejecutar el cmdlet Get-CsUCPhoneConfiguration de forma local: RTCUniversalUserAdmins, 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 "Get-CsUCPhoneConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Indica el identificador único de la recopilación de opciones de configuración de teléfonos para comunicaciones unificadas (UC) que desea devolver. Para hacer referencia a la configuración global, use la siguiente sintaxis: -Identity global. Para hacer referencia a una recopilación configurada en el ámbito del sitio, use una sintaxis similar a la siguiente: -Identity "site:Redmond". Tenga en cuenta que no es posible usar comodines al especificar un parámetro Identity. Si necesita usar caracteres comodín, incluya el parámetro Filter.

Si no se ha especificado este parámetro, Get-CsUCPhoneConfiguration devolverá una recopilación de todas las opciones de configuración de los teléfonos para UC que están en uso en la organización.

Filter

Opcional

Cadena de caracteres

Lo habilita a usar caracteres de comodines a fin de devolver una recopilación (o recopilaciones) de opciones de configuración de teléfonos para UC. Para obtener una recopilación de todas las configuraciones en el ámbito del sitio, use esta sintaxis: -Filter site:*. Para devolver una recopilación de todas las configuraciones que tengan el valor de cadena de caracteres "EMEA" en cualquier ubicación del valor Identity (la única propiedad que se puede filtrar), use esta sintaxis: -Filter *EMEA*.

LocalStore

Opcional

Parámetro modificador

Recupera los datos de configuración de los teléfonos para UC de la réplica local de Almacén de administración central, en lugar de Almacén de administración central en sí.

Tipos de entrada

Ninguno. Get-CsUCPhoneConfiguration no acepta entradas canalizadas.

Tipos de valores devueltos

Get-CsUCPhoneConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings.

Ejemplo

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

Get-CsUCPhoneConfiguration

En el comando que se muestra en el Ejemplo 1 se devuelven todas las opciones de configuración de los teléfonos para UC actualmente en uso en la organización. Al llamar a Get-CsUCPhoneConfiguration sin ningún parámetro, siempre se devolverá una recopilación completa de opciones de configuración de teléfonos.

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

Get-CsUCPhoneConfiguration -Identity site:Redmond

En el Ejemplo 2, solo se devuelven las opciones de configuración de teléfonos para UC con identidad site:Redmond. Debido a que las identidades deben ser únicas, este comando nunca devolverá más de una recopilación de opciones de configuración de teléfono.

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

Get-CsUCPhoneConfiguration -Filter site:*

En el comando anterior, se eliminan todas las configuraciones de los teléfonos para UC configuradas en el ámbito de sitio. Para ello, se llama a Get-CsUCPhoneConfiguration junto con el parámetro Filter; el valor del filtro "site:*" limita los datos devueltos a las configuraciones donde la propiedad Identity (la única propiedad que puede filtrar) comienza con el valor de cadena "site:". Por definición, cualquier configuración que tenga una identidad que comience con el valor de la cadena "site:" son configuraciones configuradas en el ámbito del sitio.

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

Get-CsUCPhoneConfiguration | Where-Object {$_.SIPSecurityMode -eq "Medium"}

En el ejemplo 4 se devuelven las opciones de configuración del teléfono para UC donde el modo de seguridad de SIP está configurado en Medio. (La seguridad SIP se puede configurar en Bajo, Medio o Alto). Para realizar esta tarea, el comando primero usa Get-CsUCPhoneConfiguration sin ningún parámetro adicional a fin de devolver una recopilación de todas las opciones de configuración de UC configuradas para usar en la organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que elige solo aquellas configuraciones en las que la propiedad SIPSecurityMode es igual a Medium.

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

Get-CsUCPhoneConfiguration | Where-Object {$_.EnforcePhoneLock -eq $False -or $_.MinPhonePinLength -lt 6}

En el Ejemplo 5 se devuelven todas las opciones de configuración de teléfonos para UC que cumplen con uno o ambos de los siguientes criterios: 1) no se exige bloqueo del teléfono; o 2) la longitud mínima del PIN es inferior a 6 dígitos. Para ello, el comando primero usa Get-CsUCPhoneConfiguration para devolver una recopilación de todas las configuraciones de teléfonos para UC que estén actualmente en uso en la organización. A continuación, la recopilación se canaliza a Where-Object, que selecciona aquellos elementos que cumplen con uno (o ambos) de los siguientes criterios: 1) la propiedad EnforcePhoneLock es igual a False; o 2) la propiedad MinPhoneLength es inferior a 6.

El operador -or le indica a Where-Object que elija configuraciones que cumplan con uno (o ambos) criterios. Para elegir configuraciones que cumplen con ambos criterios (en este caso, significa que no se exige bloqueo de teléfono y la longitud del PIN es inferior a 6) de uso y el operador -and:

Where-Object {$_.EnforcePhoneLock -eq $False -and $_.MinPhonePinLength -lt 6}