Get-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.
Use o cmdlet Get-RecoverableItems itens para exibir itens excluídos em caixas de correio. Depois de localizar os itens excluídos, use o cmdlet Restore-RecoverableItems para restaurá-los.
Esse cmdlet está disponível apenas na função Exportação de Importação de 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 de Importação de Caixa de Correio a um grupo de funções (por exemplo, ao grupo de funções gerenciamento de 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.
Syntax
Get-RecoverableItems
-Identity <GeneralMailboxOrMailUserIdParameter>
[-EntryID <String>]
[-FilterEndTime <DateTime>]
[-FilterItemType <String>]
[-FilterStartTime <DateTime>]
[-LastParentFolderID <String>]
[-ResultSize <Unlimited>]
[-SourceFolder <RecoverableItemsFolderType>]
[-SubjectContains <String>]
[<CommonParameters>] Get-RecoverableItems
-Identity <GeneralMailboxOrMailUserIdParameter[]>
[-EntryID <String>]
[-FilterEndTime <DateTime>]
[-FilterItemType <String>]
[-FilterStartTime <DateTime>]
[-LastParentFolderID <String>]
[-MaxParallelSize <Int32>]
[-PolicyTag <String[]>]
[-ResultSize <Unlimited>]
[-SourceFolder <RecoverableItemsFolderType>]
[-SubjectContains <String>]
[<CommonParameters>] Description
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
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 retorna todas as mensagens excluídas recuperáveis disponíveis com o assunto especificado na caixa de correio laura@contoso.com 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 retorna todas as mensagens excluídas recuperáveis disponíveis com o assunto especificado nas caixas de correio de ambos malik@contoso.com e lillian@contoso.com para o intervalo de data/hora especificado.
Parâmetros
-EntryID
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.).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-FilterEndTime
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/yyyy, 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".
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 excluído. Por exemplo:
- IPM. Compromisso (Reuniões e compromissos)
- IPM. Contato
- IPM. Arquivo
- IPM. Nota
- IPM. Tarefa
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-FilterStartTime
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/yyyy, 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".
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
O parâmetro Identity especifica a caixa de correio que contém os itens excluídos que você deseja exibir. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- Domain\username
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
Em 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".
| Type: | GeneralMailboxOrMailUserIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-LastParentFolderID
O parâmetro LastParentFolderID especifica o valor FolderID do item antes de ser excluído. Por exemplo, 53B93149989CA54DBC9702AE619B9CCA0000062CE9397.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 processadas pelo comando em paralelo. Um valor válido é um 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PolicyTag
Esse parâmetro só está disponível no serviço baseado em nuvem.
{{ Fill PolicyTag Description }}
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourceFolder
O parâmetro SourceFolder especifica onde pesquisar itens excluídos na caixa de correio. Os valores válidos são:
DeletedItems: a pasta Itens Excluídos.
RecoverableItems: a pasta Itens Recuperáveis\Exclusões. Esta pasta contém itens que foram excluídos da pasta Itens Excluídos (itens excluídos suavemente).
PurgedItems: a pasta Itens Recuperáveis\Purga. Esta pasta contém itens que foram removidos da pasta Itens Recuperáveis (itens excluídos).
Se você não usar esse parâmetro, o comando pesquisará essas três pastas.
DiscoveryHoldsItems: a pasta Itens Recuperáveis\DiscoveryHolds. Esta pasta contém itens que foram limpos da pasta Itens Recuperáveis (itens excluídos por força) e são protegidos por um porão. Para pesquisar itens excluídos nesta pasta, use esse parâmetro com o valor DiscoveryHoldsItems.
| Type: | RecoverableItemsFolderType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SubjectContains
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 (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |