New-MailUser (RTM)
Aplica-se a: Exchange Server 2007
Tópico modificado em: 2007-06-05
Use o cmdlet New-MailUser para criar um novo usuário habilitado para email.
Sintaxe
New-MailUser -Name <String> -ExternalEmailAddress <ProxyAddress> -OrganizationalUnit <OrganizationalUnitIdParameter> -Password <SecureString> -UserPrincipalName <String> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>]
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. |
OrganizationalUnit |
Necessário |
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). |
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:
|
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:
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:
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:
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. |
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 versões 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. |
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