Compartilhar via


Get-ComplianceSearch

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-ComplianceSearch para exibir pesquisas de conformidade de estimativa no Exchange Server 2016 ou posterior e no portal de conformidade do Microsoft Purview. Depois de usar o cmdlet New-ComplianceSearchAction para definir uma ação de visualização para a pesquisa de conformidade, use o cmdlet Get-ComplianceSearchAction para exibir os resultados da pesquisa de conformidade.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Get-ComplianceSearch
   [[-Identity] <ComplianceSearchIdParameter>]
   [-Case <String>]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<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.

No Exchange local, esse cmdlet está disponível na função Pesquisa de Caixa de Correio. Por padrão, essa função é atribuída apenas ao grupo de funções do Gerenciamento de Descobertas.

Para usar esse cmdlet no PowerShell de Conformidade de Segurança & , você precisa receber permissões. Para obter mais informações, confira Permissões no portal de conformidade do Microsoft Purview.

Exemplos

Exemplo 1

Get-ComplianceSearch

Esse exemplo mostra uma lista resumida de todas as pesquisas de conformidade.

Exemplo 2

Get-ComplianceSearch -Identity "Case 1234" | Format-List

Este exemplo mostra detalhes da pesquisa de conformidade chamada Caso 1234.

Parâmetros

-Case

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

O parâmetro Case filtra os resultados pelo nome de um caso padrão de descoberta eletrônica ao qual a pesquisa de conformidade está associada. Se o valor contiver espaços, coloque-o entre aspas.

Você não pode usar esse parâmetro para exibir pesquisas de conformidade associadas a casos premium de descoberta eletrônica.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-DomainController

Este parâmetro está disponível somente no Exchange local.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-Identity

O parâmetro Identity especifica a pesquisa de conformidade que você deseja visualizar.

Quando você usa esse parâmetro, o parâmetro Identity é obrigatório, mas o valor será ignorado. Por exemplo, use o valor 000 para o parâmetro Identity.

  • Nome
  • JobRunId (GUID)

JobRunId (GUID)

Para melhorar o desempenho desse cmdlet, algumas propriedades de pesquisa de conformidade não serão retornadas se você não especificar a identidade da pesquisa de conformidade. Essas propriedades são:

  • Itens
  • Size
  • SuccessResults
  • NumBindings
  • ExchangeLocation
  • SharePointLocation
  • OneDriveLocation

Para exibir essas propriedades, você precisa usar o parâmetro Identity no comando.

Type:ComplianceSearchIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-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, Security & Compliance