Restore-RecoverableItems

Módulo:
Exchange PowerShell

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 ambiente ou de outro.

Use o cmdlet Restore-RecoverableItems itens para restaurar itens excluídos em caixas de correio. Use o cmdlet Get-RecoverableItems para localizar os itens excluídos a serem recuperados.

Esse cmdlet está disponível apenas na função Exportação Importação da Caixa de Correio e, por padrão, a função não é atribuída a nenhum grupo de funções. Para usar esse cmdlet, você precisa adicionar a função Exportação Importação da Caixa de Correio a um grupo de funções (por exemplo, para o grupo de funções Gerenciamento da Organização). Para obter mais informações, consulte 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

OnPremises 

Restore-RecoverableItems
    -Identity <GeneralMailboxOrMailUserIdParameter>
    [-EntryID <String>]
    [-FilterEndTime <DateTime>]
    [-FilterItemType <String>]
    [-FilterStartTime <DateTime>]
    [-LastParentFolderID <String>]
    [-ResultSize <Unlimited>]
    [-SourceFolder <RecoverableItemsFolderType>]
    [-SubjectContains <String>]
    [<CommonParameters>]

Cloud 

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 no local da pasta original se as informações estiverem disponíveis para o item. Se as informações não puderem ser encontradas, o item será restaurado na pasta padrão 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 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-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 usar o cmdlet Get-RecoverableItems para verificar a existência do item, este exemplo restaura o item excluído especificado da caixa de correio especificada:

  • Caixa de correio: laura@contoso.com
  • Tipo de item: mensagem de Email
  • Assunto da mensagem: Contabilidade do AF18
  • Local: Itens Recuperáveis\Exclusõ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 email excluída "Projeto X" para as caixas de correio especificadas no arquivo CSV (valor separado por vírgula) C:\Meu Documents\RestoreMessage.csv. O arquivo CSV usa o valor de cabeçalho SMTPAddress e contém o endereço de email de cada caixa de correio em uma linha separada como esta:

SMTPAddress
chris@contoso.com
michelle@contoso.com
laura@contoso.com
julia@contoso.com

O primeiro comando lê o arquivo CSV para a variável chamada $mailboxes. O segundo comando restaura a mensagem especificada da pasta Itens Excluídos 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 usar o cmdlet Get-RecoverableItems para verificar a existência do item, este exemplo restaura os itens excluídos especificados nas caixas de correio especificadas:

  • Caixas de correio: malik@contoso.com, lillian@contoso.com
  • Tipo de item: mensagem de Email
  • Assunto da mensagem: COGS FY17 Review
  • Local: Itens Recuperáveis\Exclusões
  • Intervalo de datas: 15/03/2019 a 25/03/2019
  • Número de caixas de correio processadas simultaneamente: 2

Exemplo 4

Get-RecoverableItems administrator | Restore-RecoverableItems

Este exemplo restaura em massa todos os itens recuperáveis para o administrador.

Parâmetros

-EntryID

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro EntryID especifica o item excluído que você deseja restaurar. O valor EntryID do item excluído é exclusivo na caixa de correio.

Você pode encontrar o EntryID para itens específicos usando outros filtros de pesquisa no cmdlet Get-RecoverableItems (assunto, intervalo de datas etc.).

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

-FilterEndTime

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O FilterEndTime especifica a data/hora de término do intervalo de datas. Esse parâmetro usa 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 usar o formato de data abreviada MM/dd/aaaa, insira 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".

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

-FilterItemType

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro FilterItemType filtra os resultados pelo valor da propriedade MessageClass (ItemClass) especificado do item excluído. Por exemplo:

  • IPM. Compromisso (reuniões e compromissos)
  • IPM. Contato
  • IPM. Arquivo
  • IPM. Observação
  • IPM. Tarefa

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

-FilterStartTime

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O FilterStartTime especifica a data/hora de início do intervalo de datas. Esse parâmetro usa 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 usar o formato de data abreviada MM/dd/aaaa, insira 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".

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

-Identity

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro Identity especifica a caixa de correio que contém os itens excluídos 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

No Exchange Online, você 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".

Propriedades do parâmetro

Tipo:GeneralMailboxOrMailUserIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

OnPremises
Cargo:1
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
Cloud
Cargo:1
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-LastParentFolderID

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro LastParentFolderID especifica o valor FolderID do item antes de ele ser excluído. Por exemplo, 53B93149989CA54DBC9702AE619B9CCA000062CE9397.

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

-MaxParallelSize

Aplicável: Exchange Online

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 alto diminui o tempo necessário para concluir o comando em várias caixas de correio.

O valor desse parâmetro não tem efeito quando o parâmetro Identity especifica apenas uma caixa de correio.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Cloud
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-NoOutput

Aplicável: Exchange Online

Esse parâmetro só está disponível no serviço baseado em nuvem.

O switch NoOutput restaura os itens excluídos diretamente sem nenhuma saída de comando no console. 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

Cloud
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PolicyTag

Aplicável: Exchange Online

Esse parâmetro só está disponível no serviço baseado em nuvem.

{{ Preencher Descrição do PolicyTag }}

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Default
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RestoreTargetFolder

Aplicável: Exchange Online

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 restaurar os dados. 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.

Esse parâmetro está disponível apenas em caixas de correio principais e é ignorado em caixas de correio de arquivo morto. Uma pasta de destino é criada se não existir. Os caminhos válidos são:

  • /
  • /folder1
  • /folder1/folder2
  • folder1
  • folder1/folder2

O precedente ou o à direita são ignorados / . Em seguida, ele é tratado como o caminho relativo da subárvore IPM: /Top Of Information Store.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Default
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ResultSize

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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.

Propriedades do parâmetro

Tipo:Unlimited
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

-SourceFolder

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro SourceFolder especifica onde procurar itens excluídos na caixa de correio. Os valores válidos são:

  • DeletedItems: a pasta Itens Excluídos.
  • RecoverableItems: a pasta Recoverable Items\Exclusões. Esta pasta contém itens que foram excluídos da pasta Itens Excluídos (itens excluídos temporariamente).
  • PurgedItems: a pasta Recoverable Items\PurgedItems. Esta pasta contém itens que foram removidos da pasta Itens Recuperáveis (itens excluídos permanentemente).

Se você não usar esse parâmetro, o comando pesquisará essas três pastas.

  • DiscoveryHoldsItems (somente nuvem): a pasta Recoverable Items\DiscoveryHolds. Esta pasta contém itens que foram removidos da pasta Itens Recuperáveis (itens excluídos permanentemente) e estão protegidos por uma retenção. Para procurar itens excluídos nesta pasta, use este parâmetro com o valor DiscoveryHoldsItems.

Propriedades do parâmetro

Tipo:RecoverableItemsFolderType
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

OnPrem
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SubjectContains

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro SubjectContains filtra os itens excluídos pelo valor de texto especificado no campo Subject. Se o valor contiver espaços, coloque-o entre aspas (").

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

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.