Set-UMMailbox

  • Artigo

 

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

Tópico modificado em: 2009-05-13

O cmdlet Set-UMMailbox define as propriedades de UM (Unificação de Mensagens) para um usuário que esteja habilitado para UM no momento.

Sintaxe

Set-UMMailbox -Identity <MailboxIdParameter> [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AnonymousCallersCanLeaveMessages <$true | $false>] [-AutomaticSpeechRecognitionEnabled <$true | $false>] [-CallAnsweringAudioCodec <G711 | Wma | Gsm>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FaxEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-MissedCallNotificationEnabled <$true | $false>] [-Name <String>] [-OperatorNumber <String>] [-SubscriberAccessEnabled <$true | $false>] [-TUIAccessToAddressBookEnabled <$true | $false>] [-TUIAccessToCalendarEnabled <$true | $false>] [-TUIAccessToEmailEnabled <$true | $false>] [-UMMailboxPolicy <MailboxPolicyIdParameter>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Set-UMMailbox [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AnonymousCallersCanLeaveMessages <$true | $false>] [-AutomaticSpeechRecognitionEnabled <$true | $false>] [-CallAnsweringAudioCodec <G711 | Wma | Gsm>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FaxEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <UMMailbox>] [-MissedCallNotificationEnabled <$true | $false>] [-Name <String>] [-OperatorNumber <String>] [-SubscriberAccessEnabled <$true | $false>] [-TUIAccessToAddressBookEnabled <$true | $false>] [-TUIAccessToCalendarEnabled <$true | $false>] [-TUIAccessToEmailEnabled <$true | $false>] [-UMMailboxPolicy <MailboxPolicyIdParameter>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet Set-UMMailbox permite definir as propriedades de UM associadas a um usuário que foi habilitado para UM. Muitas das propriedades de UM do usuário são armazenadas na caixa de correio do usuário e outras são armazenadas no serviço de diretório do Active Directory. Esse cmdlet pode ser usado para definir propriedades de UM individualmente com o parâmetro Identity ou Instance.

Para executar o cmdlet Set-UMMailbox, você deve usar a conta à qual esteja delegada a função Administrador de Destinatários 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 Tipo Descrição

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Este parâmetro especifica o usuário a ser habilitado para Unificação de Mensagens. As variáveis desse parâmetro incluem:

  • ADObjectID

  • GUID

  • DN

  • Domínio\Conta

  • UPN

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

Este parâmetro será necessário se o parâmetro Instance não for usado.

AllowUMCallsFromNonUsers

Opcional

Microsoft.Exchange.Data.Directory.Recipient.AllowUMCallsFromNonUsersFlags

Esse parâmetro especifica se deve excluir a caixa de correio das pesquisas de diretório.

AnonymousCallersCanLeaveMessages

Opcional

System.Boolean

Esse parâmetro especifica se as chamadas desviadas sem ID de chamador terão permissão para deixar uma mensagem.

AutomaticSpeechRecognitionEnabled

Opcional

System.Boolean

Esse parâmetro especifica se o usuário pode usar Reconhecimento Automático de Fala ao fazer logon na caixa de correio. Esse parâmetro só poderá ser definido como $true se houver suporte de ASR para o idioma selecionado pelo usuário em Opções do Outlook Web Access.

CallAnsweringAudioCodec

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.AudioCodecEnum

Esse parâmetro especifica o codec de áudio a ser usado para mensagens de atendimento de chamadas. O padrão para a caixa de correio do usuário é o codec de áudio que está configurado no plano de discagem de UM.

Confirm

Optional

System.Management.Automation.SwitchParameter

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

DisplayName

Opcional

System.String

Esse parâmetro especifica o nome para exibição do usuário.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

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

FaxEnabled

Opcional

System.Boolean

Esse parâmetro especifica se um usuário tem permissão para receber fax de entrada.

IgnoreDefaultScope

Optional

System.Management.Automation.SwitchParameter

Esse parâmetro instrui o comando a ignorar a configuração padrão de escopo de destinatário do Shell de Gerenciamento do Exchange e usar toda a floresta como escopo. Isso permite que o comando acesse objetos do Active Directory que não estejam atualmente no escopo padrão. O uso do parâmetro IgnoreDefaultScope introduz as seguintes restrições:

  • Você não pode usar o parâmetro DomainController. O comando usará automaticamente um servidor de catálogo global adequado.

  • Você pode usar o DN somente para o parâmetro Identity. Outras formas de identificação, como alias ou GUID, não são aceitas.

Instance

Opcional

Microsoft.Exchange.Data.Directory.Management.UMMailbox

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

MissedCallNotificationEnabled

Opcional

System.Boolean

Esse parâmetro especifica se devem ser enviadas notificações de chamada não atendida.

Name

Opcional

System.String

Esse parâmetro especifica o nome para exibição do usuário. O nome para exibição é limitado a 64 caracteres.

OperatorNumber

Opcional

System.String

Esse parâmetro especifica a cadeia de caracteres de dígitos para o operador pessoal.

SubscriberAccessEnabled

Opcional

System.Boolean

Esse parâmetro especifica se o acesso de assinante à caixa de correio individual é permitido ao usuário. Se ele estiver definido como $true, os usuários, depois de serem autenticados, conseguirão recuperar mensagens de voz pelo telefone.

TUIAccessToAddressBookEnabled

Opcional

System.Boolean

Esse parâmetro especifica se um usuário pode acessar o diretório e as informações de contato pelo telefone.

TUIAccessToCalendarEnabled

Opcional

System.Boolean

Esse parâmetro especifica se os usuários podem acessar seus calendários individuais pelo telefone.

TUIAccessToEmailEnabled

Opcional

System.Boolean

Esse parâmetro especifica se os usuários podem acessar seus email individuais pelo telefone.

UMMailboxPolicy

Opcional

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

Esse parâmetro determina a diretiva de caixa de correio de UM associada à caixa de correio do usuário habilitado para UM.

UseRusServer

Opcional

System.String
noteObservação:
Esse parâmetro está disponível somente no Exchange 2007 SP2.

O parâmetro UseRusServer instrui o comando a utilizar o servidor de Caixa de Correio especificado no serviço Lista de Endereços em execução, a fim de obter e então definir a caixa de correio e os atributos de usuário Active Directory.

O serviço Lista de Endereços é um componente do serviço Assistente do Sistema Exchange. O serviço Lista de Endereços cria e mantém valores de atributo específicos do Exchange no Active Directory. Você pode usar o serviço Lista de Endereços para atualizar objetos de destinatário em um domínio usando informações específicas, como associação na lista de endereços e endereços de email.

WhatIf

Optional

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á exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. O valor padrão é $true.

Tipos de entrada

Tipo Descrição

 

 

Tipos de retorno

Tipo Descrição

 

 

Erros

Erro Descrição

 

 

Exemplo

O primeiro exemplo modifica o endereço secundário e o plano de discagem de UM para yanli@contoso.com.

O segundo exemplo impede que os usuários acessem seus respectivos calendários e emails ao usar o Outlook Voice Access.

O terceiro exemplo modifica as propriedades de uma caixa de correio de UM para yanli@contoso.com.

Set-UMMailbox -Identity yanli@contoso.com

Set-UMMailbox -Identity yanli@contoso.com -TUIAccessToCalendarEnabled $false -TUIAccessToEmailEnabled $false

Set-UMMailbox -Identity yanli@contoso.com -UMMailboxPolicy MyUMMailboxPolicy -FaxEnabled $true