Restore-Mailbox (RTM)
Aplica-se a: Exchange Server 2007
Tópico modificado em: 2007-06-05
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[]>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>]
restore-Mailbox -Identity <MailboxIdParameter> -RSGDatabase <DatabaseIdParameter> -RSGMailbox <StoreMailboxIdParameter> -TargetFolder <String> [-AllContentKeywords <String[]>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <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.
Um grupo de armazenamento de recuperação permite recuperar os dados de uma cópia de backup do banco de dados sem prejudicar o acesso do usuário aos dados atuais. Se houver perda de dados, o grupo de armazenamento de recuperação também poderá ser útil para recuperá-los. Um servidor pode conter somente um grupo de armazenamento de recuperação.
Para executar o cmdlet Restore-Mailbox, você deve usar uma conta à qual esteja delegado o seguinte:
- Função de Administrador do Exchange Server e 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 Server 2007, consulte Considerações sobre permissão.
Os servidores são parte de uma floresta única ou de florestas de recurso. Os dados de caixa de correio só podem ser exportados para caixas de correio dentro da mesma floresta. As contas do serviço de diretório Active Directory associadas à caixa de correio podem estar em uma floresta externa, mas os dados de caixa de correio não podem ser exportados para servidores em florestas diferentes.
Os bancos de dados recuperados e de origem devem ser de um servidor Exchange 2007.
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 caixas de correio conectadas como destino de dados.
Parâmetros
| Parâmetro | Necessário | Tipo | Descrição |
|---|---|---|---|
Identity |
Necessário |
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, supostamente a caixa de correio de origem terá a mesma GUID da caixa de correio de destino. |
RSGDatabase |
Necessário |
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 |
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. |
AllContentKeywords |
Opcional |
System.String[] |
O parâmetro AllContentKeywords especifica os filtros para todos estes itens:
Isso permite uma pesquisa Ou 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. |
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. |
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, a exclusão de calendar só excluirá o calendário em inglês, pois essa palavra possui uma grafia diferente em outros idiomas. |
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, a inclusão de calendar só incluirá o calendário em inglês, pois essa palavra possui uma grafia diferente em outros idiomas. |
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. |
ReportFile |
Opcional |
Microsoft.Exchange.Data.LocalLongFullPath |
O parâmetro ReportFile especifica o caminho e o nome de arquivo do log de relatórios XML. |
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. |
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. |
Tipos de entrada
Tipos de retorno
Erros
Erro |
Descrição |
|
|
Exceções
Exceções |
Descrição |
|
|
Exemplo
No exemplo de código a seguir, o primeiro exemplo restaura uma caixa de correio para o usuário Chris a partir do banco de dados do grupo de armazenamento de recuperação MyRSGDatabase. O segundo exemplo restaura o conteúdo da caixa de correio do Ricardo na caixa de correio do Chris, na pasta de Recuperação. O terceiro exemplo restaura somente as mensagens com o assunto "Reunião" E que contêm a palavra "negócios" no corpo E que estão localizadas nas pastas 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 chris -RSGDatabase MyRSGDatabase
Restore-Mailbox -Identity Chris -RSGDatabase MyRSGDatabase -RSGMailbox Ricardo -TargetFolder Recovery
Restore-Mailbox -Identity Chris -RSGDatabase MyRSGDatabase -SubjectKeywords "Meeting" -ContentKeyword "business" -IncludeFolders \Inbox,\Calendar
Get-mailbox -Database MyDatabase | Restore-Mailbox -RSGDatabase MyRSGDatabase