Restore-RecoverableItems
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.
Utilize o cmdlet Restore-RecoverableItems itens para restaurar itens eliminados em caixas de correio. Utilize o cmdlet Get-RecoverableItems para localizar os itens eliminados a recuperar.
Este cmdlet só está disponível na função Importar Exportação da Caixa de Correio e, por predefinição, a função não está atribuída a nenhum grupo de funções. Para utilizar este cmdlet, tem de adicionar a função Importar Exportação da Caixa de Correio a um grupo de funções (por exemplo, ao grupo de funções Gestão da Organização). Para obter mais informações, veja Adicionar uma função a um grupo de funções.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Restore-RecoverableItems
-Identity <GeneralMailboxOrMailUserIdParameter>
[-EntryID <String>]
[-FilterEndTime <DateTime>]
[-FilterItemType <String>]
[-FilterStartTime <DateTime>]
[-LastParentFolderID <String>]
[-ResultSize <Unlimited>]
[-SourceFolder <RecoverableItemsFolderType>]
[-SubjectContains <String>]
[<CommonParameters>]
Restore-RecoverableItems
-Identity <GeneralMailboxOrMailUserIdParameter[]>
[-EntryID <String>]
[-FilterEndTime <DateTime>]
[-FilterItemType <String>]
[-FilterStartTime <DateTime>]
[-LastParentFolderID <String>]
[-MaxParallelSize <Int32>]
[-NoOutput]
[-PolicyTag <String[]>]
[-RestoreTargetFolder <String>]
[-ResultSize <Unlimited>]
[-SourceFolder <RecoverableItemsFolderType>]
[-SubjectContains <String>]
[<CommonParameters>]
Description
Os itens são restaurados para a localização da pasta original se as informações estiverem disponíveis para o item. Se não for possível encontrar as informações, o item é restaurado para a pasta predefinida para o tipo de item (Caixa de Entrada para mensagens, Calendário para reuniões e compromissos, etc.).
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-RecoverableItems -Identity laura@contoso.com -FilterItemType IPM.Note -SubjectContains "FY18 Accounting" -FilterStartTime "2/1/2018 12:00:00 AM" -FilterEndTime "2/5/2018 11:59:59 PM"
Depois de utilizar o cmdlet Get-RecoverableItems para verificar a existência do item, este exemplo restaura o item eliminado especificado a partir da caixa de correio especificada:
- Caixa de correio: laura@contoso.com
- Tipo de item: Email mensagem
- Assunto da mensagem: Contabilidade FY18
- Localização: Itens Recuperáveis\Eliminações
- Intervalo de datas: 01/02/2018 a 05/02/2018
Exemplo 2
$mailboxes = Import-CSV "C:\My Documents\RestoreMessage.csv"
$mailboxes | foreach {Restore-RecoverableItems -Identity $_.SMTPAddress -SubjectContains "Project X" -SourceFolder DeletedItems -FilterItemType IPM.Note}
No Exchange Server, este exemplo restaura a mensagem de e-mail eliminada "Projeto X" para as caixas de correio especificadas no ficheiro C:\My Documents\RestoreMessage.csv (Valores separados por vírgulas). O ficheiro CSV utiliza o valor de cabeçalho SMTPAddress e contém o endereço de e-mail de cada caixa de correio numa linha separada como esta:
Endereço SMTP
chris@contoso.com
michelle@contoso.com
laura@contoso.com
julia@contoso.com
O primeiro comando lê o ficheiro CSV para a variável com o nome $mailboxes. O segundo comando restaura a mensagem especificada a partir da pasta Itens Eliminados nessas caixas de correio.
Exemplo 3
Restore-RecoverableItems -Identity "malik@contoso.com","lillian@contoso.com" -FilterItemType IPM.Note -SubjectContains "COGS FY17 Review" -FilterStartTime "3/15/2019 12:00:00 AM" -FilterEndTime "3/25/2019 11:59:59 PM" -MaxParallelSize 2
No Exchange Online, depois de utilizar o cmdlet Get-RecoverableItems para verificar a existência do item, este exemplo restaura os itens eliminados especificados nas caixas de correio especificadas:
- Caixas de correio: malik@contoso.com, lillian@contoso.com
- Tipo de item: Email mensagem
- Assunto da mensagem: Revisão DE COGS FY17
- Localização: Itens Recuperáveis\Eliminações
- Intervalo de datas: 15/03/2019 a 25/03/2019
- Número de caixas de correio processadas em simultâneo: 2
Exemplo 4
Get-RecoverableItems administrator | Restore-RecoverableItems
Este exemplo restaura em massa todos os itens recuperáveis para administrador.
Parâmetros
-EntryID
O parâmetro EntryID especifica o item eliminado que pretende restaurar. O valor EntryID do item eliminado é exclusivo na caixa de correio.
Pode encontrar o EntryID para itens específicos ao utilizar outros filtros de pesquisa no cmdlet Get-RecoverableItems (assunto, intervalo de datas, etc.).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-FilterEndTime
FilterEndTime especifica a data/hora de fim do intervalo de datas. Este parâmetro utiliza o valor LastModifiedTime do item.
Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para utilizar o formato de data abreviada MM/dd/aaaa, introduza 01/09/2018 para especificar 1 de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/2018 17:00".
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-FilterItemType
O parâmetro FilterItemType filtra os resultados pelo valor de propriedade MessageClass (ItemClass) especificado do item eliminado. Por exemplo:
- O IPM. Compromisso (Reuniões e compromissos)
- O IPM. Contacto
- O IPM. Ficheiro
- O IPM. Nota
- O IPM. Tarefa
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-FilterStartTime
FilterStartTime especifica a data/hora de início do intervalo de datas. Este parâmetro utiliza o valor LastModifiedTime do item.
Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para utilizar o formato de data abreviada MM/dd/aaaa, introduza 01/09/2018 para especificar 1 de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/2018 17:00".
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
O parâmetro Identidade especifica a caixa de correio que contém os itens eliminados que pretende 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 Utilizador
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
No Exchange Online, pode especificar várias caixas de correio separadas por vírgulas. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN"
.
Tipo: | GeneralMailboxOrMailUserIdParameter |
Cargo: | 1 |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Exchange Server 2016, Exchange Server 2019 |
-LastParentFolderID
O parâmetro LastParentFolderID especifica o valor FolderID do item antes de ser eliminado. Por exemplo, 53B93149989CA54DBC9702AE619B9CCA000062CE9397.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-MaxParallelSize
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro MaxParallelSize especifica o número máximo de caixas de correio que são processadas pelo comando em paralelo. Um valor válido é um número inteiro de 1 a 10. Normalmente, um valor mais elevado diminui a quantidade de tempo que demora a concluir o comando em várias caixas de correio.
O valor deste parâmetro não tem efeito quando o parâmetro Identidade especifica apenas uma caixa de correio.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Exchange Online |
-NoOutput
Esse parâmetro só está disponível no serviço baseado em nuvem.
O comutador NoOutput restaura os itens eliminados diretamente sem qualquer saída de comando na consola do . Não é preciso especificar um valor com essa opção.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Exchange Online |
-PolicyTag
Esse parâmetro só está disponível no serviço baseado em nuvem.
{{ Descrição do PolicyTag de Preenchimento }}
Tipo: | String[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Exchange Online |
-RestoreTargetFolder
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro RestoreTargetFolder especifica a pasta de nível superior na qual os dados são restauráveis. Se você não especificar este parâmetro, o comando irá restaurar as pastas para o topo da estrutura de pasta na caixa de correio ou arquivo de destino. O conteúdo é mesclado sob as pastas existentes e as novas pastas são criadas se elas já não existirem na estrutura de pasta de destino.
Este parâmetro só está disponível em caixas de correio principais e é ignorado em caixas de correio de arquivo. Será criada uma pasta de destino se não existir. Os caminhos válidos são:
/
/folder1
/folder1/folder2
folder1
folder1/folder2
O anterior ou o seguinte /
será ignorado. Em seguida, será tratado como o caminho relativo da subárvore IPM: /Top Of Information Store
.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Exchange Online |
-ResultSize
O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Caso pretenda retornar todas as solicitações correspondentes à consulta, use unlimited como valor desse parâmetro. O valor padrão é 1000.
Tipo: | Unlimited |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourceFolder
O parâmetro SourceFolder especifica onde procurar itens eliminados na caixa de correio. Os valores válidos são:
- DeletedItems: a pasta Itens Eliminados.
- RecoverableItems: a pasta Itens Recuperáveis\Eliminações. Esta pasta contém itens que foram eliminados da pasta Itens Eliminados (itens eliminados de forma recuperável).
- PurgedItems: a pasta Itens Recuperáveis\Remoção. Esta pasta contém itens que foram removidos da pasta Itens Recuperáveis (itens eliminados).
Se não utilizar este parâmetro, o comando procura nessas três pastas.
- DiscoveryHoldsItems (apenas na cloud): a pasta Itens Recuperáveis\DiscoveryHolds. Esta pasta contém itens que foram removidos da pasta Itens Recuperáveis (itens eliminados) e que estão protegidos por uma suspensão. Para procurar itens eliminados nesta pasta, utilize este parâmetro com o valor DiscoveryHoldsItems.
Tipo: | RecoverableItemsFolderType |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SubjectContains
O parâmetro SubjectContains filtra os itens eliminados pelo valor de texto especificado no campo Assunto. Se o valor contiver espaços, coloque-o entre aspas (").
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Aplica-se a: | Exchange Server 2016, Exchange Server 2019, Exchange Online |