Set-UMDialplan

Artigo
09/30/2014

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2012-03-26

O cmdlet Set-UMDialplan pode ser usado para definir várias propriedades em um plano de discagem de UM (Unificação de Mensagens).

Sintaxe

Set-UMDialPlan -Identity <UMDialPlanIdParameter> [-AccessTelephoneNumbers <MultiValuedProperty>] [-AllowDialPlanSubscribers <$true | $false>] [-AllowedInCountryOrRegionGroups <MultiValuedProperty>] [-AllowedInternationalGroups <MultiValuedProperty>] [-AllowExtensions <$true | $false>] [-AudioCodec <G711 | Wma | Gsm>] [-AutomaticSpeechRecognitionEnabled <$true | $false>] [-CallSomeoneEnabled <$true | $false>] [-ConfiguredInCountryOrRegionGroups <MultiValuedProperty>] [-ConfiguredInternationalGroups <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-ContactAddressList <AddressListIdParameter>] [-ContactRecipientContainer <OrganizationalUnitIdParameter>] [-ContactScope <DialPlan | GlobalAddressList | Extension | AutoAttendantLink | AddressList>] [-CountryOrRegionCode <String>] [-DefaultLanguage <UMLanguage>] [-DialByNamePrimary <LastFirst | FirstLast | SMTPAddress>] [-DialByNameSecondary <LastFirst | FirstLast | SMTPAddress | None>] [-DomainController <Fqdn>] [-EquivalenceDialPlan <Guid>] [-Extension <String>] [-FaxEnabled <$true | $false>] [-FDSPollingInterval <Int32>] [-InCountryOrRegionNumberFormat <NumberFormat>] [-InfoAnnouncementEnabled <True | False | Uninteruptible>] [-InfoAnnouncementFilename <String>] [-InputFailuresBeforeDisconnect <Int32>] [-InputRetries <Int32>] [-InputTimeout <Int32>] [-InternationalAccessCode <String>] [-InternationalNumberFormat <NumberFormat>] [-LogonFailuresBeforeDisconnect <Int32>] [-MatchedNameSelectionMethod <Title | Department | Location | None | PromptForAlias>] [-MaxCallDuration <Int32>] [-MaxRecordingDuration <Int32>] [-Name <String>] [-NationalNumberPrefix <String>] [-NDREnabled <$true | $false>] [-OperatorExtension <String>] [-OutsideLineAccessCode <String>] [-PromptPublishingPoint <String>] [-RecordingIdleTimeout <Int32>] [-SendVoiceMsgEnabled <$true | $false>] [-TUIPromptEditingEnabled <$true | $false>] [-UMAutoAttendant <UMAutoAttendantIdParameter>] [-VoIPSecurity <SIPSecured | Unsecured | Secured>] [-WelcomeGreetingEnabled <$true | $false>] [-WelcomeGreetingFilename <String>] [-WhatIf [<SwitchParameter>]]

Set-UMDialPlan [-AccessTelephoneNumbers <MultiValuedProperty>] [-AllowDialPlanSubscribers <$true | $false>] [-AllowedInCountryOrRegionGroups <MultiValuedProperty>] [-AllowedInternationalGroups <MultiValuedProperty>] [-AllowExtensions <$true | $false>] [-AudioCodec <G711 | Wma | Gsm>] [-AutomaticSpeechRecognitionEnabled <$true | $false>] [-CallSomeoneEnabled <$true | $false>] [-ConfiguredInCountryOrRegionGroups <MultiValuedProperty>] [-ConfiguredInternationalGroups <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-ContactAddressList <AddressListIdParameter>] [-ContactRecipientContainer <OrganizationalUnitIdParameter>] [-ContactScope <DialPlan | GlobalAddressList | Extension | AutoAttendantLink | AddressList>] [-CountryOrRegionCode <String>] [-DefaultLanguage <UMLanguage>] [-DialByNamePrimary <LastFirst | FirstLast | SMTPAddress>] [-DialByNameSecondary <LastFirst | FirstLast | SMTPAddress | None>] [-DomainController <Fqdn>] [-EquivalenceDialPlan <Guid>] [-Extension <String>] [-FaxEnabled <$true | $false>] [-FDSPollingInterval <Int32>] [-InCountryOrRegionNumberFormat <NumberFormat>] [-InfoAnnouncementEnabled <True | False | Uninteruptible>] [-InfoAnnouncementFilename <String>] [-InputFailuresBeforeDisconnect <Int32>] [-InputRetries <Int32>] [-InputTimeout <Int32>] [-Instance <UMDialPlan>] [-InternationalAccessCode <String>] [-InternationalNumberFormat <NumberFormat>] [-LogonFailuresBeforeDisconnect <Int32>] [-MatchedNameSelectionMethod <Title | Department | Location | None | PromptForAlias>] [-MaxCallDuration <Int32>] [-MaxRecordingDuration <Int32>] [-Name <String>] [-NationalNumberPrefix <String>] [-NDREnabled <$true | $false>] [-OperatorExtension <String>] [-OutsideLineAccessCode <String>] [-PromptPublishingPoint <String>] [-RecordingIdleTimeout <Int32>] [-SendVoiceMsgEnabled <$true | $false>] [-TUIPromptEditingEnabled <$true | $false>] [-UMAutoAttendant <UMAutoAttendantIdParameter>] [-VoIPSecurity <SIPSecured | Unsecured | Secured>] [-WelcomeGreetingEnabled <$true | $false>] [-WelcomeGreetingFilename <String>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet Set-UMDialplan permite alterar ou modificar as propriedades de um plano de discagem de UM existente. Algumas propriedades do plano de discagem de UM são obrigatórias e criadas por padrão. No entanto, em alguns casos, depois que o plano de discagem de UM for criado, nem todas as suas propriedades serão graváveis. Portanto, algumas das propriedades não poderão ser alteradas, a menos que o plano de discagem de UM existente seja excluído e um novo seja criado.

Importante

Os planos de discagem de UM são importantes para o funcionamento da Unificação de Mensagens. Modificações feitas em um plano de discagem de UM existente devem ser executadas por um administrador que compreenda as implicações dessas alterações.

Para executar o cmdlet Set-UMDialplan, você deve usar uma conta à qual esteja delegada a função de Administrador da Organização do Exchange.

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro	Necessário(s)	Tipo	Descrição
Identity	Necessário(s)	Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter	Esse parâmetro especifica a identificação do plano de discagem de UM; ele é o identificador do objeto de diretório do plano de discagem de UM. Este parâmetro é usado para vincular caixas de correio a planos de discagem e servidores de Unificação de Mensagens a planos de discagem.
AccessTelephoneNumbers	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Esse parâmetro especifica um único número piloto válido de mensagem de voz ou uma lista de números pilotos válidos de mensagem de voz. Essa lista será apresentada ao administrador quando um usuário estiver sendo habilitado para Unificação de Mensagens.
AllowDialPlanSubscribers	Opcional	System.Boolean	Esse parâmetro especifica se os assinantes poderão discar números que resolvam para um assinante do mesmo plano de discagem. O padrão é `$true`.
AllowedInCountryOrRegionGroups	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Esse parâmetro especifica a lista de nomes de país/região do mesmo grupo de discagem que podem ser discados. O nome do grupo de países/regiões permitido deve corresponder ao nome do grupo especificado no plano de discagem de UM.
AllowedInternationalGroups	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Esse parâmetro especifica a lista de nomes de grupo de discagem internacional que são permitidos. O nome do grupo de discagem internacional deve corresponder ao nome do grupo especificado no plano de discagem.
AllowExtensions	Opcional	System.Boolean	Esse parâmetro especifica se chamadas para ramais do plano de discagem serão permitidas. O padrão é `$false`.
AudioCodec	Opcional	Microsoft.Exchange.Data.Directory.SystemConfiguration.AudioCodecEnum	Esse parâmetro especifica o codec de áudio que é usado para gravação. WMA é a configuração padrão.
AutomaticSpeechRecognitionEnabled	Opcional	System.Boolean	Esse parâmetro especifica se o reconhecimento de fala está habilitado para usuários que são membros do plano de discagem.
CallSomeoneEnabled	Opcional	System.Boolean	Esse parâmetro especifica se o recurso Chamar Alguém está habilitado.
ConfiguredInCountryOrRegionGroups	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Esse parâmetro especifica os grupos locais que podem ser usados. Cada cadeia de caracteres é constituída de quatro partes: Um nome de grupo (até 32 caracteres) AllowedNumberString DialNumberString TextComment
ConfiguredInternationalGroups	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Esse parâmetro especifica os grupos internacionais que podem ser usados. Cada cadeia de caracteres é constituída de quatro partes: Um nome de grupo (até 32 caracteres) AllowedNumberString DialNumberString TextComment
Confirm	Opcional	System.Management.Automation.SwitchParameter	Esse parâmetro faz com que o comando pause o processamento e exige que o administrador confirme o que o comando fará antes que o processamento continue. O valor padrão é $true.
ContactAddressList	Opcional	Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter	Esse parâmetro especifica a identidade da lista de endereços. Se o parâmetro ContactScope for definido como AddressList, ele definirá o escopo para pesquisas de diretório.
ContactRecipientContainer	Opcional	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	Esse é o nome ou a identidade do contêiner que será usado para pesquisas de diretório.
ContactScope	Opcional	Microsoft.Exchange.Data.Directory.SystemConfiguration.CallSomeoneScopeEnum	Esse parâmetro especifica o escopo da pesquisa de diretório que será fornecido aos chamadores quando eles acessarem o plano de discagem de UM e especificarem um nome de usuário.
CountryOrRegionCode	Opcional	System.String	Este parâmetro especifica o código de determinado país ou região. Esse código é o número de um país ou região específica(o) que será discado. Por exemplo, 1 nos Estados Unidos.
DefaultLanguage	Opcional	Microsoft.Exchange.Data.UMLanguage	Esse parâmetro especifica o idioma padrão do sistema. O idioma padrão é selecionado na lista de idiomas disponíveis. O padrão é Inglês (EUA).
DialByNamePrimary	Opcional	Microsoft.Exchange.Data.Directory.SystemConfiguration.DialByNamePrimaryEnum	Esse parâmetro especifica se a chave de pesquisa Discar por Nome deve ser criada a partir da origem especificada. O padrão é Sobrenome, Nome.
DialByNameSecondary	Opcional	Microsoft.Exchange.Data.Directory.SystemConfiguration.DialByNameSecondaryEnum	Esse parâmetro especifica se a chave de pesquisa Discar por Nome secundária deve ser criada a partir da origem especificada. O padrão é SMTP (Simple Mail Transfer Protocol).
DomainController	Opcional	Microsoft.Exchange.Data.Fqdn	Esse parâmetro especifica o nome de domínio totalmente qualificado do controlador de domínio que grava essa alteração de configuração no serviço de diretório Active Directory.
EquivalenceDialPlan	Opcional	System.Guid	Esse parâmetro especifica o nome do plano de discagem de equivalência em outra floresta. Quando um plano de discagem de telefonia abrange duas florestas e quando um segundo objeto do plano de discagem é criado, a GUID do plano de discagem original é copiada para o endereço de proxy do usuário da outra floresta.
Extension	Opcional	System.String	Esse parâmetro especifica o número do ramal que é usado pelo recurso Chamar Alguém quando uma chamada é transferida.
FaxEnabled	Opcional	System.Boolean	Esse parâmetro especifica se o sistema oferece suporte para fax. O servidor de Unificação de Mensagens não carregará os componentes de fax se o plano de discagem não oferecer suporte para fax. O padrão é `$true`.
FDSPollingInterval	Opcional	System.Int32	Intervalo, em minutos, entre as verificações de novo conteúdo feitas pelo Serviço de Distribuição de Arquivos no ponto de publicação. O intervalo varia de 1 a 1.440 minutos. O padrão é 5 minutos.
InCountryOrRegionNumberFormat	Opcional	Microsoft.Exchange.Data.NumberFormat	Esse parâmetro especifica a cadeia de caracteres de prefixo a ser usada e o número de dígitos a serem obtidos no diretório. Esse número é usado em discagens para este plano de discagem dentro do mesmo código de país ou região.
InfoAnnouncementEnabled	Opcional	Microsoft.Exchange.Data.Directory.SystemConfiguration.InfoAnnouncementEnabledEnum	Esse parâmetro especifica se o informe está habilitado. Pode ser definido como Habilitado, Desabilitado ou Ininterrupto. O padrão é `$true`.
InfoAnnouncementFilename	Opcional	System.String	Esse parâmetro especifica o nome do arquivo de áudio de um informe.
InputFailuresBeforeDisconnect	Opcional	System.Int32	Esse parâmetro especifica o número de erros de entrada sucessivos do usuário que serão permitidos até que a chamada seja desconectada. O padrão é 3.
InputRetries	Opcional	System.Int32	Esse parâmetro especifica quantas vezes um chamador poderá inserir entradas quando o sistema atingir o tempo limite. Isso se aplica a usuários autenticados e também ao atendimento de chamadas ou ao atendedor automático. O padrão é 3.
InputTimeout	Opcional	System.Int32	Esse parâmetro especifica o tempo que o sistema aguardará pela entrada do usuário. Esse limite se aplica a usuários autenticados e também ao atendimento de chamadas ou ao atendedor automático. O padrão é 5 segundos.
Instance	Opcional	Microsoft.Exchange.Data.Directory.SystemConfiguration.UMDialPlan	Esse parâmetro especifica o parâmetro de entrada que representa um novo objeto de plano de discagem.
InternationalAccessCode	Opcional	System.String	Esse parâmetro especifica o código acrescentado antes de um número de telefone em chamadas internacionais. Por exemplo, 011 para ligar para os Estados Unidos.
InternationalNumberFormat	Opcional	Microsoft.Exchange.Data.NumberFormat	Esse parâmetro especifica a cadeia de caracteres de prefixo a ser usada e o número de dígitos a serem obtidos no diretório ao discar para este plano de discagem a partir de um código de país diferente.
LogonFailuresBeforeDisconnect	Opcional	System.Int32	Esse parâmetro especifica o número de tentativas de logon malsucedidas sucessivas que podem ser feitas até que a chamada seja desconectada. O padrão é 3.
MatchedNameSelectionMethod	Opcional	Microsoft.Exchange.Data.Directory.SystemConfiguration.DisambiguationFieldEnum	Esse parâmetro especifica a seleção a ser usada para diferenciar entre usuários com nomes que correspondem à entrada de discagem por tom ou entrada de fala. Essa configuração pode ser definida da seguinte maneira: Department Title Local Nenhum Prompt por alias Herdado do plano de discagem de UM
MaxCallDuration	Opcional	System.Int32	Esse parâmetro especifica a duração máxima de uma chamada para que ela seja interrompida e desconectada. O padrão é 30 minutos.
MaxRecordingDuration	Opcional	System.Int32	Esse parâmetro especifica o tempo máximo de gravação das mensagens. Isso inclui todos os tipos de chamadas. Esse valor pode ser definido entre 5 e 100. A configuração desse valor muito baixo pode fazer com que as chamadas de voz longas sejam desconectadas antes de serem concluídas. A configuração de um valor muito alto permite que os usuários salvam mensagens de voz prolongadas em suas Caixas de entrada. Para o Exchange 2007 Service Pack 2 (SP2), o valor desta configuração pode ser entre 1 e 100.
Name	Opcional	System.String	Esse parâmetro especifica o nome para exibição a ser usado para o plano de discagem de UM. Este nome é limitado a 64 caracteres.
NationalNumberPrefix	Opcional	System.String	Esse parâmetro especifica o código acrescentado antes de um número de telefone em chamadas interurbanas. Por exemplo, 1 na América do Norte.
NDREnabled	Opcional	System.Boolean	Esse parâmetro especifica se mensagens de atendimento de chamada de UM enviadas solicitarão NDRs (notificações de falha na entrega). Se esse parâmetro for definido como `$false`, as mensagens serão enviadas sem solicitações de NDRs. O padrão é `$false`.
OperatorExtension	Opcional	System.String	Esse parâmetro especifica o número do ramal do operador. Se esse parâmetro não for especificado, o recurso Não Permitir Transferência para Operador não estará disponível.
OutsideLineAccessCode	Opcional	System.String	Este parâmetro especifica o código acrescentado antes de um número de telefone para discar um número de telefone local externo. Esse código também é chamado de código de acesso ao tronco. O padrão é 9.
PromptPublishingPoint	Opcional	System.String	Esse parâmetro especifica o caminho dos compartilhamentos de arquivos do MicrosoftWindows do servidor e onde os prompts personalizados residirão. O caminho padrão é definido para o primeiro servidor de Unificação de Mensagens quando ele é adicionado a um plano de discagem de UM.
RecordingIdleTimeout	Opcional	System.Int32	Esse parâmetro especifica por quanto tempo um chamador poderá ficar em silêncio durante a gravação de uma mensagem de voz para que a gravação seja encerrada. O padrão é 5 segundos.
SendVoiceMsgEnabled	Opcional	System.Boolean	Esse parâmetro especifica se o recurso Enviar Mensagem está habilitado.
TUIPromptEditingEnabled	Opcional	System.Boolean	Esse parâmetro especifica se usuários autorizados têm permissão para gravar prompts de plano de discagem de UM ou de atendedor automático usando a interface de telefone (TUI). A configuração padrão é `$false`.
UMAutoAttendant	Opcional	Microsoft.Exchange.Configuration.Tasks.UMAutoAttendantIdParameter	Esse parâmetro especifica o atendedor automático executado quando o chamador pressiona a tecla de asterisco (*). Se esse parâmetro for especificado, ele substituirá o recurso Chamar Alguém.
VoIPSecurity	Opcional	Microsoft.Exchange.Data.Directory.SystemConfiguration.UMVoIPSecurityType	Este parâmetro especifica se o tráfego Voice over IP (VoIP) não é criptografado ou que o canal de sinalização ou os canais de mídia e sinalização são criptografados usando a MTLS (Mutual Transport Layer Security). A configuração padrão é `UnSecured`.
WelcomeGreetingEnabled	Opcional	System.Boolean	Esse parâmetro especifica se a saudação personalizada de boas-vindas está habilitada. O padrão é `$false`.
WelcomeGreetingFilename	Opcional	System.String	Este parâmetro especifica o nome do arquivo de áudio da saudação de boas-vindas.
WhatIf	Opcional	System.Management.Automation.SwitchParameter	Este parâmetro instrui o comando a simular as ações que ele executaria no objeto. Ao usar o parâmetro WhatIf, o administrador poderá visualizar quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. O valor padrão é $true.

Tipos de entrada

Tipos de retorno

Erros

Erro	Descrição

Exceções

Exceções	Descrição

Exemplo

O primeiro exemplo configura um plano de discagem de UM denominado MyUMDialPlan para usar 9 como código de acesso à linha externa.

O segundo exemplo configura um plano de discagem de UM denominado MyUMDialPlan para usar uma saudação de boas-vindas.

O terceiro exemplo configura um plano de discagem de UM denominado MyUMDialPlan com regras de discagem.

Set-UMDialPlan -Identity MyDialPlan -OutsideLineAccessCode 9

Set-UMDialPlan -Identity MyDialPlan -WelcomeGreetingEnabled $true -WelcomeGreetingFilename welcome.wav

$csv=import-csv "C:\MyInCountryGroups.csv"
Set-UMDialPlan -Identity MyDialPlan -ConfiguredInCountryGroups $csv
Set-UMDialPlan -Identity MyDialPlan -AllowedInCountryGroups "local, long distance"

Share via