Enable-MailUser
Este cmdlet está disponível somente no Exchange local.
Use o cmdlet Enable-MailUser para habilitar usuários existentes para email, caso ainda não estejam habilitados.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
EnabledUser (Padrão)
Enable-MailUser
[-Identity] <UserIdParameter>
-ExternalEmailAddress <ProxyAddress>
[-Alias <String>]
[-Confirm]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-MacAttachmentFormat <MacAttachmentFormat>]
[-MessageBodyFormat <MessageBodyFormat>]
[-MessageFormat <MessageFormat>]
[-PrimarySmtpAddress <SmtpAddress>]
[-UsePreferMessageFormat <Boolean>]
[-WhatIf]
[<CommonParameters>]
EnableGuestUser
Enable-MailUser
[-Identity] <UserIdParameter>
[-ExternalEmailAddress <ProxyAddress>]
[-Alias <String>]
[-Confirm]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-PrimarySmtpAddress <SmtpAddress>]
[-WhatIf]
[<CommonParameters>]
Description
O cmdlet Enable-MailUser permite aos utilizadores existentes adicionar os atributos de e-mail necessários ao Exchange. Usuários de email são visíveis para os outros cmdlets *-MailUser.
Os utilizadores de correio têm endereços de e-mail e contas na organização do Exchange, mas não têm caixas de correio do Exchange. As mensagens de email enviadas para usuários de email são entregues para o endereço de email externo especificado.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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.
Exemplos
Exemplo 1
Enable-MailUser -Identity John -ExternalEmailAddress john@contoso.com
Este exemplo de correio permite ao utilizador João com o endereço john@contoso.comde e-mail externo .
Parâmetros
-Alias
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro Alias especifica o alias do Exchange (também conhecido como alcunha de correio) para o destinatário. Esse valor identifica o destinatário como um objeto habilitado para email e não deve ser confundido com vários endereços de email para o mesmo destinatário (também conhecido como endereços de proxy). Um destinatário pode ter apenas um valor de Alias. O tamanho máximo é de 64 caracteres.
O valor Alias pode conter letras, números e os seguintes carateres:
- !, #, %, *, +, -, /, =, ?, ^, _, e ~.
- $, &, ', ', {, }, and | tem de ser escapado (por exemplo
-Alias what`'snew, ) ou todo o valor entre plicas (por exemplo,-Alias 'what'snew'). O caráter & não é suportado no valor de Alias para a sincronização do Microsoft Entra Connect. - Os períodos (.) têm de estar rodeados por outros carateres válidos (por exemplo,
help.desk). - Carateres Unicode U+00A1 a U+00FF.
Quando cria um destinatário sem especificar um endereço de e-mail, o valor de Alias que especificar é utilizado para gerar o endereço de email principal (alias@domain). Os caracteres Unicode com suporte são mapeados para os melhores caracteres de texto US-ASCII. Por exemplo, U+00F6 (ö) é alterado para oe no endereço de email principal.
Se não utilizar o parâmetro Alias quando cria um destinatário, o valor de um parâmetro necessário diferente é utilizado para o valor da propriedade Alias:
- Destinatários com contas de utilizador (por exemplo, caixas de correio de utilizador e utilizadores de correio): é utilizado o lado esquerdo do parâmetro MicrosoftOnlineServicesID ou UserPrincipalName. Por exemplo, helpdesk@contoso.onmicrosoft.com resulta no valor
helpdeskda propriedade Alias . - Destinatários sem contas de utilizador (por exemplo, caixas de correio de sala, contactos de correio e grupos de distribuição): é utilizado o valor do parâmetro Nome. Os espaços são removidos e os carateres não suportados são convertidos em pontos de interrogação (?).
Se modificar o valor de Alias de um destinatário existente, o endereço de email principal é atualizado automaticamente apenas em ambientes onde o destinatário está sujeito a políticas de endereço de e-mail (a propriedade EmailAddressPolicyEnabled é True para o destinatário).
O parâmetro Alias nunca gera ou atualiza a endereço de email principal de um contacto de correio ou de um utilizador de correio.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 estes cmdlets, você pode pular o pedido 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DisplayName
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro DisplayName especifica o nome de exibição do usuário de email. O nome a apresentar é visível no centro de administração do Exchange e nas listas de endereços. O comprimento máximo é de 256 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExternalEmailAddress
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro ExternalEmailAddress especifica um endereço de email fora da organização. As mensagens de email enviadas para o usuário habilitado para email são enviadas para esse endereço externo.
Propriedades do parâmetro
| Tipo: | ProxyAddress |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
EnabledUser
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
EnableGuestUser
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro Identity especifica o usuário para o qual você deseja habilitar o email. É possível usar qualquer valor que identifique o usuário com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- Nome diferenciado (DN)
- GUID
Propriedades do parâmetro
| Tipo: | UserIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-MacAttachmentFormat
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro MacAttachmentFormat especifica o formato de anexo do sistema operativo Apple Macintosh a utilizar para mensagens enviadas para o contacto de correio ou utilizador de correio. Os valores válidos são:
- BinHex (valor predefinido)
- UuEncode
- AppleSingle
- AppleDouble
Os parâmetros MacAttachmentFormat e MessageFormat são interdependentes:
- MessageFormat é Texto: MacAttachmentFormat pode ser BinHex ou UuEncode.
- MessageFormat é Mime: MacAttachmentFormat pode ser BinHex, AppleSingle ou AppleDouble.
Propriedades do parâmetro
| Tipo: | MacAttachmentFormat |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
EnabledUser
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MessageBodyFormat
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro MessageBodyFormat especifica o formato do corpo da mensagem para as mensagens enviadas para o contacto de correio ou utilizador de correio. Os valores válidos são:
- Texto
- Html
- TextAndHtml (valor predefinido)
Os parâmetros MessageFormat e MessageBodyFormat são interdependentes:
- MessageFormat é Mime: MessageBodyFormat pode ser Texto, Html ou TextAndHtml.
- MessageFormat é Texto: MessageBodyFormat só pode ser Texto.
Propriedades do parâmetro
| Tipo: | MessageBodyFormat |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
EnabledUser
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MessageFormat
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro MessageFormat especifica o formato da mensagem para as mensagens enviadas para o contacto de e-mail ou utilizador de correio. Os valores válidos são:
- Texto
- Mime (valor predefinido)
Os parâmetros MessageFormat e MessageBodyFormat são interdependentes:
- MessageFormat é Mime: MessageBodyFormat pode ser Texto, Html ou TextAndHtml.
- MessageFormat é Texto: MessageBodyFormat só pode ser Texto.
Por isso, se quiser alterar o parâmetro MessageFormat de Mime para Text, o parâmetro MessageBodyFormat também deve ser alterado para Text.
Propriedades do parâmetro
| Tipo: | MessageFormat |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
EnabledUser
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PrimarySmtpAddress
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro PrimarySmtpAddress especifica o endereço de email de retorno principal que é usado para o destinatário.
Por padrão, o endereço principal é o mesmo do parâmetro ExternalEmailAddress.
Se você usa o parâmetro PrimarySmtpAddress para especificar o endereço de email principal, o comando define a propriedade EmailAddressPolicyEnabled do usuário de email como False, que significa que os endereços de email do usuário não são atualizados automaticamente pelas políticas de endereço de email. Recomendamos que você não define o endereço de email principal para um valor diferente de ExternalEmailAddress a não ser que você esteja em um cenário entre florestas.
Propriedades do parâmetro
| Tipo: | SmtpAddress |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-UsePreferMessageFormat
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O UsePreferMessageFormat especifica se as definições de formato de mensagem configuradas para o utilizador de correio ou o contacto de correio substituem as definições globais configuradas para o domínio remoto ou configuradas pelo remetente da mensagem. Os valores válidos são:
- $true: as mensagens enviadas para o utilizador de correio ou contacto de correio utilizam o formato de mensagem configurado para o utilizador de correio ou contacto de correio.
- $false: as mensagens enviadas para o utilizador de e-mail ou contacto de correio utilizam o formato de mensagem configurado para o domínio remoto (o domínio remoto predefinido ou um domínio remoto específico) ou configurados pelo remetente da mensagem. Este valor é a predefinição.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
EnabledUser
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
Entradas
Input types
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.
Saídas
Output types
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.