Share via


Set-UMAutoAttendant

 

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

Tópico modificado em: 2007-06-28

O cmdlet Set-UMAutoAttendant modifica um atendedor automático do UM (Unificação de Mensagens) existente.

Sintaxe

Set-UMAutoAttendant -Identity <UMAutoAttendantIdParameter> [-AfterHoursKeyMapping <MultiValuedProperty>] [-AfterHoursKeyMappingEnabled <$true | $false>] [-AfterHoursMainMenuCustomPromptEnabled <$true | $false>] [-AfterHoursMainMenuCustomPromptFilename <String>] [-AfterHoursTransferToOperatorEnabled <$true | $false>] [-AfterHoursWelcomeGreetingEnabled <$true | $false>] [-AfterHoursWelcomeGreetingFilename <String>] [-AllowDialPlanSubscribers <$true | $false>] [-AllowedInCountryOrRegionGroups <MultiValuedProperty>] [-AllowedInternationalGroups <MultiValuedProperty>] [-AllowExtensions <$true | $false>] [-BusinessHoursKeyMapping <MultiValuedProperty>] [-BusinessHoursKeyMappingEnabled <$true | $false>] [-BusinessHoursMainMenuCustomPromptEnabled <$true | $false>] [-BusinessHoursMainMenuCustomPromptFilename <String>] [-BusinessHoursSchedule <ScheduleInterval[]>] [-BusinessHoursTransferToOperatorEnabled <$true | $false>] [-BusinessHoursWelcomeGreetingEnabled <$true | $false>] [-BusinessHoursWelcomeGreetingFilename <String>] [-CallSomeoneEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-ContactAddressList <AddressListIdParameter>] [-ContactRecipientContainer <OrganizationalUnitIdParameter>] [-ContactScope <DialPlan | GlobalAddressList | AddressList>] [-DomainController <Fqdn>] [-DTMFFallbackAutoAttendant <UMAutoAttendantIdParameter>] [-HolidaySchedule <MultiValuedProperty>] [-InfoAnnouncementEnabled <True | False | Uninteruptible>] [-InfoAnnouncementFilename <String>] [-Language <UMLanguage>] [-MatchedNameSelectionMethod <Title | Department | Location | None | PromptForAlias | InheritFromDialPlan>] [-Name <String>] [-NameLookupEnabled <$true | $false>] [-OperatorExtension <String>] [-PilotIdentifierList <MultiValuedProperty>] [-SendVoiceMsgEnabled <$true | $false>] [-SpeechEnabled <$true | $false>] [-TimeZone <String>] [-TimeZoneName <UMTimeZone>] [-WhatIf [<SwitchParameter>]]

Set-UMAutoAttendant [-AfterHoursKeyMapping <MultiValuedProperty>] [-AfterHoursKeyMappingEnabled <$true | $false>] [-AfterHoursMainMenuCustomPromptEnabled <$true | $false>] [-AfterHoursMainMenuCustomPromptFilename <String>] [-AfterHoursTransferToOperatorEnabled <$true | $false>] [-AfterHoursWelcomeGreetingEnabled <$true | $false>] [-AfterHoursWelcomeGreetingFilename <String>] [-AllowDialPlanSubscribers <$true | $false>] [-AllowedInCountryOrRegionGroups <MultiValuedProperty>] [-AllowedInternationalGroups <MultiValuedProperty>] [-AllowExtensions <$true | $false>] [-BusinessHoursKeyMapping <MultiValuedProperty>] [-BusinessHoursKeyMappingEnabled <$true | $false>] [-BusinessHoursMainMenuCustomPromptEnabled <$true | $false>] [-BusinessHoursMainMenuCustomPromptFilename <String>] [-BusinessHoursSchedule <ScheduleInterval[]>] [-BusinessHoursTransferToOperatorEnabled <$true | $false>] [-BusinessHoursWelcomeGreetingEnabled <$true | $false>] [-BusinessHoursWelcomeGreetingFilename <String>] [-CallSomeoneEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-ContactAddressList <AddressListIdParameter>] [-ContactRecipientContainer <OrganizationalUnitIdParameter>] [-ContactScope <DialPlan | GlobalAddressList | AddressList>] [-DomainController <Fqdn>] [-DTMFFallbackAutoAttendant <UMAutoAttendantIdParameter>] [-HolidaySchedule <MultiValuedProperty>] [-InfoAnnouncementEnabled <True | False | Uninteruptible>] [-InfoAnnouncementFilename <String>] [-Instance <UMAutoAttendant>] [-Language <UMLanguage>] [-MatchedNameSelectionMethod <Title | Department | Location | None | PromptForAlias | InheritFromDialPlan>] [-Name <String>] [-NameLookupEnabled <$true | $false>] [-OperatorExtension <String>] [-PilotIdentifierList <MultiValuedProperty>] [-SendVoiceMsgEnabled <$true | $false>] [-SpeechEnabled <$true | $false>] [-TimeZone <String>] [-TimeZoneName <UMTimeZone>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet Set-UMAutoAttendant permite alterar ou modificar as configurações de um atendedor automático do UM existente. Por padrão, alguns parâmetros do atendedor automático do UM são obrigatórios e são criados. Entretanto, depois que um atendedor automático do UM for criado, nem todas as propriedades do atendedor automático do UM serão graváveis. Portanto, alguns dos valores do atendedor automático do UM não podem ser alterados ou modificados, a menos que o atendedor automático do UM seja excluído e um novo seja criado.

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

Para obter mais informaçoes sobre permissoes, delegaçao de funçoes e os direitos necessários para administrar o Microsoft 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.UMAutoAttendantIdParameter

Este parâmetro especifica o identificador do atendedor automático do UM que está sendo visualizado. Esse parâmetro é o ID do objeto do diretório para o atendedor automático do UM.

AfterHoursKeyMapping

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica os mapeamentos de teclas a serem usados para fora do horário comercial para o atendedor automático do UM. Um mapeamento de teclas está definido como uma entrada em uma tabela com até 9 entradas. A tecla 0 é reservada para uma transferência para o operador.

Exemplo para uma tabela personalizada com 2 entradas:

“Sales, 77899”,"Service, 78990”.

O padrão é desabilitado.

AfterHoursKeyMappingEnabled

Opcional

System.Boolean

Esse parâmetro especifica se deve-se habilitar ou desabilitar mapeamentos de teclas para fora do horário comercial para o atendedor automático do UM. Um mapeamento de teclas está definido como uma entrada em uma tabela com até 9 entradas. A tecla 0 é reservada para uma transferência para o operador.

Exemplo para uma tabela personalizada com 2 entradas:

“Sales, 77899”,"Service, 78990”.

AfterHoursMainMenuCustomPromptEnabled

Opcional

System.Boolean

Esse parâmetro especifica se o menu principal personalizado de fora do horário comercial está habilitado. O padrão é desabilitado.

AfterHoursMainMenuCustomPromptFilename

Opcional

System.String

Esse parâmetro especifica o arquivo .wav a ser usado para o prompt do menu principal personalizado para fora do horário comercial.

AfterHoursTransferToOperatorEnabled

Opcional

System.Boolean

Esse parâmetro especifica se deve-se permitir a transferência de chamadas para o ramal do operador no fora do horário comercial.

AfterHoursWelcomeGreetingEnabled

Opcional

System.Boolean

Este parâmetro especifica se a saudação para horário não comercial está habilitada. O áudio padrão do sistema será usado se este parâmetro estiver definido como desabilitado. O padrão é desabilitado.

AfterHoursWelcomeGreetingFilename

Opcional

System.String

Este parâmetro especifica o arquivo.wav a ser usado para a mensagem de saudação para horário não comercial.

AllowDialPlanSubscribers

Opcional

System.Boolean

Este parâmetro especifica se deve-se permitir que os assinantes do plano de discagem disquem números que estejam determinados a um assinante do mesmo plano de discagem. O padrão é $true.

AllowedInCountryOrRegionGroups

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Este parâmetro especifica a lista de nomes de grupo de discagem de país/região que são permitidos. Os nomes devem corresponder aos nomes do grupo que são definidos no plano de discagem. A cadeia de caracteres deve ter menos de 128 caracteres.

AllowedInternationalGroups

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica a lista de nomes de grupo de discagem internacional que são permitidos. Os nomes devem corresponder aos nomes do grupo que são definidos no plano de discagem. A cadeia de caracteres deve ter menos de 128 caracteres.

AllowExtensions

Opcional

System.Boolean

Este parâmetro especifica se os chamadores são capazes de fazer chamadas para ramais com o mesmo número de dígitos que o número especificado no objeto do plano de discagem. O padrão é $false.

BusinessHoursKeyMapping

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Este parâmetro especifica os mapeamentos de teclas para o horário comercial para o atendedor automático do UM. Um mapeamento de teclas está definido como uma entrada em uma tabela com até 9 entradas. A tecla 0 é reservada para uma transferência para o operador.

Exemplo para uma tabela personalizada com 2 entradas:

“Sales, 77899”,"Service, 78990”.

O padrão é desabilitado.

BusinessHoursKeyMappingEnabled

Opcional

System.Boolean

Este parâmetro especifica se os menus personalizados para horário comercial estarão habilitados ou desabilitados. O padrão é desabilitado.

BusinessHoursMainMenuCustomPromptEnabled

Opcional

System.Boolean

Este parâmetro especifica se o prompt do menu principal personalizado de horário comercial está habilitado. O padrão é desabilitado.

BusinessHoursMainMenuCustomPromptFilename

Opcional

System.String

Esse parâmetro especifica o arquivo .wav a ser usado para o prompt do menu principal personalizado para horário comercial.

BusinessHoursSchedule

Opcional

Microsoft.Exchange.Common.ScheduleInterval[]

Este parâmetro especifica os horários em que a empresa está aberta.

BusinessHoursTransferToOperatorEnabled

Opcional

System.Boolean

Este parâmetro especifica se deve-se permitir a transferência de chamada para o ramal do operador durante o horário comercial.

BusinessHoursWelcomeGreetingEnabled

Opcional

System.Boolean

Este parâmetro especifica se a saudação para horário comercial personalizada está habilitada. O áudio padrão do sistema será usado se este parâmetro estiver definido como desabilitado. O padrão é desabilitado.

BusinessHoursWelcomeGreetingFilename

Opcional

System.String

Este parâmetro especifica o arquivo.wav a ser usado para a mensagem de boas-vindas.

CallSomeoneEnabled

Opcional

System.Boolean

Esse parâmetro especifica se o recurso Chamar Alguém está habilitado.

Confirm

Opcional

System.Management.Automation.SwitchParameter

Esse parâmetro faz com que o comando pause o processamento e exige que você 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

Este parâmetro especifica o nome ou a identidade do contêiner que será usado para pesquisas de diretório.

ContactScope

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.DialScopeEnum

Este parâmetro especifica o escopo da pesquisa de diretório que será fornecido aos chamadores quando eles acessarem o atendedor automático do UM e especificarem um nome de usuário.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Esse parâmetro especifica o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no serviço de diretório Active Directory.

DTMFFallbackAutoAttendant

Opcional

Microsoft.Exchange.Configuration.Tasks.UMAutoAttendantIdParameter

Este parâmetro especifica o atendedor automático de DTMF (Dual Tone Multi-Frequency) que será usado se o atendedor automático habilitado para fala não estiver disponível. Se o parâmetro SpeechEnabled estiver definido como $true, esse atendedor automático deverá ter um atendedor automático de DTMF associado para ser usado como o atendedor automático de fallback.

HolidaySchedule

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Este parâmetro especifica a agenda de feriados para a organização. O agendamento é formatado como uma matriz de cadeias de caracteres. Cada cadeia de caracteres contém três partes:

  • O nome, limitado a 64 caracteres.

  • O dia (data) do feriado.

  • O nome do arquivo para o prompt de áudio. O prompt de áudio estará no formato .wma.

Exemplo:

“Natal, 25/12/2005, Natal.wav”.

InfoAnnouncementEnabled

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.InfoAnnouncementEnabledEnum

Este parâmetro especifica se deve-se permitir a saudação informativa. A configuração padrão é $true.

InfoAnnouncementFilename

Opcional

System.String

Este parâmetro especifica o arquivo.wav a ser usado para o informe.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.UMAutoAttendant

Este parâmetro especifica o parâmetro de entrada do objeto do atendedor automático do UM. Esse parâmetro será necessário se o parâmetro Identity não for usado.

Language

Opcional

Microsoft.Exchange.Data.UMLanguage

Este parâmetro especifica o idioma usado pelo atendedor automático do UM. Este idioma é selecionado na lista de idiomas disponíveis do plano de discagem.

MatchedNameSelectionMethod

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.AutoAttendantDisambiguationFieldEnum

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:

  • Departamento

  • Cargo

  • Local

  • Nenhum

  • Prompt por alias

  • Herdado do plano de discagem do UM

Name

Opcional

System.String

Este parâmetro especifica o nome para exibição a ser usado para o atendedor automático do UM. Este nome é limitado a 64 caracteres.

NameLookupEnabled

Opcional

System.Boolean

Este parâmetro especifica se deve-se permitir que os chamadores executem pesquisas de diretório discando ou falando o nome. Esse parâmetro pode evitar que os chamadores se conectem a ramais desconhecidos.

OperatorExtension

Opcional

System.String

Esse parâmetro especifica o número do ramal do operador. Se esse parâmetro não estiver especificado, o operador do plano de discagem será usado. Se o operador do plano de discagem não for especificado, o recurso não será habilitado.

PilotIdentifierList

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica uma lista de um ou mais números pilotos. Números pilotos são usados para rotear chamadas de entrada para servidores de Unificação de Mensagens. Eles são, então, atendidos pelo atendedor automático.

SendVoiceMsgEnabled

Opcional

System.Boolean

Este parâmetro especifica se deve-se permitir o recurso Enviar Mensagem.

SpeechEnabled

Opcional

System.Boolean

Este parâmetro especifica se o atendedor automático está habilitado para fala. A configuração padrão do atendedor automático é DTMF.

Timezone

Opcional

System.String

Esse parâmetro especifica o fuso horário que será usado com o atendedor automático. O fuso horário padrão é a definição de fuso horário que está no servidor.

TimeZoneName

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.UMTimeZone

Esse parâmetro especifica todo ou parte de um nome para exibição do fuso horário do Microsoft Windows. A cadeia de caracteres é comparada aos nomes para exibição no Registro do sistema local para determinar uma correspondência "contém" simples. Um erro será retornado se ela não for exclusiva.

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, você poderá exibir 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

 

 

Exceções

Exceções Descrição

 

 

Exemplo

O primeiro exemplo configura um atendedor automático do UM denominado MySpeechEnabledAA para retornar para o MyDTMFAA, define o ramal dos operadores como 50100 e habilita transferências para esse ramal após o horário comercial.

O segundo exemplo configura um atendedor automático do UM denominado MyAutoAttendant cujo horário comercial está configurado para 10:45 às 13:15hs (domingo), 9:00 às 17:00hs (segunda-feira) e 9:00 às 16:30hs (sábado) e feriados, e suas saudações configuradas para "Ano Novo", em 2 de janeiro de 2006 e "Fechado para obras", de 24 a 28 de abril de 2006.

Set-UMAutoAttendant -Identity MySpeechEnabledAA -DTMFFallbackAutoAttendant MyDTMFAA -OperatorExtension 50100 -AfterHoursTransferToOperatorEnabled $true

Set-UMAutoAttendant -Identity MyUMAutoAttendant -BusinessHoursSchedule 0.10:45-0.13:15,1.09:00-1.17:00,6.09:00-6.16:30 -HolidaySchedule "New Year,newyrgrt.wav,1/2/2006","Building Closed for Construction,construction.wav,4/24/2006,4/28/2006"