Restore-Mailbox
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 MyRecoveryDatabaseEste 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 RecoveryEste 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,\CalendarEste 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 MyRecoveryDatabaseEste 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.