Compartilhar via

Get-ComplianceSearch

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-ComplianceSearch para ver as pesquisas de conformidade estimadas 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.

Sintaxe

Default (Default) 

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

No Exchange no local, este cmdlet está disponível na função Pesquisa de Caixa de Correio. Por predefinição, esta função é atribuída apenas ao grupo de funções Gestão de Deteção.

Para usar este cmdlet no PowerShell de Segurança e Conformidade, 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

Aplicável: Conformidade do & de Segurança

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

O parâmetro Case filtra os resultados pelo nome de uma Deteção de Dados Eletrónicos Standard caso ao qual a pesquisa de compatibilidade está associada. Se o valor contiver espaços, coloque-o entre aspas.

Não pode utilizar este parâmetro para ver pesquisas de conformidade associadas a casos de Deteção de Dados Eletrónicos Premium.

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

-DomainController

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

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.

Propriedades do parâmetro

Tipo:Fqdn
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, Conformidade & de Segurança

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 deste cmdlet, algumas propriedades de pesquisa de conformidade não são devolvidas se não especificar a identidade da pesquisa de conformidade. Essas propriedades são:

  • Itens
  • Tamanho
  • SuccessResults
  • NumBindings
  • ExchangeLocation
  • SharePointLocation
  • OneDriveLocation

Para ver estas propriedades, tem de utilizar o parâmetro Identidade no comando .

Nota: a propriedade NumBindings inclui a caixa de correio principal, o arquivo principal e quaisquer arquivos adicionais para os utilizadores incluídos na pesquisa. NumBindings não é o número de utilizadores incluídos na pesquisa, porque cada utilizador incluído pode ter ou não uma combinação de uma caixa de correio principal, um arquivo principal e arquivos adicionais.

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:ComplianceSearchIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ResultSize

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Conformidade & de Segurança

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

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.