Compartilhar via

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 definições podem ser exclusivos de um ambiente ou outro.

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

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 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 artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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

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

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.).

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 Online

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".

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 Online

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

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 Online

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".

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

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".

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 Online

O parâmetro LastParentFolderID especifica o valor FolderID do item antes de ser eliminado. 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 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.

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 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.

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.

{{ Descrição do PolicyTag de Preenchimento }}

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 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. Uma pasta de destino é criada se não existir. Os caminhos válidos são:

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

Os anteriores ou à direita / são ignorados. Em seguida, é 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 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 Online

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.

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 Online

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 (").

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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.