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.

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	Observaçã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

Exceções

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