Compartir a través de

  • Artículo

Get-CsDialPlan

 

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

Devuelve información sobre los planes de marcado usados en la organización.

Sintaxis

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

Get-CsDialPlan [-Filter <String>] [-LocalStore <SwitchParameter>]

Descripción detallada

Este cmdlet devuelve información sobre uno o más planes de marcado (también conocidos como perfiles de ubicación) de una organización. Los planes de marcado proporcionan información necesaria para habilitar las llamadas telefónicas para los usuarios de Enterprise Voice. Aplicación de operador de conferencia también usa los planes de marcado para las conferencias de acceso telefónico local. Los planes de marcado determinan opciones como las reglas de normalización que se van a aplicar y si se debe marcar un prefijo para las llamadas externas.

Nota: Puede usar Get-CsDialPlan para recuperar información específica sobre las reglas de normalización de un plan de marcado, pero si se trata de la única información del plan de marcado que necesita, también puede usar el cmdlet Get-CsVoiceNormalizationRule.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsDialPlan de manera local: RTCUniversalUserAdmins, 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 "Get-CsDialPlan"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

El único identificador que designa el ámbito, y para el ámbito por usuario, un nombre, para identificar el plan de marcado que desea recuperar.

Filter

Opcional

Cadena de caracteres

Realiza una búsqueda con caracteres comodín que permite restringir los resultados para sólo obtener los planes de marcado con identidades que coincidan con la cadena de caracteres con comodín especificada.

LocalStore

Opcional

Parámetro modificador

Recupera la información del plan de marcado de la réplica local de Almacén de administración central, en lugar de recuperarla de la Almacén de administración central.

Tipos de entrada

Ninguno.

Tipos de valores devueltos

Este cmdlet devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile.

Ejemplo

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

Get-CsDialPlan

En el ejemplo 1 se devuelve una recopilación de todos los planes de marcado configurados para el uso en su organización; esto se realiza llamando a Get-CsDialPlan sin parámetros adicionales.

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

Get-CsDialPlan -Identity RedmondDialPlan

En el Ejemplo 2, el parámetro Identity se usa para limitar los datos recuperados a los planes de marcado que tienen un plan de marcado por usuario con el valor de Identity RedmondDialPlan. Puesto que las identidades deben ser únicas, este comando sólo devolverá el plan de marcado especificado.

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

Get-CsDialPlan -Identity site:Redmond

El Ejemplo 3 es idéntico al Ejemplo 2, excepto por el hecho de que en lugar de recuperar un plan de marcado por usuario, se recupera un plan de marcado asignado a un sitio. Para ello, se especifica el valor site: seguido del nombre del sitio (en este caso Redmond) del sitio que se quiere recuperar.

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

Get-CsDialPlan -Filter tag:*

En este ejemplo se usa el parámetro Filter para devolver una recopilación de todos los planes de marcado que se han configurado en el ámbito por usuario. (Los valores configurados en el ámbito por usuario o etiqueta se pueden asignar directamente a los usuarios y grupos.) La cadena de caracteres con comodín tag:* solicita al cmdlet que devuelva solo los planes de marcado que tengan una identidad que comience por el valor de cadena de caracteres tag:, que identifica un plan de marcado como plan de marcado por usuario.

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

Get-CsDialPlan | Select-Object -ExpandProperty NormalizationRules

En este ejemplo se muestran las reglas de normalización que usan los planes de marcado configurados para el uso en su organización. Puesto que la propiedad NormalizationRules está compuesta por un conjunto de objetos, el conjunto completo de reglas de normalización no se suele mostrar en la pantalla. Para ver todas estas reglas, este comando de muestra primero usa Get-CsDialPlan para recuperar una recopilación de todos los planes de marcado. A continuación, la recopilación se transfiere al cmdlet Select-Object; asimismo, se usa el parámetro ExpandProperty de Select-Object para "expandir" los valores encontrados en la propiedad NormalizationRules. Expandir los valores significa que todas las reglas de normalización se mostrarán individualmente en la pantalla, que es el mismo resultado que se mostraría si se hubiese llamado a Get-CsVoiceNormalizationRule.

-------------------------- Ejemplo 6 --------------------------

Get-CsDialPlan | Where-Object {$_.Description -match "Redmond"}

En el ejemplo 6, Get-CsDialPlan y Where-Object se usan para recuperar una recopilación de todos los planes de marcado que contienen la palabra Redmond en su descripción. Para ello, el comando primero usa Get-CsDialPlan para recuperar todos los planes de marcado. A continuación, la recopilación se transfiere a Where-Object, que aplica un filtro que limita los datos devueltos a los perfiles que contengan la palabra Redmond en su descripción.