Enable-UMMailbox

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.

Use o cmdlet Enable-UMMailbox para habilitar a Unificação de Mensagens (UM) para usuários de caixa de correio existentes.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax (https://docs.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

Syntax

Enable-UMMailbox
      [-Identity] <MailboxIdParameter>
      -UMMailboxPolicy <MailboxPolicyIdParameter>
      [-AutomaticSpeechRecognitionEnabled <Boolean>]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-Extensions <MultiValuedProperty>]
      [-IgnoreDefaultScope]
      [-NotifyEmail <String>]
      [-PilotNumber <String>]
      [-PIN <String>]
      [-PINExpired <Boolean>]
      [-SIPResourceIdentifier <String>]
      [-ValidateOnly]
      [-WhatIf]
      [<CommonParameters>]
Enable-UMMailbox
      [-Identity] <MailboxIdParameter>
      [-EnableCloudVoiceMail]
      [-AutomaticSpeechRecognitionEnabled <Boolean>]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-Extensions <MultiValuedProperty>]
      [-IgnoreDefaultScope]
      [-NotifyEmail <String>]
      [-PilotNumber <String>]
      [-Pin <String>]
      [-PinExpired <Boolean>]
      [-SendWelcomeMail <Boolean>]
      [-SIPResourceIdentifier <String>]
      [-UMMailboxPolicy <MailboxPolicyIdParameter>]
      [-ValidateOnly]
      [-WhatIf]
      [<CommonParameters>]

Description

Quando a caixa de correio for habilitada para Unificação de Mensagens, as configurações de uma política de caixa de correio de UM serão aplicadas à caixa de correio. Depois que a caixa de correio for habilitada para Unificação de mensagens, o usuário poderá usar os recursos de UM que estão incluídos no Microsoft Exchange.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Examples

Exemplo 1

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

Este exemplo habilita a Unificação de mensagens na caixa de correio de tonysmith@contoso.com, define a extensão e o PIN para o usuário que deve ser alterado quando o usuário faz logon no Outlook Voice Access, atribui a política de caixa de correio de UM MyUMMailboxPolicy à caixa de correio do usuário e envia uma mensagem de email que contém as informações de boas-vindas de Unificação de mensagens para o administrator@contoso.com

Exemplo 2

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

Este exemplo habilita a Unificação de mensagens em uma caixa de correio habilitada para SIP para o tonysmith@contoso.com, associa a política de caixa de correio de UM MyUMMailboxPolicy e define o número de ramal, o identificador de recurso SIP e o PIN para o usuário que deve ser alterado quando o usuário faz logon no Outlook Voice

Parameters

- Extensões

O parâmetro Extensions 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 da UM.

Se você não usar esse parâmetro, o comando tentará usar um valor de número de telefone padrão para o usuário. Se você estiver usando um URI do protocolo SIP ou um plano de discagem E.164, você também precisa usar o parâmetro SIPResourceIdentifier.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-AutomaticSpeechRecognitionEnabled

O parâmetro AutomaticSpeechRecognitionEnabled especifica se é necessário habilitar o Reconhecimento Automático de Fala (ASR) para a caixa de correio de UM. Os valores válidos são:

  • $true: o ASR está habilitado para a caixa de correio. Esse é o valor padrão. O ASR só estará disponível se a preferência de idioma especificada pelo usuário estiver instalada.

  • $false: a ASR está desabilitada para a caixa de correio.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, Remover-* cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para esses cmdlets, você pode ignorar a solicitação de confirmação usando esta sintaxe exata: -Confirm:$false.

  • A maioria dos outros cmdlets (por exemplo, New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-DomainController

Este parâmetro está disponível somente no Exchange local.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-EnableCloudVoiceMail

A opção EnableCloudVoiceMail especifica se é para habilitar a caixa de correio para UM no Skype for Business online. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online
-Identity

O parâmetro Identity especifica a caixa de correio que você deseja habilitar para a Unificação de Mensagens. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:

  • Nome

  • Alias

  • Nome diferenciado (DN)

  • Nome diferenciado (DN)

  • <domain name>\<account name>

  • DN canônico

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • ID de usuário ou nome UPN

Type:MailboxIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-IgnoreDefaultScope

Este parâmetro está disponível somente no Exchange local.

O parâmetro IgnoreDefaultScope instrui o comando a ignorar a configuração de escopo do destinatário padrão do Shell de Gerenciamento do Exchange e usar toda a floresta como escopo. Isso permite ao comando acessar os objetos do Active Directory que não estão atualmente disponíveis no escopo padrão.

O uso do parâmetro IgnoreDefaultScope apresenta as seguintes restrições:

  • Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.

  • Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-NotifyEmail

O parâmetro NotifyEmail especifica o endereço de email para onde a mensagem de boas-vindas da Unificação de Mensagens é enviada. Por padrão, a mensagem é enviada ao endereço de email SMTP do usuário.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-PIN

O parâmetro PIN especifica o valor do PIN inicial que é usado para a caixa de correio de UM. O PIN é verificado com relação às regras de diretiva de caixa de correio da UM. O valor do PIN deve estar entre os caracteres numéricos 4 e 24.

Se você não usar esse parâmetro, um PIN gerado pelo sistema será enviado ao usuário. Por padrão, o PIN gerado pelo sistema contém seis caracteres numéricos.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-PINExpired

O parâmetro PINExpired especifica se o PIN é tratado como expirado. Se o PIN não for fornecido, ele será tratado como expirado e os usuários serão solicitados a redefinir seu PIN na próxima vez em que fizerem logon.

  • $true: é necessário que o usuário redefina seu PIN na próxima vez que fizer logon.

  • $false: não é necessário que o usuário redefina seu PIN na próxima vez que fizer logon.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-PilotNumber

O parâmetro PilotNumber especifica o número de acesso do assinante que os usuários podem discar para obter acesso às suas caixas de correio. O valor padrão é o número de acesso do assinante especificado no plano de discagem de UM.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-SIPResourceIdentifier

O parâmetro SIPResourceIdentifier especifica o endereço SIP ou o endereço E.164 para o usuário. Essa propriedade é comparada com o tipo de URI definido no plano de discagem da UM.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-SendWelcomeMail

O parâmetro SendWelcomeMail especifica se você deseja enviar uma mensagem de boas-vindas depois que a caixa de correio for habilitada para UM. Os valores válidos são:

  • $true: envie a mensagem de boas-vindas para UM.

  • $false: não envie a mensagem de boas-vindas para UM.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online
-UMMailboxPolicy

O parâmetro UMMailboxPolicy especifica a política de caixa de correio de Unificação de Mensagens que você deseja associar à caixa de correio. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:

  • Nome

  • DN (nome diferenciado)

  • GUID

Type:MailboxPolicyIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-ValidateOnly

A opção ValidateOnly solicita ao cmdlet a avaliação das condições e dos requisitos necessários à execução da operação e informa se haverá êxito ou falha na operação. Não é possível fazer nenhuma alteração ao usar a opção ValidateOnly.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Inputs

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Outputs

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.