Compartilhar via


Enable-UMMailbox

 

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

Tópico modificado em: 2007-09-27

O cmdlet Enable-UMMailbox habilita a UM (Unificação de Mensagens) para um usuário habilitado para email existente.

Sintaxe

Enable-UMMailbox -Identity <MailboxIdParameter> -UMMailboxPolicy <MailboxPolicyIdParameter> [-AutomaticSpeechRecognitionEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Extensions <MultiValuedProperty>] [-IgnoreDefaultScope <SwitchParameter>] [-NotifyEmail <String>] [-PilotNumber <String>] [-Pin <String>] [-PinExpired <$true | $false>] [-SIPResourceIdentifier <String>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet Enable-UMMailbox habilita a UM (Unificação de Mensagens) para um usuário habilitado para email existente do Microsoft Exchange Server 2007. Quando o usuário habilitado para mensagens for habilitado para Unificação de Mensagens, as configurações de uma diretiva de caixa de correio do UM serão aplicadas ao usuário. Depois que o usuário for habilitado para Unificação de Mensagens, ele poderá usar os recursos do UM incluídos no Exchange 2007.

Para executar o cmdlet Enable-UMMailbox, você deve usar uma conta à qual esteja delegada a função de 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 Exchange 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

  • Domain\Account

  • UPN

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

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

UMMailboxPolicy

Necessário

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

Esse parâmetro especifica o nome da diretiva da caixa de correio de Unificação de Mensagens a ser associada ao usuário.

AutomaticSpeechRecognitionEnabled

Opcional

System.Boolean

Esse parâmetro habilita o ASR (Reconhecimento de Fala Automático) a ser usado com a caixa de correio de UM. O ASR só estará disponível se a preferência de idioma especificada pelo usuário estiver instalada.

Confirm

Optional

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.

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.

Extensions

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica o número de ramal do usuário. É possível especificar um único número de ramal ou uma matriz de ramais de números de telefone. O ramal do usuário deve ser exclusivo para o plano de discagem de UM. Se esse parâmetro não for incluído, um valor de número de telefone padrão do Active Directory será usado.

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.

NotifyEmail

Opcional

System.String

Esse parâmetro especifica o endereço de email para o qual o servidor enviará a mensagem de email que contém as informações de boas-vindas da Unificação de Mensagens. Por padrão, a mensagem é enviada para o endereço SMTP do usuário habilitado.

PilotNumber

Opcional

System.String

Esse parâmetro especifica o número de acesso do assinante que o usuário pode discar para obter acesso à sua caixa de correio. O valor padrão é o número de acesso do assinante especificado em um objeto de Plano de Discagem do Active Directory.

PIN

Opcional

System.String

Esse parâmetro especifica o valor do PIN inicial a ser usado com a caixa de correio de UM. O PIN será verificado com relação às regras de diretiva de caixa de correio de UM. O valor do PIN deve estar entre os caracteres numéricos 4 e 24. Se nenhum PIN for especificado, um PIN gerado pelo sistema será enviado por email ao usuário. O PIN gerado pelo sistema contém 6 caracteres numéricos, o padrão.

PINExpired

Opcional

System.Boolean

Este parâmetro especifica se o PIN será tratado como expirado. Se esse parâmetro for fornecido e for definido como $false, não será exigido que o usuário redefina seu PIN na próxima vez que fizer logon. Se o PIN não for fornecido, ele será tratado como expirado e o usuário será solicitado a redefinir seu PIN na próxima vez que fizer logon.

SIPResourceIdentifier

Opcional

System.String

Esse parâmetro especifica o endereço SIP ou o endereço E.164 do usuário. Essa propriedade será comparada ao tipo URI (Uniform Resource Identifier) definido no plano de discagem da UM.

ValidateOnly

Opcional

System.Management.Automation.SwitchParameter

Esse parâmetro especifica para verificar todos os pré-requisitos necessários para executar com êxito o cmdlet sem executar realmente uma ação.

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 delas. 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 habilita a Unificação de Mensagens na caixa de correio de yanli@contoso.com, define o ramal e o PIN do usuário e atribui uma diretiva de caixa de correio do UM chamada MyUMMailboxPolicy para a caixa de correio do usuário.

O segundo exemplo habilita a Unificação de Mensagens em uma caixa de correio habilitada para SIP de yanli@contoso.com, associa uma diretiva de caixa de correio do UM chamada MYUMMailboxPolicy e define o número do ramal, o identificador de recursos do SIP e o PIN do usuário.

Enable-UMMailbox -Identity yanli@contoso.com -UMMailboxPolicy MyUMMailboxPolicy -Extensions 51234 -PIN 5643892 -NotifyEmail administrator@contoso.com -PINExpired $true

Enable-UMMailbox -Identity yanli@contoso.com -UMMailboxPolicy MyUMMailboxPolicy -Extensions 51234 -PIN 5643892 -NotifyEmail administrator@contoso.com -SIPResourceIdentifier "yanli@contoso.com" -PINExpired $true