Enable-MailUser
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2010-03-30
É possível usar o cmdlet Enable-MailUser para habilitar um usuário existente para email no serviço de diretório do Active Directory.
Sintaxe
Enable-MailUser -Identity <UserIdParameter> -ExternalEmailAddress <ProxyAddress> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-PrimarySmtpAddress <SmtpAddress>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
O cmdlet Enable-MailUser habilita um usuário existente para email no Active Directory adicionando os atributos necessários ao Microsoft Exchange Server 2007. A identidade do usuário e um endereço de email externo são necessários. Os usuários habilitados para email possuem um endereço de email na organização do Exchange (por exemplo, john@contoso.com), mas eles não têm um caixa de correio do Exchange. As mensagens de email enviadas aos usuários habilitados para mensagens são enviadas ao endereço de email externo especificado.
Para obter mais informações, consulte Como criar um novo usuário habilitado para email.
Para executar o cmdlet Enable-MailUser, você deve representar a seguinte função na conta utilizada:
- 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 Exchange Server 2007, consulte Considerações sobre permissão.
Dica
Para criar um novo usuário que esteja habilitado para email na hora da criação, use o cmdlet New-MailUser.
Parâmetros
Parâmetro | Necessário(s) | Tipo | Descrição | ||
---|---|---|---|---|---|
ExternalEmailAddress |
Necessário(s) |
Microsoft.Exchange.Data.ProxyAddress |
O parâmetro ExternalEmailAddress especifica um endereço de email fora da organização. Por padrão, o endereço de email especificado no parâmetro ExternalEmailAddress é definido como PrimarySMTPAddress. As mensagens de email enviadas para os usuários habilitados para mensagens são enviadas a este endereço externo. |
||
Identity |
Necessário(s) |
Microsoft.Exchange.Configuration.Tasks.UserIdParameter |
O parâmetro Identity adota um dos seguintes valores:
|
||
Alias |
Opcional |
System.String |
O parâmetro Alias especifica o alias do usuário. Um alias pode conter letras, numerais e os seguintes sinais de pontuação e símbolos:
|
||
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro Confirm faz com que o comando pause o processamento. Além disso, ele requer que você saiba o que o comando fará antes do processo continuar. Você não precisa especificar nenhum valor para o parâmetro Confirm. |
||
DisplayName |
Opcional |
System.String |
O parâmetro DisplayName especifica o nome para exibição do usuário de email. O DisplayName é o nome que aparece no Console de Gerenciamento do Exchange em Configuração de Destinatário. |
||
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no Active Directory, inclua o parâmetro DomainController no comando. |
||
MacAttachmentFormat |
Opcional |
Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat |
O parâmetro MacAttachmentFormat especifica o formato de anexo do Sistema Operacional Apple Macintosh em mensagens enviadas para o usuário do email. Os valores válidos para este parâmetro são:
Por padrão, esse parâmetro é definido como BinHex.
|
||
MessageBodyFormat |
Opcional |
Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat |
O parâmetro MessageBodyFormat especifica o formato de corpo da mensagem para mensagens enviadas ao usuário de email. Os valores válidos para este parâmetro são:
Por padrão, esse parâmetro é definido como TextAndHtml. Os parâmetros MessageFormat e MessageBodyFormat são interdependentes. Se o parâmetro MessageFormat for definido como Mime, o parâmetro MessageBodyFormat poderá ser definido como qualquer valor válido. Contudo, se o parâmetro MessageFormat for definido como Text, o parâmetro MessageBodyFormat poderá ser definido apenas como Text. Portanto, se você desejar definir esse parâmetro como Html ou TextAndHtml, será necessário definir também o parâmetro MessageFormat como Mime. |
||
MessageFormat |
Opcional |
Microsoft.Exchange.Data.Directory.Recipient.MessageFormat |
O parâmetro MessageFormat especifica o formato das mensagens enviadas ao usuário de email. Os valores válidos para este parâmetro são:
Por padrão, esse parâmetro é definido como Mime. Os parâmetros MessageFormat e MessageBodyFormat são interdependentes. Se o parâmetro MessageFormat for definido como Mime, o parâmetro MessageBodyFormat poderá ser definido como qualquer valor válido. Contudo, se o parâmetro MessageFormat for definido como Text, o parâmetro MessageBodyFormat poderá ser definido apenas como Text. Portanto, se você desejar alterar o parâmetro MessageFormat de Mime para Text, também deverá alterar o parâmetro MessageBodyFormat para Text. |
||
PrimarySmtpAddress |
Opcional |
Microsoft.Exchange.Data.SmtpAddress |
Use esse parâmetro para especificar o endereço SMTP primário do usuário de email. Por padrão, o endereço SMTP primário é gerado com base na diretiva padrão de endereço de email. Se você especificar um endereço SMTP primário usando esse parâmetro, o cmdlet definirá o atributo EmailAddressPolicyEnabled do usuário de email como |
||
UsePreferMessageFormat |
Opcional |
System.Boolean |
O parâmetro UsePreferMessageFormat especifica se as definições de formato da mensagem configuradas para a caixa de correio substituirão as definições globais configuradas para o domínio. Defina este parâmetro como |
||
UseRusServer |
Optional |
System.String |
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 |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá visualizar quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar nenhum valor com o parâmetro WhatIf. |
Tipos de entrada
Tipos de retorno
Erros
Erro | Descrição |
---|---|
|
Exceções
Exceções | Descrição |
---|---|
|
Exemplo
Neste exemplo, o comando Enable-MailUser é usado para habilitar o usuário John para email com o email externo john@contoso.com.
Enable-MailUser -Identity John -ExternalEmailAddress john@contoso.com