Get-ComplianceSearchAction

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-ComplianceSearchAction para exibir informações sobre ações de pesquisa de conformidade.

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

Syntax

Get-ComplianceSearchAction
   [[-Identity] <ComplianceSearchActionIdParameter>]
   [-Case <String>]
   [-Details]
   [-DomainController <Fqdn>]
   [-IncludeCredential]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-ComplianceSearchAction
   [-Preview]
   [-Case <String>]
   [-Details]
   [-DomainController <Fqdn>]
   [-IncludeCredential]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-ComplianceSearchAction
   [-Purge]
   [-Case <String>]
   [-Details]
   [-DomainController <Fqdn>]
   [-IncludeCredential]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-ComplianceSearchAction
   [-Export]
   [-Case <String>]
   [-Details]
   [-DomainController <Fqdn>]
   [-IncludeCredential]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Description

Depois de criar e executar uma pesquisa de conformidade usando o cmdlet New-ComplianceSearch e executá-la usando o cmdlet Start-ComplianceSearch, atribua uma ação de pesquisa usando o cmdlet New-ComplianceSearchAction. Use o cmdlet Get-ComplianceSearchAction para rastrear o progresso da ação de pesquisa de conformidade.

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

Esse exemplo mostra uma lista resumida de todas as ações da pesquisas de conformidade.

Exemplo 2

Get-ComplianceSearchAction -Identity "Case 1234_Preview" | Format-List

Este exemplo mostra detalhes sobre a ação de pesquisa de conformidade chamada "Caso 1234_Visualização"

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 do caso especificado. 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:Security & Compliance

-Details

A opção Details especifica se é necessário incluir informações detalhadas nos resultados. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
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

-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

-Export

A opção Export filtra os resultados por ações de pesquisa de conformidade de Export. Não é preciso especificar um valor com essa opção.

Você não pode usar essa opção com os parâmetros Identidade, Visualização ou Limpeza.

Type:SwitchParameter
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

-Identity

O parâmetro Identity especifica a ação de pesquisa de conformidade que você deseja exibir. É possível usar qualquer valor que identifique exclusivamente a ação de pesquisa de conformidade. Por exemplo:

  • Nome: o nome da ação de pesquisa de conformidade usa a sintaxe "Compliance Search Name_Action". Por exemplo, "Case 1234_Preview".
  • JobRunId (GUID)

Você não pode usar esse parâmetro com os parâmetros Exportar, Visualizar ou Limpar.

Quando você usa o parâmetro Identity, mais detalhes são retornados nos resultados. Por exemplo:

  • Na linha Resultados, os valores das propriedades Contagem de Itens, Tamanho total e Detalhes são preenchidos.
  • As linhas de localização são adicionadas aos resultados.
  • O valor da propriedade NumBinding é preenchido.
  • As propriedades de localização afetadas (por exemplo, ExchangeLocation) são preenchidas.
  • O valor da propriedade CaseName é preenchido.
Type:ComplianceSearchActionIdParameter
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

-IncludeCredential

A opção IncludeCredential especifica se deve incluir a credencial nos resultados. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
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

-Preview

A opção Preview filtra os resultados por ações de pesquisa de conformidade Preview. Não é preciso especificar um valor com essa opção.

Você não pode usar essa opção com os parâmetros Exportar, Identidade ou Limpar.

Type:SwitchParameter
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

-Purge

Observação: no PowerShell de Conformidade de Segurança & , esse parâmetro está disponível apenas na função Pesquisar e Limpar. Por padrão, essa função é atribuída apenas aos grupos de funções Gerenciamento de Organização e Pesquisador de Dados.

A opção Purge filtra os resultados por ações de pesquisa de conformidade Purge. Não é preciso especificar um valor com essa opção.

Você não pode usar essa opção com os parâmetros Exportar, Identidade ou Visualização.

Type:SwitchParameter
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

-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