Remove-StoreMailbox

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

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Remove-StoreMailbox para limpar a caixa de correio e todo seu conteúdo de mensagens do banco de dados de caixa de correio. Isso resulta na perda de dados permanente para a caixa de correio que está sendo limpa. Você pode executar esse cmdlet somente em caixas de correio desconectadas ou excluídas por software. Executar esse comando em uma caixa de correio ativa falhará e você receberá um erro.

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

Syntax

Remove-StoreMailbox
      -Database <DatabaseIdParameter>
      -Identity <StoreMailboxIdParameter>
      -MailboxState <MailboxStateParameter>
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

Description

Quando as caixas de correio são movidas entre bancos de dados, o Exchange não exclui totalmente a caixa de correio do banco de dados de origem imediatamente após a conclusão da movimentação. Ao contrário, a caixa de correio no banco de dados da caixa de correio de origem é alternada para um estado de software excluído, que permite os dados da caixa de correio sejam acessados durante uma operação de restauração de caixa de correio usando o novo conjunto de cmdlets MailboxRestoreRequest. As caixas de correio excluídas por software são mantidas no banco de dados de origem até que o período de retenção de caixas de correio excluídas expire.

Para exibir caixas de correio excluídas por software, execute o cmdlet Get-MailboxStatistics em relação a um banco de dados usando a propriedade DisconnectReason com valor de SoftDeleted.

Uma caixa de correio é marcada como Desabilitar imediatamente após o comando Disable-Mailbox ou Remove-Mailbox ser concluído. O Exchange retém caixas de correio desabilitadas no banco de dados da caixa de correio com base nas configurações de retenção de caixa de correio excluídas configuradas para esse banco de dados de caixa de correio. Depois de um tempo especificado, a caixa de correio é excluída permanentemente.

Para exibir caixas de correio desabilitadas, execute o cmdlet Get-MailboxStatistics em relação a um banco de dados usando a propriedade DisconnectReason com valor de Disabled.

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-StoreMailbox -Database MBD01 -Identity Ayla -MailboxState SoftDeleted

Esse exemplo limpa a caixa de correio excluída por software para Ayla Kol do banco de dados de caixa de correio MBD01.

Exemplo 2

Remove-StoreMailbox -Database MBD01 -Identity "2ab32ce3-fae1-4402-9489-c67e3ae173d3" -MailboxState Disabled

Esse exemplo limpa permanentemente a caixa de correio desconectada com o GUID 2ab32ce3-fae1-4402-9489-c67e3ae173d3 do banco de dados de caixa de correio MBD01.

Exemplo 3

Get-MailboxStatistics -Database MBD01 | where {$_.DisconnectReason -match "SoftDeleted"} | foreach {Remove-StoreMailbox -Database $_.Database -Identity $_.MailboxGuid -MailboxState SoftDeleted}

Esse exemplo limpa permanentemente todas as caixas de correio excluídas por software do banco de dados de caixa de correio MBD01.

Parâmetros

-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

-Database

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

  • Nome
  • DN (nome diferenciado)
  • GUID
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

-Identity

O parâmetro Identity especifica a identidade da caixa de correio que deseja remover. Use o GUID da caixa de correio como o valor desse parâmetro.

Execute o seguinte comando para obter a caixa de correio GUID e outras informações para todas as caixas de correio em sua organização: Get-MailboxDatabase | Get-MailboxStatistics | Format-List DisplayName, MailboxGuid, Database, DisconnectReason, DisconnectDate.

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

-MailboxState

O parâmetro MailboxState especifica o estado da caixa de correio no banco de dados de caixa de correio de origem. Não é possível usar este parâmetro com o parâmetro IncludedRecipients ou qualquer um dos parâmetros Conditional.

  • Desabilitado
  • SoftDeleted
Type:MailboxStateParameter
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

-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

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.