Restore-Mailbox

Referência

Módulo:: ExchangePowerShell

Aplica-se a:: Exchange Server 2010

Esse cmdlet só está disponível no Exchange Server 2010.

Use o cmdlet Restore-Mailbox para extrair conteúdo de caixa de correio de um banco de dados restaurado.

Observação: em Exchange Server 2010 Service Pack 1 (SP1) ou posterior, use o cmdlet New-MailboxRestoreRequest em vez do cmdlet Restore-Mailbox para extrair o conteúdo da caixa de correio de um banco de dados restaurado.

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

Syntax

Restore-Mailbox
       [-Identity] <MailboxIdParameter>
       -RecoveryDatabase <DatabaseIdParameter>
       -RecoveryMailbox <StoreMailboxIdParameter>
       -TargetFolder <String>
       [-AllowDuplicates]
       [-AllContentKeywords <String[]>]
       [-AttachmentFilenames <String[]>]
       [-BadItemLimit <Int32>]
       [-Confirm]
       [-ContentKeywords <String[]>]
       [-EndDate <DateTime>]
       [-ExcludeFolders <MapiFolderPath[]>]
       [-GlobalCatalog <Fqdn>]
       [-IncludeFolders <MapiFolderPath[]>]
       [-Locale <CultureInfo>]
       [-MaxThreads <Int32>]
       [-RecipientKeywords <String[]>]
       [-SenderKeywords <String[]>]
       [-StartDate <DateTime>]
       [-SubjectKeywords <String[]>]
       [-ValidateOnly]
       [-WhatIf]
       [<CommonParameters>]

Description

O cmdlet Restore-Mailbox copia dados do usuário final de qualquer servidor em execução Microsoft Exchange Server 2010 para uma caixa de correio em um servidor de caixa de correio do Exchange 2010 na mesma organização que tem espaço e recursos adequados para dar suporte à caixa de correio. O cmdlet Restore-Mailbox só pode usar caixas de correio desconectadas em um servidor como fonte de dados, e o cmdlet só pode usar caixas de correio conectadas como um destino para dados.

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

Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase

Este exemplo restaura uma caixa de correio para o usuário Scott do banco de dados MyRecoveryDatabase.

Exemplo 2

Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -RecoveryMailbox John -TargetFolder Recovery

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

Exemplo 3

Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -SubjectKeywords "Meeting" -ContentKeywords "business" -IncludeFolders \Inbox,\Calendar

Este exemplo restaura apenas o email com o assunto Reunião, com o corpo da mensagem que contém o negócio de palavras e com o local da mensagem na caixa de entrada ou na pasta Calendário. Este exemplo pressupõe que a caixa de correio esteja em inglês.

Exemplo 4

Get-Mailbox -Database MyDatabase | Restore-Mailbox -RecoveryDatabase MyRecoveryDatabase

Este exemplo restaura em massa todas as caixas de correio no banco de dados da caixa de correio MyDatabase que também estão presentes no MyRecoveryDatabase.

Parâmetros

-AllContentKeywords

O parâmetro AllContentKeywords especifica os filtros para todos os seguintes:

Assunto
Corpo da mensagem
Conteúdo de anexo

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-AllowDuplicates

A opção AllowDuplicates copia itens de email sem verificar se são duplicatas de itens existentes e sem remover itens duplicados. Não é preciso especificar um valor com essa opção.

Recomendamos que você use essa opção com o parâmetro IncludeFolders.

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

-AttachmentFilenames

O parâmetro AttachmentFilenames especifica o filtro para o nome do arquivo de anexo. Você pode usar caracteres curinga na cadeia de caracteres. Por exemplo, você pode usar *.txt para exportar itens que tenham uma extensão .txt.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-BadItemLimit

O parâmetro BadItemLimit especifica o número de itens corrompidos em uma caixa de correio a serem ignorados antes que a operação de exportação falhe.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-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

-ContentKeywords

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-EndDate

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

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-ExcludeFolders

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. Eles não estão localizados. Por exemplo, excluir calendário exclui apenas calendário em inglês porque calendário em outros idiomas é uma palavra diferente.

Type:	MapiFolderPath[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-GlobalCatalog

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

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

-Identity

O parâmetro Identity especifica a caixa de correio que você deseja restaurar. É 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

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

-IncludeFolders

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. Eles não estão localizados. Por exemplo, incluir calendário inclui apenas calendário em inglês porque calendário em outros idiomas é uma palavra diferente.

Type:	MapiFolderPath[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Locale

O parâmetro Locale especifica a configuração de localidade em uma mensagem a ser restaurada. Com esse conjunto de filtros, somente as mensagens com a configuração de localidade especificada são extraídas.

Type:	CultureInfo
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MaxThreads

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RecipientKeywords

O parâmetro RecipientKeywords especifica os filtros de palavra-chave para destinatários de itens na caixa de correio de origem. Esse filtro localiza a cadeia de caracteres de pesquisa mesmo que seja parte de uma palavra. Isso não é uma pesquisa de palavras inteira.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RecoveryDatabase

O parâmetro RecoveryDatabase especifica o banco de dados de recuperação do qual você está restaurando a caixa de correio. É 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

-RecoveryMailbox

O parâmetro RecoveryMailbox especifica a caixa de correio a ser usada como caixa de correio de origem. Esse parâmetro será necessário se a caixa de correio de origem for diferente da caixa de correio de destino.

Você identifica a caixa de correio pelo valor GUID. Você pode encontrar o valor de GUID usando os cmdlets Get-Mailbox ou Get-MailboxStatistics.

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

-SenderKeywords

O parâmetro SenderKeywords especifica os filtros de palavra-chave para remetentes de itens na caixa de correio de origem. Esse filtro localiza a cadeia de caracteres de pesquisa mesmo que seja parte de uma palavra. Isso não é uma pesquisa de palavras inteira.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-StartDate

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

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-SubjectKeywords

O parâmetro SubjectKeywords especifica os filtros de palavra-chave para assuntos de itens na caixa de correio de origem. Esse filtro localiza a cadeia de caracteres de pesquisa mesmo que seja parte de uma palavra. Isso não é uma pesquisa de palavras inteira.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-TargetFolder

O parâmetro TargetFolder especifica a pasta de caixa de correio criada na caixa de correio especificada. Esse parâmetro será necessário se a caixa de correio que está sendo restaurada for diferente da caixa de correio de destino. (Por exemplo, o valor especificado com o parâmetro Identity não é o mesmo que o valor especificado com o parâmetro RecoveryMailbox.) Nesse caso, o comando Restore-Mailbox executa uma mesclagem. Se os valores forem os mesmos, o parâmetro TargetFolder não será necessário.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-ValidateOnly

A opção ValidateOnly informa ao comando para avaliar as condições e os requisitos necessários para executar a operação e, em seguida, relatar se a operação será bem-sucedida ou falhará. Não é preciso especificar um valor com essa opção.

Nenhuma alteração é feita quando você usa essa opção.

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

-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

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.