Remove-Mailbox

  • Artigo

 

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

Tópico modificado em: 2007-06-28

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> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-Permanent <$true | $false>] [-WhatIf [<SwitchParameter>]]

Remove-Mailbox -Database <DatabaseIdParameter> -StoreMailboxIdentity <StoreMailboxIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

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 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:

  • GUID

  • Nome do banco de dados

  • Nome do servidor\nome do banco de dados

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

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:

  • ADObjectID

  • DN (nome distinto)

  • DN Herdado, GUID

  • Domínio\Nome da conta

  • Nome UPN

  • Endereço de email

  • Alias

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.

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.

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.

IgnoreDefaultScope

Opcional

System.Management.Automation.SwitchParameter

O parâmetro IgnoreDefaultScope instrui o comando a ignorar a configuração padrão de escopo do destinatário do Shell de Gerenciamento do Exchange e usar toda a floresta como o escopo. Isso permite que o comando acesse objetos do Active Directory que não estão atualmente no escopo padrão. O uso do parâmetro IgnoreDefaultScope introduz as seguintes restrições:

  • Você não pode usar o parâmetro DomainController. O comando usará automaticamente um servidor de catálogo global adequado.

  • Você pode usar o DN somente para o parâmetro Identity. Outras formas de identificação, como alias ou GUID, não são aceitas.

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.

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 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