New-CsDialPlan
Tópico modificado em: 2012-03-27
Cria um novo plano de discagem.
Sintaxe
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>]]
Descrição Detalhada
Este cmdlet cria um novo plano de discagem (também conhecido como 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.
A criação de um plano de discagem cria automaticamente uma regra padrão de normalização de voz. As regras de normalização podem ser modificadas chamando-se o cmdlet Set-CsVoiceNormalizationRule. É possível adicionar novas regras de normalização a um plano de discagem chamando-se o cmdlet New-CsVoiceNormalizationRule.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsDialPlan localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsDialPlan"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
XdsIdentity |
Um identificador exclusivo que designa o escopo e nome (site), a função do serviço e o FQDN, ou o nome (por usuário), para identificar o plano de discagem. Por exemplo, uma Identidade de site seria inserida no formato site:<sitename>, onde sitename é o nome do site. Um plano de discagem no escopo do serviço deve ser um serviço de gateway do Registro ou da PSTN, no qual se formata o valor Identity da seguinte forma: Registrar:Redmond.litwareinc.com. Uma Identidade por usuário seria inserida simplesmente como um valor exclusivo de cadeia de caracteres. |
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 este parâmetro, se o plano de discagem for usado para conferências discadas. Isso permite que o número de acesso correto seja atribuído quando o organizador configurar 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. Este parâmetro deve corresponder à expressão regular [0-9]{1,4}. Isso significa que ele deve ter um valor entre 0 e 9, com um a quatro dígitos de comprimento. Padrão: 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 criadas diretamente com este cmdlet, recomendamos que você crie as regras de normalização com o cmdlet New-CsVoiceNormalizationRule, que cria a regra e a atribui ao plano de discagem especificado. A cada vez que se cria um novo plano de discagem, também se cria uma nova regra de normalização de voz com definições padrão para o respectivo site, serviço ou plano de discagem por usuário. Por padrão, a Identidade da nova regra de normalização é a Identidade do plano de discagem, seguida de uma barra e do nome Prefix All. Por exemplo, site:Redmond/Prefix All. Padrão: {Description=;Pattern=^(\d11)$;Translation=+$1;Name=Prefix All;IsInternalExtension=False } Nota: Este padrão é apenas um marcador. Para que o plano de discagem seja útil, deve-se modificar a regra de normalização criada pelo plano de discagem ou criar uma nova regra para o site, serviço ou usuário. É possível criar uma nova regra de normalização, chamando-se o cmdlet New-CsVoiceNormalizationRule; e modificar uma regra de normalização, chamando-se Set-CsVoiceNormalizationRule. |
OptimizeDeviceDialing |
Opcional |
Booleano |
A definição desse parâmetro como True aplicará o prefixo no parâmetro ExternalAccessPrefix às chamadas feitas fora da organização. Este valor poderá ser definido como True apenas se tiver sido especificado um valor para o parâmetro ExternalAccessPrefix. Padrão: False |
SimpleName |
Opcional |
Cadeia de caracteres |
Um nome para exibição para o plano de discagem. Este nome deve ser exclusivo entre todos os planos de discagem na implantação do Lync Server. 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 (()). Este parâmetro deve conter um valor. Contudo, caso não seja fornecido um valor na chamada a New-CsDialPlan, será utilizado um valor padrão. O valor padrão de um plano de discagem global é Prefix All. O valor padrão de um plano de discagem no nível de site é o nome do site. O padrão de um serviço é o nome do serviço (Registrador ou gateway PSTN), seguido de um sinal de sublinhado e do nome de domínio totalmente qualificado (FQDN). Por exemplo: Registrar_pool0.litwareinc.com. O padrão de um plano de discagem por usuário é a sua Identidade. |
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. |
InMemory |
Opcional |
SwitchParameter |
Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet. |
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
Nenhuma.
Tipos de Retorno
Este cmdlet cria um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile.
Exemplo
-------------------------- Exemplo 1 --------------------------
New-CsDialPlan -Identity RedmondDialPlan
O comando mostrado no Exemplo 1 cria um novo plano de discagem com a identidade RedmondDialPlan. (a ausência de um escopo no valor de Identity indica que esta é uma política por usuário. Os planos de discagem criados no escopo por usuário podem ser atribuídos diretamente a usuários e grupos). Todas as outras propriedades do plano de discagem serão atribuídas com valores padrão.
-------------------------- Exemplo 2 --------------------------
New-CsDialPlan -Identity site:Redmond -SimpleName RedmondSiteDialPlan
New-CsVoiceNormalizationRule -Identity "site:Redmond/SeattlePrefix" -Pattern "^9(\d*){1,5}$" -Translation "+1206$1"
Os comandos mostrados no Exemplo 2 criam um novo plano de discagem com a Identidade site:Redmond (indicando que o plano de discagem se aplicará a todos os usuários do site de Redmond que não possuírem um plano de discagem por usuário ou em nível de serviço a eles atribuído) e com SimpleName igual a RedmondSiteDialPlan. A próxima linha do exemplo cria uma nova regra de normalização associada ao plano. A regra de normalização padrão é criada para um plano de discagem, mas ela atua principalmente como um marcador; os valores têm uso limitado. Portanto, depois de chamar o cmdlet New-CsDialPlan para criar um novo plano de discagem, deve se chamar o cmdletNew-CsVoiceNormalizationRule, para criar uma regra nomeada que seja funcional na organização. A linha 2 do exemplo faz exatamente isso: ela chama o cmdlet New-CsVoiceNormalizationRule e cria uma regra para o site de Redmond com o nome SeattlePrefix, especificando as propriedades Pattern e Translation da regra. Nenhuma etapa adicional precisa ser seguida para modificar o plano de discagem; as alterações à regra de normalização serão aplicadas automaticamente ao plano de discagem cuja identidade corresponder à da regra de normalização (a parte site:Redmond da identidade corresponde à identidade do plano de discagem; SeattlePrefix é o nome da regra de normalização. É possível aplicar diversas regras de normalização a um plano de discagem. Assim, cada regra de normalização necessitará de um nome exclusivo em um determinado escopo).
-------------------------- Exemplo 3 --------------------------
New-CsDialPlan -Identity RedmondDialPlan -Description "Dial plan for Redmond users"
O comando mostrado no Exemplo 3 cria um novo plano de discagem com a identidade RedmondDialPlan e especifica uma Description, para explicar o objetivo do plano de discagem. (os planos de discagem criados no escopo por usuário podem ser atribuídos diretamente aos usuários e grupos). Os valores padrão serão atribuídos a todos os outros parâmetros.