Get-ComplianceSearchAction
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-ComplianceSearchAction para ver informações sobre as ações de pesquisa de conformidade.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Identity
Get-ComplianceSearchAction
[[-Identity] <ComplianceSearchActionIdParameter>]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-Organization <OrganizationIdParameter>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Preview
Get-ComplianceSearchAction
[-Preview]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-Organization <OrganizationIdParameter>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Purge
Get-ComplianceSearchAction
[-Purge]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-Organization <OrganizationIdParameter>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Export
Get-ComplianceSearchAction
[-Export]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-Organization <OrganizationIdParameter>]
[-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 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-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
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 do caso especificado. 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 |
-Details
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Conformidade & de Segurança
A opção Details especifica se é necessário incluir informações detalhadas nos resultados. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| 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, Conformidade & de Segurança
Este parâmetro só é funcional 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 |
-Export
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Conformidade & de Segurança
Nota: depois de 26 de maio de 2025, este parâmetro já não está funcional. Para obter mais informações, veja Alterações futuras ao Descoberta Eletrônica do Microsoft Purview.
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.
Não pode utilizar este comutador com os parâmetros Identidade, Pré-visualização ou Remoção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Export
| 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 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 utiliza a sintaxe
"Compliance Search Name_Action". Por exemplo,"Case 1234_Preview". - JobRunId (GUID)
Não pode utilizar este parâmetro com os parâmetros Exportar, Pré-visualizar ou Remover.
Quando utiliza o parâmetro Identidade, são devolvidos mais detalhes 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 NumBindings é preenchido. Esta propriedade 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.
- As propriedades de localização afetadas (por exemplo, ExchangeLocation) são preenchidas.
- O valor da propriedade CaseName é preenchido.
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: | ComplianceSearchActionIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-IncludeCredential
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Conformidade & de Segurança
O comutador IncludeCredential especifica se deve incluir a credencial nos resultados. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| 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 |
-Organization
Aplicável: Conformidade do & de Segurança
Esse parâmetro só está disponível no serviço baseado em nuvem.
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | OrganizationIdParameter |
| 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 |
-Preview
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Conformidade & de Segurança
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.
Não pode utilizar este comutador com os parâmetros Exportar, Identidade ou Remoção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Preview
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Purge
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Conformidade & de Segurança
Nota: no PowerShell de Conformidade do & de Segurança, este parâmetro só está disponível na função Procurar e Remover. Por predefinição, esta função é atribuída apenas aos grupos de funções Gestão da Organização e Investigador 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.
Não pode utilizar este comutador com os parâmetros Exportar, Identidade ou Pré-visualização.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Purge
| 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, 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.