Set-CsDialPlan
Tópico modificado em: 2012-03-27
Modifica um plano de discagem existente.
Sintaxe
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>]]
Descrição Detalhada
Este cmdlet modifica um plano de discagem existente (também conhecido como um perfil de local). Os planos de discagem fornecem as informações necessárias para habilitar os usuários do Enterprise Voice a fazerem chamadas telefônicas. Os planos de discagem também são utilizados pelo Aplicativo Atendedor de Conferência para efetuar conferências discadas. Um plano de discagem determina, por exemplo, quais regras de normalização serão aplicadas e se um prefixo deverá ser discado para se efetuar chamadas externas.
Observação: Embora as regras de normalização de um plano de discagem possam ser modificadas com esse cmdlet, é recomendado que se utilizem os cmdlets New-CsVoiceNormalizationRule, Set-CsVoiceNormalizationRule, ou Remove-CsVoiceNormalizationRule. As alterações feitas com esses cmdlets serão refletidas no plano de discagem correspondente.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsDialPlan localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsDialPlan"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
Cadeia de caracteres |
O identificador exclusivo que indica o escopo ou, para planos por usuário, um nome, para identificar o plano de discagem que se deseja modificar. Por exemplo, uma Identidade de site estará no formato site:<sitename>, onde sitename é o nome do site. Um plano de discagem no escopo de serviço será um Registrador ou serviço de gateway PSTN, em que o valor de Identity está formatado da seguinte maneira: Registrar:Redmond.litwareinc.com. Uma Identidade por usuário será um valor exclusivo de cadeia de caracteres. |
Instance |
Opcional |
LocationProfile |
Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais. É possível recuperar esse objeto, chamando-se o cmdlet Get-CsDialPlan. |
Description |
Opcional |
Cadeia de caracteres |
Uma descrição deste plano de discagem – para que serve, a que tipo de usuário se aplica ou qualquer outra informação que seja útil na identificação do propósito do plano de discagem. Máximo de caracteres: 512 |
DialinConferencingRegion |
Opcional |
Cadeia de caracteres |
O nome da região associada a este plano de discagem. Especifique um valor para esse parâmetro, se o plano de discagem for usado para uma conferência discada. Isso permite que o número de acesso correto seja atribuído quando o organizador da conferência definir a conferência. As regiões disponíveis podem ser recuperadas chamando o cmdlet Get-CsNetworkRegion. Máximo de caracteres: 512 |
ExternalAccessPrefix |
Opcional |
Cadeia de caracteres |
Um número (ou conjunto de números) que designa a chamada como externa à organização. (Por exemplo, para discar uma linha externa, primeiro pressione 9.) Este prefixo será ignorado pelas regras de normalização, embora essas regras sejam aplicadas ao restante do número. O parâmetro OptimizeDeviceDialing deve ser definido como True, para que este valor tenha efeito. O valor deste parâmetro deve corresponder à expressão regular [0-9]{1,4}. Isto significa que ele deve ter um valor com um a quatro dígitos de comprimento e cada dígito deve ser um número de 0 a 9. |
NormalizationRules |
Opcional |
PSListModifier |
Uma lista de regras de normalização que são aplicadas a este plano de discagem. Embora esta lista e essas regras possam ser modificadas diretamente com este cmdlet, é recomendável se criar as regras de normalização com o cmdlet New-CsVoiceNormalizationRule, que cria a regra e a atribui ao plano de discagem especificado, e modificá-las com o cmdlet Set-CsVoiceNormalizationRule. |
OptimizeDeviceDialing |
Opcional |
Booleano |
A definição desse parâmetro como True aplicará o prefixo no parâmetro ExternalAccessPrefix para chamadas feitas fora da organização. Esse valor pode ser definido como True apenas se tiver sido especificado um valor para o parâmetro ExternalAccessPrefix. |
SimpleName |
Opcional |
Cadeia de caracteres |
Um nome amigável para o plano de discagem. Os nomes do plano de discagem devem ser exclusivos entre todos os planos de discagem de uma implantação do Microsoft Lync Server 2010. Esta cadeia de caracteres pode ter no máximo 256 caracteres. Os caracteres válidos são caracteres alfabéticos ou numéricos, o hífen (-), ponto (.), sinal de adição (+), sublinhado (_) e parênteses (()). |
State |
Opcional |
Cadeia de caracteres |
Este parâmetro não é usado com este cmdlet. |
City |
Opcional |
Cadeia de caracteres |
Este parâmetro não é usado com este cmdlet. |
CountryCode |
Opcional |
Cadeia de caracteres |
Este parâmetro não é usado com este cmdlet. |
Force |
Opcional |
SwitchParameter |
Suprime quaisquer avisos de confirmação antes de se efetuar as alterações. |
WhatIf |
Opcional |
SwitchParameter |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
SwitchParameter |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile. Aceita a entrada em pipeline de objetos de plano de discagem.
Tipos de Retorno
Set-CsDialPlan não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile.
Exemplo
-------------------------- Exemplo 1 --------------------------
Set-CsDialPlan -Identity RedmondDialPlan -Description "This plan is for Redmond-based users only."
No Exemplo 1, utiliza-se Set-CsDialPlan para modificar o plano de discagem com a identidade RedmondDialPlan. Neste caso, a única propriedade que é modificada é Description; esta modificação é realizada especificando-se o parâmetro Description, seguido do texto da nova descrição.
-------------------------- Exemplo 2 --------------------------
Get-CsDialPlan | Set-CsDialPlan -ExternalAccessPrefix 8
Neste exemplo, usa-se Set-CsDialPlan para modificar o valor da propriedade ExternalAccessPrefix de todos os planos de discagem configurados para uso na organização. Para fazer isso, o comando utiliza primeiramente Get-CsDialPlan, para retornar uma coleção de todos os planos de discagem na organização. Essa coleção será então canalizada para Set-CsDialPlan, que atribui o valor 8 à propriedade ExternalAccessPrefix de cada perfil na coleção.