Remove-Mailbox (RTM)
Aplica-se a: Exchange Server 2007
Tópico modificado em: 2007-06-05
Use o cmdlet Remove-Mailbox para excluir a conta de usuário associada a uma determinada caixa de correio do serviço de diretório do Active Directory e para processar a caixa de correio desconectada e associada, conforme determinado pelos parâmetros especificados.
Sintaxe
Remove-Mailbox -Identity <MailboxIdParameter> [-DomainController <Fqdn>] [-Permanent <$true | $false>]
Remove-Mailbox -Database <DatabaseIdParameter> -StoreMailboxIdentity <StoreMailboxIdParameter> [-DomainController <Fqdn>]
Descrição detalhada
O cmdlet Remove-Mailbox remove do Active Directory a conta de usuário associada a uma determinada caixa de correio e, em seguida, processa a caixa de correio desconectada e associada, conforme determinado pelos parâmetros especificados.
Use somente o parâmetro Identity para desconectar a caixa de correio do usuário e remover o objeto de usuário do Active Directory. O objeto de caixa de correio ainda existe. Por padrão, a caixa de correio permanecerá no banco de dados do Exchange por 30 dias e, em seguida, será excluída.
Use os parâmetros Identity e Permanent para desconectar a caixa de correio do usuário, remover o objeto de usuário do Active Directory e remover o objeto de caixa de correio do banco de dados do Exchange. O objeto de caixa de correio não permanecerá no banco de dados do Exchange como uma caixa de correio desconectada.
Use os parâmetros Database e StoreMailboxIdentity para remover um objeto de caixa de correio do banco de dados do Exchange. Nesse caso, o objeto de caixa de correio já estará desconectado do usuário. Por exemplo, se você executar o cmdlet Disable-Mailbox, o objeto de caixa de correio do Exchange ainda existirá, mas estará desconectado do objeto de usuário do Active Directory. Você pode usar os parâmetros Database e StoreMailboxIdentity para remover o objeto de caixa de correio desconectado.
Para executar o cmdlet Remove-Mailbox, 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 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 o banco de dados que contém o objeto de caixa de correio. Você pode usar um dos seguintes valores:
Se você não especificar o nome do servidor, o cmdlet procurará o banco de dados no servidor local. Se você tiver vários bancos de dados com o mesmo nome no mesmo servidor, deverá especificar o grupo de armazenamento. Este parâmetro deve ser usado juntamente com o parâmetro StoreMailboxIdentity. O parâmetro Database não pode ser usado com o parâmetro Identity. Se tiver desconectado uma caixa de correio de seu usuário associado e desejar remover o objeto de caixa de correio do armazenamento do Exchange, use os parâmetros Database e StoreMailboxIdentity. |
Identity |
Necessário |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
O parâmetro Identity identifica o objeto de caixa de correio que você deseja remover. Você pode usar um dos seguintes valores:
O parâmetro Identity não pode ser usado com o parâmetro Database. |
StoreMailboxIdentity |
Necessário |
Microsoft.Exchange.Configuration.Tasks.StoreMailboxIdParameter |
O parâmetro StoreMailboxIdentity identifica o objeto de caixa de correio a ser removido. O parâmetro StoreMailboxIdentity é usado juntamente com o parâmetro Database para remover o objeto de caixa de correio do banco de dados do Exchange. Se tiver desconectado uma caixa de correio de seu usuário associado e desejar remover o objeto de caixa de correio do armazenamento do Exchange, use os parâmetros Database e StoreMailboxIdentity. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
O parâmetro DomainController especifica o controlador de domínio que grava 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. |
Permanent |
Opcional |
System.Boolean |
O parâmetro Permanent, quando usado com o parâmetro Identity, desconecta a caixa de correio do usuário, remove o objeto de usuário associado do Active Directory, e remove o objeto de caixa de correio do banco de dados do Exchange. Os dois valores possíveis para esse parâmetro são $true ou $false. O valor padrão é $false. |
Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
|
Exceções
| Exceções | Descrição |
|---|---|
|
Exemplo
O primeiro exemplo mostra como desconectar a caixa de correio do usuário John Peoples (john) da conta de usuário e como remover o objeto de caixa de correio do Active Directory. A caixa de correio permanecerá no banco de dados do Exchange para o período de retenção de caixa de correio excluída configurado para o banco de dados da caixa de correio.
O segundo exemplo mostra como desconectar a caixa de correio do usuário John Peoples (john) da conta de usuário, remover o objeto de caixa de correio do Active Directory e remover a caixa de correio do banco de dados do Exchange.
O terceiro exemplo mostra como remover a caixa de correio de John Peoples (john) do banco de dados do Exchange, supondo que a caixa de correio já tenha sido desconectada do usuário. O exemplo mostra como usar o cmdlet Get-MailboxStatistics para recuperar o valor da GUID da caixa de correio usando o nome para exibição da caixa de correio desconectada. Esse valor é necessário para o parâmetro StoreMailboxIdentity do cmdlet Remove-Mailbox.
Remove-Mailbox -Identity contoso\john
Remove-Mailbox -Identity contoso\john -Permanent $true
$Temp = Get-MailboxStatistics | Where {$_.DisplayName -eq 'John Peoples'}
Remove-Mailbox -Database Server01\Database01 -StoreMailboxIdentity $Temp.MailboxGuid