Set-CsDialPlan
Última modificación del tema: 2012-03-27
Modifica un plan de marcado existente.
Sintaxis
Set-CsDialPlan [-Identity <XdsIdentity>] [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
Set-CsDialPlan [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Este cmdlet modifica un plan de marcado existente (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.
Nota: a pesar de que las reglas de normalización de un plan de marcado pueden modificarse con este cmdlet, se recomienda usar en su lugar los cmdlet New-CsVoiceNormalizationRule, Set-CsVoiceNormalizationRule o Remove-CsVoiceNormalizationRule, porque los cambios realizados en estos cmdlet se reflejan en el plan de marcado correspondiente.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-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 "Set-CsDialPlan"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Cadena de caracteres |
El único identificador que designa el ámbito o, en el caso de los planes por usuario, un nombre, para identificar el plan de marcado que desea modificar. Por ejemplo, la propiedad Identity de un sitio se especifica con el formato site:<sitename>, donde "sitename" es el nombre del sitio. Un plan de marcado en el ámbito de servicio 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 será un valor de cadena único. |
Instance |
Opcional |
LocationProfile |
Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales. Puede recuperar esta referencia de objeto llamando al cmdlet Get-CsDialPlan. |
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. El valor de este parámetro debe coincidir con la expresión regular [0-9]{1,4}. Esto significa que debe ser un valor con una longitud de uno a cuatro dígitos y estos dígitos, un número entre 0 y 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 se pueden modificar directamente con este cmdlet, se recomienda crear las reglas de normalización con el cmdlet New-CsVoiceNormalizationRule, que crea la regla y la asigna al plan de marcado especificado, y modificarlas con el 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. |
SimpleName |
Opcional |
Cadena de caracteres |
Nombre descriptivo del plan de marcado. Los nombres de los planes de marcado deben ser únicos en una instalación de Microsoft Lync Server 2010. 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(()). |
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. |
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.LocationProfile. Acepta la entrada transferida de objetos de plan de marcado.
Tipos de valores devueltos
Set-CsDialPlan no devuelve un valor u objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsDialPlan -Identity RedmondDialPlan -Description "This plan is for Redmond-based users only."
En el Ejemplo 1, se usa Set-CsDialPlan para modificar el plan de marcado con la Identidad RedmondDialPlan. En este caso, la única propiedad modificada es Description; tal modificación se realiza especificando el parámetro Description seguido del texto de la nueva descripción.
-------------------------- Ejemplo 2 --------------------------
Get-CsDialPlan | Set-CsDialPlan -ExternalAccessPrefix 8
En este ejemplo, Set-CsDialPlan se usa para cambiar el valor de la propiedad ExternalAccessPrefix para todos los planes de marcado configurados para su uso en la organización. Para ello, el comando primero llama a Get-CsDialPlan para devolver una colección de todos los planes de marcado de la organización. A continuación, la colección se transfiere a Set-CsDialPlan, que asigna el valor 8 a la propiedad ExternalAccessPrefix para cada uno de los perfiles de la colección.