Compartilhar via


Restore-Mailbox

 

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

Tópico modificado em: 2009-05-14

Use o cmdlet Restore-Mailbox para extrair o conteúdo da caixa de correio a partir de um banco de dados restaurado em um grupo de armazenamento de recuperação.

Sintaxe

restore-Mailbox -Identity <MailboxIdParameter> -RSGDatabase <DatabaseIdParameter> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-ReportFile <LocalLongFullPath>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

restore-Mailbox -Identity <MailboxIdParameter> -RSGDatabase <DatabaseIdParameter> -RSGMailbox <StoreMailboxIdParameter> -TargetFolder <String> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-ReportFile <LocalLongFullPath>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet Restore-Mailbox copia os dados de usuário final a partir de um grupo de armazenamento de recuperação, em qualquer servidor que estiver executando o Microsoft Exchange Server 2007, para uma caixa de correio em qualquer servidor de Caixa de Correio do Exchange 2007, na mesma organização que tiver espaço e recursos adequados para oferecer suporte à caixa de correio. O cmdlet Restore-Mailbox só pode usar caixas de correio desconectadas de um grupo de armazenamento de recuperação em um servidor como origem de dados, e o cmdlet só pode usar caixas de correio conectadas como destino de dados.

Para executar o cmdlet Restore-Mailbox, você deve usar uma conta à qual esteja delegada a função de Administrador do Exchange Server e o grupo Administradores local para os servidores de origem e de destino. Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange 2007, consulte Considerações sobre permissão

Parâmetros

Parâmetro Necessário(s) Tipo Descrição

Identity

Necessário(s)

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

O parâmetro Identity especifica a identidade da caixa de correio de destino. Esse parâmetro é um nome ou uma GUID. Se a caixa de correio de origem não for identificada com o parâmetro RSGMailbox, presume-se que a caixa de correio de origem tenha a mesma GUID da caixa de correio de destino.

RSGDatabase

Necessário(s)

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

O parâmetro RSGDatabase especifica o banco de dados do grupo de armazenamento de recuperação em que a caixa de correio está sendo restaurada. É 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

RSGMailbox

Necessário(s)

Microsoft.Exchange.Configuration.Tasks.StoreMailboxIdParameter

O parâmetro RSGMailbox especifica a caixa de correio no grupo de armazenamento de recuperação que será usada como origem. Esse parâmetro será necessário se a caixa de correio de origem for diferente da caixa de correio de destino.

TargetFolder

Necessário

System.String

O parâmetro TargetFolder especifica a pasta de caixa de correio que será criada na caixa de correio especificada. Se a caixa de correio que está sendo restaurada for diferente da caixa de correio no grupo de armazenamento de recuperação, o cmdlet Restore-Mailbox executará uma mesclagem.

AllContentKeywords

Opcional

System.String[]

O parâmetro AllContentKeywords especifica os filtros para todos estes itens:

  • Assunto

  • Corpo da mensagem

  • Conteúdo do anexo

Isso permite uma pesquisa OR de todos esses campos. Se seus critérios de pesquisa fizerem parte do assunto, do corpo da mensagem ou do conteúdo do anexo, você obterá resultados.

AllowDuplicates

Opcional

System.Management.Automation.SwitchParameter

O parâmetro AllowDuplicates é usado para copiar itens de email sem verificar se eles são duplicatas de itens existente e sem remover itens duplicados. É recomendável usar o parâmetro AllowDuplicates junto com o parâmetro IncludeFolders.

AttachmentFilenames

Opcional

System.String[]

O parâmetro AttachmentFilenames especifica o filtro para nome de arquivo de anexo. Você pode usar caracteres curinga na cadeia de caracteres. Por exemplo, é possível usar *.txt para exportar itens com a extensão .txt.

BadItemLimit

Opcional

System.Int32

O parâmetro BadItemLimit especifica o número de itens danificados em uma caixa de correio a serem ignorados para que ocorra falha na operação de exportação.

Confirm

Opcional

System.Management.Automation.SwitchParameter

O parâmetro Confirm faz com que o comando pause o processamento e exige que o administrador confirme o que o comando fará antes que o processamento continue. O valor padrão é $true.

ContentKeywords

Opcional

System.String[]

O parâmetro ContentKeywords especifica os filtros de palavras-chave para o corpo da mensagem e para o conteúdo dos anexos na caixa de correio de origem.

EndDate

Opcional

System.DateTime

O parâmetro EndDate especifica a data de término da filtragem do conteúdo que será exportado da caixa de correio de origem. Somente itens da caixa de correio com data anterior à data de término serão exportados. Ao inserir uma data específica, use o formato de data abreviada definido nas configurações de Opções Regionais do computador local. Por exemplo, se o seu computador estiver configurado para usar o formato de data abreviada dd/mm/aaaa, digite 01/03/2006 para especificar 1º de março de 2006.

ExcludeFolders

Opcional

Microsoft.Exchange.Data.Mapi.MapiFolderPath[]

O parâmetro ExcludeFolders especifica a lista de pastas a serem excluídas durante a exportação. As pastas são excluídas à medida que são inseridas. Elas não estão localizadas. Por exemplo, excluir a pasta calendar exclui apenas a versão em inglês dessa pasta porque calendar em outros idiomas é uma palavra diferente.

GlobalCatalog

Opcional

Microsoft.Exchange.Data.Fqdn

O parâmetro GlobalCatalog especifica o catálogo global a ser usado para pesquisar a caixa de correio de destino.

IncludeFolders

Opcional

Microsoft.Exchange.Data.Mapi.MapiFolderPath[]

O parâmetro IncludeFolders especifica a lista de pastas a serem incluídas durante a exportação. As pastas são incluídas à medida que são inseridas. Elas não estão localizadas. Por exemplo, incluir a pasta calendar inclui apenas a versão em inglês dessa pasta porque calendar em outros idiomas é uma palavra diferente.

Locale

Opcional

System.Globalization.CultureInfo

O parâmetro Locale especifica a configuração local de uma mensagem a ser restaurada. Se esse filtro estiver definido, apenas as mensagens de configuração local serão extraídas.

MaxThreads

Opcional

System.Int32

O parâmetro MaxThreads especifica o número máximo de threads a serem usados.

RecipientKeywords

Opcional

System.String[]

O parâmetro RecipientKeywords especifica os filtros de palavra-chave para destinatários de itens da caixa de correio de origem. O filtro localizará seqüência de pesquisa mesmo se ela for parte de uma palavra. Não é uma pesquisa de palavra inteira.

ReportFile

Opcional

Microsoft.Exchange.Data.LocalLongFullPath

O parâmetro ReportFile especifica o caminho e o nome de arquivo do log de relatórios XML.

SenderKeywords

Optional

System.String[]

O parâmetro SenderKeywords especifica os filtros de palavra-chave para remetentes de itens da caixa de correio de origem. O filtro localizará seqüência de pesquisa mesmo se ela for parte de uma palavra. Não é uma pesquisa de palavra inteira.

StartDate

Opcional

System.DateTime

O parâmetro StartDate especifica a data de início. A data de início deve ser anterior à data de término.

SubjectKeywords

Opcional

System.String[]

O parâmetro SubjectKeywords especifica os filtros de palavra-chave para assuntos de itens da caixa de correio de origem. O filtro localizará seqüência de pesquisa mesmo se ela for parte de uma palavra. Não é uma pesquisa de palavra inteira.

TargetFolder

Opcional

System.String

O parâmetro TargetFolder especifica a pasta de caixa de correio que será criada na caixa de correio especificada. Esse parâmetro será necessário, se a caixa de correio sendo restaurada for diferente da caixa de correio no grupo de armazenamento de recuperação. (Por exemplo, o valor especificado com o parâmetro Identity não é o mesmo valor especificado com o parâmetro RSGMailbox.) Nesse caso, o cmdlet Restore-Mailbox executará uma mesclagem. Se os valores forem iguais, o parâmetro TargetFolder não será necessário.

ValidateOnly

Opcional

System.Management.Automation.SwitchParameter

O parâmetro ValidateOnly instrui o comando a simular as ações que ele executará no objeto. O valor padrão é $true.

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, o administrador poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. O valor padrão é $true.

Tipos de entrada

Tipos de retorno

Erros

Exceções

Exemplo

No exemplo de código a seguir, o primeiro exemplo restaura uma caixa de correio para o usuário Scott do banco de dados do grupo de armazenamento de recuperação MyRSGDatabase.

O segundo exemplo restaura o conteúdo da caixa de correio de John na caixa de correio de Scott, na pasta de Recuperação.

O terceiro exemplo restaura apenas a mensagem com o assunto "Reunião", com o corpo de mensagem que contém a palavra "negócios" e com o local de mensagem na pasta Caixa de Entrada ou Calendário. Esse exemplo supõe que a caixa de correio esteja em português.

O último exemplo restaura todas as caixas de correio no banco de dados da caixa de correio MyDatabase que também estão presentes em MyRSGDatabase.

Restore-Mailbox -Identity Scott -RSGDatabase MyRSGDatabase
Restore-Mailbox -Identity Scott -RSGDatabase MyRSGDatabase -RSGMailbox John -TargetFolder Recovery
Restore-Mailbox -Identity Scott -RSGDatabase MyRSGDatabase -SubjectKeywords "Meeting" -ContentKeyword "business" -IncludeFolders \Inbox,\Calendar
Get-Mailbox -Database MyDatabase | Restore-Mailbox -RSGDatabase MyRSGDatabase