Restore-Mailbox
Este cmdlet está disponível apenas no Exchange Server 2010.
Use o cmdlet Restore-Mailbox para extrair o conteúdo da caixa de correio de um banco de dados restaurado.
Observação: no 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.
Sintaxe
Default (Default)
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 os dados do usuário final de qualquer servidor que esteja executando 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 tenha 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 uma fonte de dados e o cmdlet só pode usar caixas de correio conectadas como destino para dados.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo 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 contendo a palavra negócios e com o local da mensagem na pasta Caixa de entrada ou 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 de caixa de correio MyDatabase que também estão presentes em MyRecoveryDatabase.
Parâmetros
-AllContentKeywords
Aplicável: Exchange Server 2010
O parâmetro AllContentKeywords especifica os filtros para todos os seguintes:
- Assunto
- Corpo da mensagem
- Conteúdo do 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 do anexo, você obterá resultados.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-AllowDuplicates
Aplicável: Exchange Server 2010
O comutador 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-AttachmentFilenames
Aplicável: Exchange Server 2010
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 têm uma extensão .txt.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-BadItemLimit
Aplicável: Exchange Server 2010
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.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Server 2010
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, 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 reconhecer o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ContentKeywords
Aplicável: Exchange Server 2010
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.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-EndDate
Aplicável: Exchange Server 2010
O parâmetro EndDate especifica a data final para que o conteúdo de filtragem seja exportado da caixa de correio de origem. Somente os 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 abreviada definido nas configurações de Opções Regionais definidas no computador local. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada MM/dd/aaaa, insira 01/03/2010 para especificar 1º de março de 2010.
Propriedades do parâmetro
| Tipo: | DateTime |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExcludeFolders
Aplicável: Exchange Server 2010
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 são localizados. Por exemplo, excluir calendário exclui apenas calendário em inglês porque calendário em outros idiomas é uma palavra diferente.
Propriedades do parâmetro
| Tipo: | MapiFolderPath[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-GlobalCatalog
Aplicável: Exchange Server 2010
O parâmetro GlobalCatalog especifica o catálogo global a ser usado para pesquisar a caixa de correio de destino.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2010
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)
- Domínio\Nome de usuário
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
Propriedades do parâmetro
| Tipo: | MailboxIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-IncludeFolders
Aplicável: Exchange Server 2010
O parâmetro IncludeFolders especifica a lista de pastas a serem incluídas durante a exportação. As pastas são incluídas conforme são inseridas. Eles não são localizados. Por exemplo, a inclusão de calendário inclui apenas calendário em inglês porque calendário em outros idiomas é uma palavra diferente.
Propriedades do parâmetro
| Tipo: | MapiFolderPath[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Locale
Aplicável: Exchange Server 2010
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.
Propriedades do parâmetro
| Tipo: | CultureInfo |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MaxThreads
Aplicável: Exchange Server 2010
O parâmetro MaxThreads especifica o número máximo de threads a serem usados.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RecipientKeywords
Aplicável: Exchange Server 2010
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 ela seja parte de uma palavra. Este não é um caça-palavras inteiro.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RecoveryDatabase
Aplicável: Exchange Server 2010
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
Propriedades do parâmetro
| Tipo: | DatabaseIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RecoveryMailbox
Aplicável: Exchange Server 2010
O parâmetro RecoveryMailbox especifica a caixa de correio a ser usada como a caixa de correio de origem. Esse parâmetro é necessário se a caixa de correio de origem for diferente da caixa de correio de destino.
Você identifica a caixa de correio por seu valor GUID. Você pode encontrar o valor de GUID usando os cmdlets Get-Mailbox ou Get-MailboxStatistics.
Propriedades do parâmetro
| Tipo: | StoreMailboxIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-SenderKeywords
Aplicável: Exchange Server 2010
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 ela seja parte de uma palavra. Este não é um caça-palavras inteiro.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-StartDate
Aplicável: Exchange Server 2010
O parâmetro StartDate especifica a data de início. A data de início deve ser anterior à data de término.
Propriedades do parâmetro
| Tipo: | DateTime |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SubjectKeywords
Aplicável: Exchange Server 2010
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 ela seja parte de uma palavra. Este não é um caça-palavras inteiro.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-TargetFolder
Aplicável: Exchange Server 2010
O parâmetro TargetFolder especifica a pasta da 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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ValidateOnly
Aplicável: Exchange Server 2010
A opção ValidateOnly especifica se o sucesso ou falha potencial do comando deve ser avaliado sem fazer alterações. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2010
A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
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.