Compartilhar via


New-Mailbox

 

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-Mailbox para criar um novo usuário no serviço de diretório Active Directory e habilite esse novo usuário para caixa de correio.

Sintaxe

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Password <SecureString> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -LinkedDomainController <String> -LinkedMasterAccount <UserIdParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-LinkedCredential <PSCredential>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Equipment <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Shared <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Room <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Para executar o cmdlet New-Mailbox, você deve usar uma conta à qual esteja delegado o seguinte:

  • 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

As pastas personalizadas gerenciadas são um recurso premium do MRM (gerenciamento de registros de mensagens). As caixas de correio com diretivas que incluem pastas personalizadas gerenciadas exigem uma CAL (licença de acesso para cliente) do Exchange Server Enterprise.

Parâmetros

Parâmetro Necessário Tipo Descrição

Database

Necessário

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

O parâmetro Database especifica qual banco de dados do Exchange conterá a caixa de correio do novo usuário. É possível usar os seguintes valores:

  • GUID do banco de dados

  • Nome do banco de dados

  • Nome do servidor\nome do banco de dados

  • Nome do servidor\grupo de armazenamento\nome do banco de dados

Equipment

Necessário

System.Management.Automation.SwitchParameter

O parâmetro Equipment especifica se o tipo de recurso é um equipamento, se essa caixa de correio for uma caixa de correio de recurso. Este parâmetro será necessário somente se você estiver criando uma caixa de correio de recurso.

LinkedDomainController

Necessário

System.String

O parâmetro LinkedDomainController especifica o controlador de domínio na floresta em que reside a conta do usuário. O controlador de domínio desta floresta é usado para obter informações de segurança para a conta especificada pelo parâmetro LinkedMasterAccount. Esse parâmetro será necessário somente se você estiver criando uma caixa de correio vinculada.

LinkedMasterAccount

Necessário

Microsoft.Exchange.Configuration.Tasks.UserIdParameter

O parâmetro LinkedMasterAccount especifica a conta principal na floresta em que reside a conta do usuário. A conta principal é a conta à qual a caixa de correio está vinculada. A conta principal concederá acesso à caixa de correio. Esse parâmetro será necessário somente se você estiver criando uma caixa de correio vinculada. Você pode usar um dos seguintes valores:

  • GUID

  • Nome diferenciado (DN)

  • Domínio\Conta

  • Nome UPN

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

Name

Necessário

System.String

O parâmetro Name especifica o nome do usuário. É o nome que aparece em Usuários e Computadores do Active Directory. Também é o nome de usuário exibido em Propriedades de Destinatários na guia Informações do Usuário.

Password

Necessário

System.Security.SecureString

O parâmetro Password especifica a senha inicial do usuário recentemente criado. Este parâmetro não será necessário se você estiver criando uma caixa de correio vinculada, uma caixa de correio de recurso ou uma caixa de correio compartilhada, pois a conta de usuário desses tipos de caixa de correio será desabilitada.

Room

Necessário

System.Management.Automation.SwitchParameter

O parâmetro Room especifica se o tipo de recurso é uma sala, se essa caixa de correio for uma caixa de correio de recurso. Este parâmetro será necessário somente se você estiver criando uma caixa de correio de recurso.

Shared

Necessário

System.Management.Automation.SwitchParameter

O parâmetro Shared especifica que você está criando uma caixa de correio compartilhada. Uma caixa de correio compartilhada é uma caixa de correio em que vários usuários podem fazer logon. Esta caixa de correio não está associada a nenhum dos usuários que podem fazer logon. Ela está associada a uma conta de usuário desabilitada.

Esse parâmetro será necessário somente se você estiver criando uma caixa de correio compartilhada.

UserPrincipalName

Necessário

System.String

O parâmetro UserPrincipalName especifica o nome UPN dessa caixa de correio. É o nome de logon do usuário. O UPN consiste em um nome de usuário e um sufixo. Geralmente, o sufixo é o nome do domínio em que a conta do usuário reside.

ActiveSyncMailboxPolicy

Opcional

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

O parâmetro ActiveSyncMailboxPolicy especifica a diretiva de caixa de correio a ser habilitada para a caixa de correio criada. Se você não especificar esse parâmetro, a diretiva de caixa de correio padrão será usada.

Alias

Opcional

System.String

O parâmetro Alias especifica o alias de email do usuário que você está criando.

O alias pode ser uma combinação de caracteres separados por um ponto sem espaços. Não use caracteres especiais no alias.

Confirm

Optional

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 para exibição do novo usuário criado nessa caixa de correio. O DisplayName é o nome que aparece no Console de Gerenciamento do Exchange em Configuração de Destinatário. O DisplayName também é exibido em Usuários e Computadores do Active Directory, na guia Propriedades Gerais do usuário.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

O parâmetro DomainController especifica o controlador de domínio a ser usado para gravar essa alteração de configuração no Active Directory. Use o nome de domínio totalmente qualificado (FQDN) do controlador de domínio a ser usado.

FirstName

Opcional

System.String

O parâmetro FirstName especifica o nome do usuário criado.

Initials

Opcional

System.String

O parâmetro Initials especifica as iniciais do usuário criado.

LastName

Opcional

System.String

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

LinkedCredential

Opcional

System.Management.Automation.PSCredential

O parâmetro LinkedCredential especifica credenciais para uso do acesso ao controlador de domínio especificado pelo parâmetro LinkedDomainController. Este parâmetro é opcional, mesmo se você estiver habilitando uma caixa de correio vinculada.

ManagedFolderMailboxPolicy

Opcional

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

O parâmetro ManagedFolderMailboxPolicy especifica a diretiva de caixa de correio de pasta gerenciada a ser habilitada para a caixa de correio criada.

ManagedFolderMailboxPolicyAllowed

Opcional

System.Management.Automation.SwitchParameter

O parâmetro ManagedFolderMailboxPolicyAllowed ignora o aviso de que recursos de gerenciamento de registros de mensagens não são aceitos por clientes de email que usam versões do Microsoft Outlook anteriores ao Outlook 2007. Quando uma diretiva de caixa de correio de pasta gerenciada é atribuída a uma caixa de correio com o parâmetro ManagedFolderMailboxPolicy, o aviso é exibido por padrão, a menos que ManagedFolderMailboxPolicyAllowed seja usado.

Dica

Os clientes Outlook 2003 Service Pack 3 têm suporte, mas funcionalidade limitada é fornecida para o gerenciamento de registros de mensagens.

OrganizationalUnit

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

O parâmetro OrganizationalUnit especifica o contêiner em que o usuário será criado.

ResetPasswordOnNextLogon

Opcional

System.Boolean

Se definido como $true, o parâmetro ResetPasswordOnNextLogon especifica que a senha no parâmetro Password deverá ser redefinida na próxima vez em que o usuário fizer logon.

SamAccountName

Opcional

System.String

O parâmetro SamAccountName especifica o nome de logon usado para oferecer suporte a clientes e servidores que executam versões mais antigas do sistema operacional, como Microsoft Windows NT 4.0, Windows 95, Windows 98 e LAN Manager. Este atributo deve conter menos de 20 caracteres para oferecer suporte a clientes antigos.

Se você não especificar este parâmetro, o Active Directory criará um SAMAccountName automaticamente, com base no nome UPN.

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.

UseRusServer

Opcional

System.String

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

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

Optional

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 primeiro exemplo mostra como criar o usuário Chris Ashton no Active Directory e como criar uma caixa de correio para o usuário. A caixa de correio está localizada no Grupo de Armazenamento 1, no Banco de Dados de Caixa de Correio 1. A senha deve ser redefinida no próximo logon. Para definir o valor inicial da senha, este exemplo cria uma variável, $password, solicita que você insira uma senha e atribui a senha à variável como um objeto SecureString.

O segundo exemplo mostra como criar um usuário no Active Directory e uma caixa de correio de recurso para uma sala de conferência. A caixa de correio de recurso está localizada no Grupo de Armazenamento 1, no Banco de Dados de Caixa de Correio 1. A senha deve ser redefinida no próximo logon. O Shell de Gerenciamento do Exchange solicitará o valor da senha inicial, pois ela não está especificada.

$password = Read-Host "Enter password" -AsSecureString
New-mailbox -UserPrincipalName chris@contoso.com -alias chris -database "Storage Group 1\Mailbox Database 1" -Name ChrisAshton -OrganizationalUnit Users -password $password -FirstName Chris -LastName Ashton -DisplayName "Chris Ashton" -ResetPasswordOnNextLogon $true

New-Mailbox -UserPrincipalName confmbx@contoso.com -alias confmbx -name ConfRoomMailbox -database "Storage Group 1\Mailbox Database 1" -OrganizationalUnit Users -Room -ResetPasswordOnNextLogon $true