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