Compartilhar via

Remove-Mailbox

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.

Use o cmdlet Remove-Mailbox para excluir caixas de correio e as contas de usuário associadas.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Remove-Mailbox
      [-Identity] <MailboxIdParameter>
      [-Permanent <Boolean>]
      [-Arbitration]
      [-AuditLog]
      [-AuxAuditLog]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-Force]
      [-IgnoreDefaultScope]
      [-IgnoreLegalHold]
      [-Migration]
      [-PublicFolder]
      [-RemoveArbitrationMailboxWithOABsAllowed]
      [-RemoveLastArbitrationMailboxAllowed]
      [-SupervisoryReviewPolicy]
      [-WhatIf]
      [<CommonParameters>]
Remove-Mailbox
      -Database <DatabaseIdParameter>
      -StoreMailboxIdentity <StoreMailboxIdParameter>
      [-Arbitration]
      [-AuditLog]
      [-AuxAuditLog]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-Force]
      [-IgnoreDefaultScope]
      [-IgnoreLegalHold]
      [-Migration]
      [-PublicFolder]
      [-RemoveArbitrationMailboxWithOABsAllowed]
      [-RemoveLastArbitrationMailboxAllowed]
      [-SupervisoryReviewPolicy]
      [-WhatIf]
      [<CommonParameters>]
Remove-Mailbox
      [-Identity] <MailboxIdParameter>
      [-PermanentlyDelete]
      [-Confirm]
      [-Force]
      [-Migration]
      [-PublicFolder]
      [-RemoveCNFPublicFolderMailboxPermanently]
      [-WhatIf]
      [<CommonParameters>]

Description

Use o parâmetro Identity sozinho para desconectar a caixa de correio do usuário e remover a conta de usuário. A caixa de correio ainda existe e fica retida até que o período de retenção de caixa de correio expire. O período de retenção de caixa de correio excluído é controlado pela propriedade MailboxRetention no banco de dados da caixa de correio ou na própria caixa de correio se a propriedade UseDatabaseRetentionDefaults for False.

Use os parâmetros Identity e Permanent para desconectar a caixa de correio do usuário, remover a conta do usuário e remover imediatamente a caixa de correio do banco de dados da caixa de correio. A caixa de correio não permanece no banco de dados da caixa de correio como uma caixa de correio desconectada.

Use o cmdlet Disable-Mailbox para desconectar a caixa de correio da conta de usuário, mas manter a conta de usuário. A caixa de correio fica retida até o período de retenção da caixa de correio excluída expirar e a caixa de correio ser permanentemente excluída (limpa). Ou você pode limpar imediatamente a caixa de correio desconectada usando os parâmetros Banco de Dados e StoreMailboxIdentity no cmdlet Remove-Mailbox.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Remove-Mailbox -Identity "John Rodman"

Este exemplo remove a caixa de correio e a conta de usuário do usuário chamado Nicolau Mendes. A caixa de correio continua no banco de dados da caixa de correio durante o período de retenção da caixa de correio excluída configurado para o banco de dados.

Exemplo 2

Remove-Mailbox -Identity "John Rodman" -Permanent $true

No Exchange local, este exemplo remove a caixa de correio e a conta de usuário do usuário chamado John Rodman. A caixa de correio é imediata e permanentemente removida do banco de dados de caixa de correio.

Exemplo 3

$Temp = Get-Mailbox | Where {$_.DisplayName -eq 'John Rodman'}

Remove-Mailbox -Database Server01\Database01 -StoreMailboxIdentity $Temp.MailboxGuid

No Exchange local, este exemplo remove a caixa de correio de John Rodman do banco de dados da caixa de correio depois que a caixa de correio foi desconectada da conta de usuário. O exemplo usa o cmdlet Get-Mailbox para recuperar o valor do GUID da caixa de correio para a caixa de correio desconectada, que é exigida pelo parâmetro StoreMailboxIdentity.

Exemplo 4

Get-Mailbox -Identity Laura -SoftDeletedMailbox | Remove-Mailbox -PermanentlyDelete

Em Exchange Online, este exemplo remove a caixa de correio excluída suave especificada.

Parâmetros

-Arbitration

Este parâmetro está disponível somente no Exchange local.

A opção Arbitragem é necessária para remover caixas de correio de arbitragem. Não é preciso especificar um valor com essa opção.

As caixas de correio de arbitragem são caixas de correio do sistema usadas para armazenar diferentes tipos de dados do sistema e para gerenciar o fluxo de trabalho de aprovação de mensagens.

Para remover caixas de correio de arbitragem usadas para armazenar configurações de log de auditoria ou dados, não use essa opção. Em vez disso, use os comutadores AuditLog ou AuxAuditLog.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-AuditLog

Este parâmetro está disponível somente no Exchange local.

A opção AuditLog é necessária para remover caixas de correio de log de auditoria. Não é preciso especificar um valor com essa opção.

As caixas de correio de log de auditoria são caixas de correio de arbitragem usadas para armazenar configurações de log de auditoria.

Para remover outros tipos de caixas de correio de arbitragem, não use essa opção. Em vez disso, use a opção Arbitragem.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-AuxAuditLog

Este parâmetro está disponível somente no Exchange local.

A opção AuxAuditLog é necessária para remover caixas de correio de log de auditoria auxiliares. Não é preciso especificar um valor com essa opção.

As caixas de correio de log de auditoria são caixas de correio de arbitragem usadas para armazenar configurações de log de auditoria.

Para remover outros tipos de caixas de correio de arbitragem, não use essa opção. Em vez disso, use a opção Arbitragem.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Database

Este parâmetro está disponível somente no Exchange local.

O parâmetro Banco de Dados especifica o banco de dados exchange que contém a caixa de correio que você deseja remover. É possível usar qualquer valor que identifique o banco de dados com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID

Quando você usa esse parâmetro com o parâmetro StoreMailboxIdentity para identificar e remover a caixa de correio, a caixa de correio é excluída imediatamente e de forma permanente do banco de dados, para que você não consiga se reconectar ou restaurar a caixa de correio. Não é possível usar qualquer um desses parâmetros com o parâmetro Identity.

Se você desconectou uma caixa de correio de seu usuário associado e quiser remover o objeto de caixa de correio do repositório Exchange, use os parâmetros Banco de Dados e StoreMailboxIdentity.

Type:DatabaseIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

Este parâmetro está disponível somente no Exchange local.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Force

A opção Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.

Você pode usar essa opção para executar tarefas de modo programático onde a solicitação por entrada administrativa é inadequada.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

O parâmetro Identity identifica a caixa de correio que você deseja remover. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domain\username
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN

Não é possível usar esse parâmetro com o parâmetro Database.

Type:MailboxIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IgnoreDefaultScope

Este parâmetro está disponível somente no Exchange local.

A opção IgnoreDefaultScope informa ao comando para ignorar a configuração de escopo padrão do destinatário para a sessão do Exchange PowerShell e usar toda a floresta como o escopo. Não é preciso especificar um valor com essa opção.

Essa opção permite que o comando acesse objetos do Active Directory que não estão disponíveis no momento no escopo padrão, mas também introduz as seguintes restrições:

  • Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.
  • Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IgnoreLegalHold

Este parâmetro está disponível somente no Exchange local.

A opção IgnoreLegalHold ignora o status de retenção legal do usuário. Não é preciso especificar um valor com essa opção.

Quando você desabilitar ou remover o usuário, a caixa de correio baseada em nuvem do usuário que está em espera legal também será desabilitada ou removida.

Depois de desabilitar ou remover uma caixa de correio, você não poderá incluí-la em uma pesquisa de descoberta. Quando você desabilita uma caixa de correio, ela é desconectada da conta do usuário. Caixas de correio desconectadas e caixas de correio removidas são excluídas permanentemente do banco de dados da caixa de correio após a expiração do período de retenção de caixa de correio excluído. No entanto, você também pode remover uma caixa de correio e purgá-la imediatamente do banco de dados da caixa de correio. Verifique com o departamento jurídico ou de Recursos Humanos da sua organização antes de desabilitar ou remover uma caixa de correio que está em espera legal.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Migration

A opção Migração é necessária para remover caixas de correio de migração. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-Permanent

Este parâmetro está disponível somente no Exchange local.

O parâmetro Permanent especifica se a caixa de correio deverá ser excluída permanentemente do banco de dados da caixa de correio. Os valores válidos são:

  • $true: a caixa de correio é imediatamente e permanentemente excluída (limpa). Você não pode reconectar ou restaurar a caixa de correio.
  • $false: a caixa de correio desabilitada e retida até que o período de retenção de caixa de correio excluído expire. Você pode reconectar ou restaurar a caixa de correio até que o período de retenção de caixa de correio excluído expire. Esse é o valor padrão.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-PermanentlyDelete

Esse parâmetro só está disponível no serviço baseado em nuvem.

A opção PermanentlyDelete exclui imediatamente e permanentemente (limpa) a caixa de correio, o que impede que você recupere ou restaure a caixa de correio. Não é preciso especificar um valor com essa opção.

Observações:

  • Essa opção funciona apenas em caixas de correio que já foram excluídas, mas ainda são recuperáveis (conhecidas como caixas de correio excluídas suavemente). Use o cmdlet Get-Mailbox para identificar a caixa de correio excluída e, em seguida, pipe os resultados para o cmdlet Remove-Mailbox, conforme mostrado no Exemplo 4 neste tópico.
  • Essa opção não funciona em caixas de correio excluídas com exclusão suave que estão em In-Place Hold ou Litigation Hold (conhecidas como caixas de correio inativas).
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PublicFolder

A opção PublicFolder é necessária para remover caixas de correio de pastas públicas. Não é preciso especificar um valor com essa opção.

As caixas de correio de pasta pública são caixas de correio desenvolvidas especialmente para armazenar a hierarquia e o conteúdo das pastas públicas.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-RemoveArbitrationMailboxWithOABsAllowed

Este parâmetro está disponível somente no Exchange local.

A opção RemoveArbitrationMailboxWithOABsAllowed especifica se as verificações de catálogos de endereço offline (OABs) devem ser ignoradas na caixa de correio de arbitragem especificada que está sendo removida. Não é preciso especificar um valor com essa opção.

Quando você usa essa opção, a caixa de correio de arbitragem é removida, mesmo se OABs estiverem presentes na caixa de correio.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RemoveCNFPublicFolderMailboxPermanently

Esse parâmetro só está disponível no serviço baseado em nuvem.

{{ Preenchimento RemoveCNFPublicFolderMailboxPermanently Description }}

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-RemoveLastArbitrationMailboxAllowed

Este parâmetro está disponível somente no Exchange local.

A opção RemoveLastArbitrationMailboxAllowed especifica se a caixa de correio especificada deve ser removida mesmo que seja a última caixa de correio de arbitragem na organização. Não é preciso especificar um valor com essa opção.

Se a última caixa de correio de arbitragem da organização for removida, não será possível ter grupos de distribuição criadas por usuários ou destinatários moderados.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-StoreMailboxIdentity

Este parâmetro está disponível somente no Exchange local.

O parâmetro StoreMailboxIdentity especifica a caixa de correio que você deseja remover. Ao usar esse parâmetro, você identifica a caixa de correio pelo valor mailboxGUID. Você pode encontrar o valor de GUID usando os cmdlets Get-Mailbox ou Get-MailboxStatistics.

Quando você usa esse parâmetro com o parâmetro Database para identificar e remover a caixa de correio, a caixa de correio é excluída imediatamente e de forma permanente do banco de dados, para que você não consiga se reconectar ou restaurar a caixa de correio. Você não pode nenhum desses parâmetros com o parâmetro Identity.

Se você desconectou uma caixa de correio de seu usuário associado e quiser remover o objeto de caixa de correio do repositório Exchange, use os parâmetros Banco de Dados e StoreMailboxIdentity.

Type:StoreMailboxIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SupervisoryReviewPolicy

Este parâmetro está disponível somente no Exchange local.

Esse parâmetro está reservado para uso interno da Microsoft.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.