Partilhar via

Get-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 Get-RecoverableItems itens para ver itens eliminados em caixas de correio. Depois de localizar os itens excluídos, use o cmdlet Restore-RecoverableItems para restaurá-los.

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 

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

Cloud 

Get-RecoverableItems
    -Identity <GeneralMailboxOrMailUserIdParameter[]>
    [-EntryID <String>]
    [-FilterEndTime <DateTime>]
    [-FilterItemType <String>]
    [-FilterStartTime <DateTime>]
    [-LastParentFolderID <String>]
    [-MaxParallelSize <Int32>]
    [-PolicyTag <String[]>]
    [-ResultSize <Unlimited>]
    [-SkipCount <Int32>]
    [-SourceFolder <RecoverableItemsFolderType>]
    [-SubjectContains <String>]
    [<CommonParameters>]

Description

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

Get-RecoverableItems -Identity laura@contoso.com -SubjectContains "FY17 Accounting" -FilterItemType IPM.Note -FilterStartTime "2/1/2018 12:00:00 AM" -FilterEndTime "2/5/2018 11:59:59 PM"

Este exemplo devolve todas as mensagens eliminadas recuperáveis disponíveis com o assunto especificado na caixa laura@contoso.com de correio para o intervalo de data/hora especificado.

Exemplo 2

Get-RecoverableItems -Identity "malik@contoso.com", "lillian@contoso.com" -FilterItemType IPM.Note -FilterStartTime "3/15/2019 12:00:00 AM" -FilterEndTime "3/25/2019 11:59:59 PM"

Este exemplo devolve todas as mensagens eliminadas recuperáveis disponíveis com o assunto especificado nas caixas de correio de malik@contoso.com e lillian@contoso.com para o intervalo de data/hora especificado.

Parâmetros

-EntryID

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, 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 Server SE, 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 Server SE, 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 Server SE, 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, Exchange Server SE, Exchange Online

O parâmetro Identidade especifica a caixa de correio que contém os itens eliminados que pretende ver. É 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".

Atenção: o valor $null ou um valor inexistente para o parâmetro Identidade devolve todos os objetos como se tivesse executado o comando Get- sem o parâmetro Identity. Verifique se as listas de valores do parâmetro Identity estão corretas e não contêm valores de $null inexistentes.

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

-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

Cloud
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

-SkipCount

Aplicável: Exchange Online

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

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

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

-SourceFolder

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, 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

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