Compartilhar via


Set-UMDialplan (RTM)

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2012-03-26

O cmdlet Set-UMDialplan pode ser usado para definir várias propriedades em um plano de discagem do 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>] [-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>] [-WelcomeGreetingEnabled <$true | $false>] [-WelcomeGreetingFilename <String>]

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>] [-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>] [-WelcomeGreetingEnabled <$true | $false>] [-WelcomeGreetingFilename <String>]

Descrição detalhada

O cmdlet Set-UMDialplan permite alterar ou modificar as propriedades de um plano de discagem do UM existente. Algumas propriedades do plano de discagem do UM são obrigatórias e criadas por padrão. No entanto, em alguns casos, depois que o plano de discagem do 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 do UM existente seja excluído e um novo seja criado.

Importante

Os planos de discagem do UM são importantes para o funcionamento da Unificação de Mensagens. Modificações feitas em um plano de discagem do 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 delegado o seguinte:

  • Função 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 Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

Esse parâmetro especifica a identificação do plano de discagem do UM; ele é o identificador do objeto de diretório do plano de discagem do 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 do 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

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 do 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.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar 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 do Active Directory, inclua o parâmetro DomainController no cmdlet.

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 do 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 Server 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 do 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 do 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 Windows 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 do 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 do 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

Esse parâmetro especifica se o canal de sinalização é criptografado usando MTLS. 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.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

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

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

O terceiro exemplo configura um plano de discagem do 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"