Compartilhar via


New-MailUser

 

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

Tópico modificado em: 2009-05-12

Use o cmdlet New-MailUser para criar um novo usuário habilitado para email.

Sintaxe

New-MailUser -Name <String> -ExternalEmailAddress <ProxyAddress> -Password <SecureString> -UserPrincipalName <String> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-PrimarySmtpAddress <SmtpAddress>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet New-MailUser cria um novo objeto de usuário habilitado para email no serviço de diretório do Active Directory.

Para executar o cmdlet New-MailUser, você deve usar a conta à qual estejam delegadas as seguintes funções:

  • Função Administrador de Destinatários do Exchange

  • Função de Operador de Conta para os contêineres do Active Directory aplicáveis 

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.

Dica

Nem todos os atributos de usuário podem ser definidos pelo cmdlet New-MailUser. Você pode fazer configurações adicionais com o cmdlet Set-User.

Parâmetros

Parâmetro Necessário Tipo Descrição

ExternalEmailAddress

Necessário

Microsoft.Exchange.Data.ProxyAddress

O parâmetro ExternalEmailAddress especifica um endereço de email fora da organização. As mensagens de email enviadas aos usuários habilitados para mensagens são enviadas a esse endereço externo.

Name

Necessário

System.String

O parâmetro Name especifica o CN (nome comum) do usuário habilitado para email.

Password

Necessário

System.Security.SecureString

O parâmetro Password especifica a senha usada pelo usuário de email para proteger a sua conta.

UserPrincipalName

Necessário

System.String

O parâmetro UserPrincipalName define o nome de um usuário do sistema no formato do endereço de email (por exemplo ted@contoso.com).

Alias

Opcional

System.String

O parâmetro Alias especifica o alias do usuário. Um alias pode conter letras, números 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 e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.

DisplayName

Opcional

System.String

O parâmetro DisplayName especifica o nome que será exibido no Microsoft Outlook para o usuário de email.

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.

FirstName

Opcional

System.String

O parâmetro FirstName especifica o primeiro nome do usuário de email.

Initials

Opcional

System.String

O parâmetro Initials especifica a inicial do usuário de email.

LastName

Opcional

System.String

O parâmetro LastName especifica o sobrenome do usuário de email.

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:

  • BinHex

  • UUENCODE

  • AppleSingle

  • AppleDouble

Por padrão, esse parâmetro é definido como BinHex. Os valores aceitáveis para o parâmetro MacAttachmentFormat dependem do parâmetro MessageFormat. Se o parâmetro MessageFormat estiver definido como Text, você poderá usar apenas os valores BinHex ou UUENCODE para esse parâmetro. Se o parâmetro MessageFormat estiver definido como Mime, você poderá usar apenas os valores BinHex, AppleSingle ou AppleDouble com esse parâmetro.

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:

  • Texto

  • Html

  • TextAndHtml

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, também deverá definir 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:

  • Texto

  • Mime

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.

OrganizationalUnit

Opcional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

O parâmetro OrganizationalUnit especifica a unidade organizacional onde o novo usuário é adicionado (por exemplo, redmond.contoso.com/contacts).

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 $false, e os endereços de email desse usuário não serão automaticamente atualizados com base em diretivas de endereços de email.

ResetPasswordOnNextLogon

Opcional

System.Boolean

Se o parâmetro ResetPasswordOnNextLogon for definido como $true, o usuário deverá alterar a senha no logon seguinte.

SamAccountName

Opcional

System.String

O parâmetro SamAccountName define o nome de logon usado para oferecer suporte a clientes e servidores que executam versoes antigas do sistema operacional, como Microsoft Windows NT 4.0, Windows 98, Windows 95 e LAN Manager. Esse atributo deve conter menos de 20 caracteres. Um nome de conta pode conter letras, números e os seguintes sinais de pontuação e símbolos:

  • !

  • #

  • $

  • %

  • ^

  • &

  • -

  • .

  • _

  • {

  • }

  • |

  • ~

TemplateInstance

Opcional

System.Management.Automation.PSObject

Quando um objeto existente for fornecido para o parâmetro TemplateInstance, o comando usará a configuração desse objeto para criar uma cópia exata do objeto em um servidor local ou de destino.

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 $true para que o formato de mensagem configurado para a caixa de correio substitua todas as configurações globais.

UseRusServer

Optional

System.String

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

O parâmetro UseRusServer instrui o comando a usar o servidor Caixa de Correio especificado no qual o serviço Lista de Endereços está sendo executado para obter e definir atributos de caixa de correio e de usuário do Active Directory.

O serviço Lista de Endereços é um componente do serviço Atendedor do Sistema do Exchange. O serviço Lista de Endereços cria e mantém valores de atributo específicos do Exchange no Active Directory. O serviço Lista de Endereços pode ser usado para atualizar objetos de destinatário em um domínio usando informações específicas, como a 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á exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

Exceções

Exceções Descrição

 

Exemplo

O exemplo a seguir consiste em dois comandos.

No primeiro comando, é criada um senha, $password, do tipo System.Security.SecureString. Quando o comando é executado, o prompt "Digitar senha" é exibido. A cadeia de caracteres digitada pelo usuário se torna a nova cadeia de caracteres de senha, $password.

O segundo comando cria um novo objeto de usuário habilitado para email chamado Ted Bremer e atribui uma senha recém-criada para o objeto por meio do parâmetro Password. Ted é um funcionário da Tailspin Toys, mas como ele trabalha em contato direto com os funcionários da empresa Contoso, ele recebeu um endereço de email na contoso.com. Ted não tem uma caixa de correio no Exchange Server da Contoso. As mensagens de email enviadas para o endereço de email de Ted na contoso.com são enviadas para o seu endereço externo, ted@tailspintoys.com.

$password = Read-Host "Enter password" -AsSecureString
New-MailUser -Name "Ted Bremer" -Password $password -ExternalEmailAddress ted@tailspintoys.com -UserPrincipalName ted@contoso.com -OrganizationalUnit contoso.com