New-CsDialPlan
Última modificación del tema: 2012-03-27
Crea un plan de marcado.
Sintaxis
New-CsDialPlan -Identity <XdsIdentity> [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Este cmdlet crea un plan de marcado (también denominado perfil de ubicació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.
Cuando se crea un plan de marcado, se genera automáticamente una regla predeterminada de normalización de voz. Las reglas de normalización se pueden modificar llamando al cmdlet Set-CsVoiceNormalizationRule. De igual modo, se pueden agregar nuevas reglas de normalización a un plan de marcado si se llama a New-CsVoiceNormalizationRule.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet New-CsDialPlan localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsDialPlan"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Identificador único que designa el ámbito y nombre (sitio), el rol de servicio y FQDN, o bien el nombre (por usuario) para identificar el plan de marcado. Por ejemplo, la propiedad Identity de un sitio se especifica con el formato site:<nombresitio>, "nombresitio" es el nombre del sitio. Un plan de marcado en el ámbito de servicio debe consistir en un servicio de registrador o puerta de enlace RTC cuyo valor de Identity tenga el siguiente formato: Registrar:Redmond.litwareinc.com. Una propiedad Identity por usuario se especifica como un valor de cadena de caracteres único. |
Description |
Opcional |
Cadena de caracteres |
Descripción del plan de marcado: para qué sirve, a qué tipo de usuario se aplica o cualquier otro tipo de información que pueda resultar útil para identificar el propósito del plan de marcado. Número máximo de caracteres: 512 |
DialinConferencingRegion |
Opcional |
Cadena de caracteres |
El nombre de la región asociada con este plan de marcado. Indique un valor para este parámetro en caso de que el plan de marcado se vaya a usar en conferencias de acceso telefónico, ya que así se asignará el número de acceso adecuado cuando el organizador de la conferencia configure la conferencia. Las regiones disponibles pueden recuperarse llamando al cmdlet Get-CsNetworkRegion. Número máximo de caracteres: 512 |
ExternalAccessPrefix |
Opcional |
Cadena de caracteres |
Un número (o conjunto de números) que designa la llamada como externa a la organización. (Por ejemplo, para marcar una línea externa, primero debe marcar 9.) Las reglas de normalización omitirán este prefijo, a pesar de que estas reglas se aplicarán al resto del número. El parámetro OptimizeDeviceDialing debe establecerse en True para que el valor surta efecto. Este parámetro debe coincidir con la expresión regular [0-9]{1,4}. Esto significa que debe ser un valor entre 0 y 9, con una longitud de uno a cuatro dígitos. Valor predeterminado: 9 |
NormalizationRules |
Opcional |
Modificador de lista PS |
Lista de reglas de normalización aplicadas al plan de marcado. A pesar de que la lista y las reglas pueden crearse directamente con este cmdlet, recomendamos crear las reglas de normalización con el cmdlet New-CsVoiceNormalizationRule, que crea la regla y la asigna al plan de marcado especificado. Cada vez que se crea un plan de marcado nuevo, también se crea una regla de normalización de voz nueva con la configuración predeterminada destinada a dicho plan de marcado de sitio, servicio o por usuario. De forma predeterminada, la Identity de la regla de normalización de voz nueva es la Identity del plan de marcado seguida de una barra diagonal y del nombre Prefix All. Por ejemplo, site:Redmond/Prefix All. Valor predeterminado: {Description=;Pattern=^(\d11)$;Translation=+$1;Name=Prefix All;IsInternalExtension=False } Nota: Este valor predeterminado es sólo un marcador de posición. Para que el plan de marcado resulte útil, deberá modificar la regla de normalización creada con el plan de marcado o crear una nueva para el sitio, servicio o usuario. Puede llamar al cmdlet New-CsVoiceNormalizationRule para crear una regla de normalización nueva. Si desea modificarla, llame al cmdlet Set-CsVoiceNormalizationRule. |
OptimizeDeviceDialing |
Opcional |
Booleano |
Si establece este parámetro en True, el prefijo del parámetro ExternalAccessPrefix se aplicará a las llamadas fuera de la organización. Este valor se puede establecer en True única y exclusivamente si se ha especificado un valor en el parámetro ExternalAccessPrefix. Valor predeterminado: False |
SimpleName |
Opcional |
Cadena de caracteres |
Nombre para mostrar del plan de marcado. No puede haber otro plan de marcado con el mismo nombre en la instalación de Lync Server. Esta cadena de caracteres puede tener hasta 256 caracteres de longitud. Los caracteres válidos pueden ser alfabéticos y numéricos, guión (-), punto (.), signo más (+), signo de subrayado (_) y paréntesis(()). Este parámetro debe contener un valor. Sin embargo, si no indica un valor en la llamada a New-CsDialPlan, se proporcionará un valor predeterminado. El valor predeterminado para el plan de marcado Global es Prefix All. El valor predeterminado para un plan de marcado de nivel del sitio es el nombre del sitio. El valor predeterminado para un servicio es el nombre del servicio (registrador o puerta de enlace RTC) seguido de un carácter de subrayado y del nombre de dominio completo (FQDN). Por ejemplo, Registrar_pool0.litwareinc.com. El valor predeterminado para un plan de marcado por usuario es el parámetro Identity del plan de marcado. |
State |
Opcional |
Cadena de caracteres |
Este parámetro no se usa con este cmdlet. |
City |
Opcional |
Cadena de caracteres |
Este parámetro no se usa con este cmdlet. |
CountryCode |
Opcional |
Cadena de caracteres |
Este parámetro no se usa con este cmdlet. |
Force |
Opcional |
Parámetro modificador |
Suprime todas las preguntas de confirmación antes de realizar cambios. |
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.
Tipos de valores devueltos
Este cmdlet crea un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
New-CsDialPlan -Identity RedmondDialPlan
El comando del ejemplo 1 crea un nuevo plan de marcado con el valor de Identity RedmondDialPlan. (La ausencia de ámbito en el valor Identity indica que se trata de una directiva por usuario. Los planes de marcado creados en el ámbito por usuario se pueden asignar directamente a usuarios y grupos.) Se asignarán valores predeterminados al resto de propiedades del plan de marcado.
-------------------------- Ejemplo 2 --------------------------
New-CsDialPlan -Identity site:Redmond -SimpleName RedmondSiteDialPlan
New-CsVoiceNormalizationRule -Identity "site:Redmond/SeattlePrefix" -Pattern "^9(\d*){1,5}$" -Translation "+1206$1"
Los comandos que aparecen en el ejemplo 2 crean un plan de marcado nuevo con Identity site:Redmond (lo que significa que el plan de marcado se aplica a todos los usuarios del sitio Redmond que no tienen asignado un plan de marcado por usuario o de nivel de servicio) y SimpleName RedmondSiteDialPlan. A continuación, la siguiente línea del ejemplo crea una nueva regla de normalización asociada a dicho plan. Una regla de normalización predeterminada se crea para plan de marcado, si bien se crea básicamente como un marcador de posición; es decir, los valores tienen una utilidad limitada. Por lo tanto, después de llamar al cmdlet New-CsDialPlan para crear un plan de marcado, debería llamar a New-CsVoiceNormalizationRule para crear una regla con nombre que resulte efectiva en su organización. Esto es exactamente lo que se hace en la línea 2 de este ejemplo: se llama a New-CsVoiceNormalizationRule y se crea una regla para el sitio Redmond con el nombre SeattlePrefix y las propiedades Pattern y Translation establecidas. No es necesario hacer nada más para modificar el plan de marcado; los cambios se aplican automáticamente a la regla de normalización del plan de marcado con el valor de Identity correspondiente. (La sección site:Redmond de la propiedad Identity coincide con el valor de Identity del plan de marcado; SeattlePrefix es el nombre de la regla de normalización. Pueden aplicarse varias reglas de normalización a un plan de marcado, por eso cada regla necesita tener un nombre único en el ámbito correspondiente.)
-------------------------- Ejemplo 3 --------------------------
New-CsDialPlan -Identity RedmondDialPlan -Description "Dial plan for Redmond users"
El comando que aparece en el Ejemplo 3 crea un plan de marcado nuevo con la Identity RedmondDialPlan y especifica una Description para explicar para qué sirve el plan de marcado. (Los planes de marcado creados en el ámbito por usuario se pueden asignar directamente a usuarios y grupos.) Se asignarán los valores predeterminados al resto de parámetros.