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"