New-ComplianceSearch
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 New-ComplianceSearch para criar pesquisas de conformidade no Exchange Server 2016 ou posterior e no portal de conformidade do Microsoft Purview. Você pode usar esse cmdlet para definir os critérios de pesquisa.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Padrão)
New-ComplianceSearch
[-Name] <String>
[-AllowNotFoundExchangeLocationsEnabled <Boolean>]
[-Case <String>]
[-Confirm]
[-ContentMatchQuery <String>]
[-Description <String>]
[-ExchangeLocation <String[]>]
[-ExchangeLocationExclusion <String[]>]
[-Force]
[-HoldNames <String[]>]
[-IncludeOrgContent <Boolean>]
[-IncludeUserAppContent <Boolean>]
[-Language <CultureInfo>]
[-LogLevel <ComplianceJobLogLevel>]
[-PublicFolderLocation <String[]>]
[-RefinerNames <String[]>]
[-SharePointLocation <String[]>]
[-SharePointLocationExclusion <String[]>]
[-StatusMailRecipients <String[]>]
[-WhatIf]
[<CommonParameters>]
Description
Uma pesquisa de conformidade exige pelo menos um local. Por exemplo, caixas de correio com o parâmetro ExchangeLocation ou sites do SharePoint com o parâmetro SharePointLocation.
Depois de criar uma pesquisa de conformidade usando o cmdlet New-ComplianceSearch, execute a pesquisa usando o cmdlet Start-ComplianceSearch.
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
New-ComplianceSearch -Name "Hold Project X" -ExchangeLocation "Finance Department"
Este exemplo cria uma nova pesquisa de conformidade chamada Hold-Project X que pesquisa todos os membros do grupo de distribuição chamado Departamento Financeiro. Como a pesquisa não usa o parâmetro ContentMatchQuery, a pesquisa é realizada em todos os itens das caixas de correio.
Exemplo 2
New-ComplianceSearch -Name "Hold-Tailspin Toys" -ExchangeLocation "Research Department" -ContentMatchQuery "'Patent' AND 'Project Tailspin Toys'"
Este exemplo cria uma nova pesquisa de conformidade chamada Hold-Tailspin Toys que pesquisa todos os membros do grupo de distribuição chamado Departamento de Pesquisa. Como a pesquisa usa o parâmetro ContentMatchQuery, a pesquisa é realizada apenas nas mensagens que correspondam à consulta.
Exemplo 3
New-ComplianceSearch -Name "AnnBeebe-InactiveMailbox" -ExchangeLocation .annb@contoso.onmicrosoft.com -AllowNotFoundExchangeLocationsEnabled $true
Este exemplo cria uma nova pesquisa de conformidade chamada AnnBeebe-InactiveMailbox, que procura uma caixa de correio inativa e retorna todos os itens na caixa de correio. Para procurar por caixas de correio inativas, você precisa usar o endereço SMTP principal da caixa de correio inativa, precedido por um ponto (".") Também tem de incluir o parâmetro AllowNotFoundExchangeLocationsEnabled para que a pesquisa não tente validar a existência da caixa de correio inativa.
Parâmetros
-AllowNotFoundExchangeLocationsEnabled
Aplicável: Exchange Server 2016, Exchange Server 2019, Conformidade & de Segurança
O parâmetro AllowNotFoundExchangeLocationsEnabled especifica se deve incluir caixas de correio que não sejam caixas de correio de utilizador normais na pesquisa de compatibilidade. Os valores válidos são:
- $true: a pesquisa não tenta validar a existência da caixa de correio antes de continuar. Este valor é necessário se quiser procurar caixas de correio que não resolve como caixas de correio normais.
- $false: a pesquisa tenta validar a existência da caixa de correio antes de continuar. Se especificar uma caixa de correio que não seja uma caixa de correio de utilizador normal, a pesquisa falhará. Este valor é a predefinição.
Os tipos de caixa de correio que são afetados pelo valor deste parâmetro incluem:
- Caixas de correio inativas
- Utilizadores sem uma licença de Exchange Online que utilizam aplicações do Office
- Utilizadores convidados do Microsoft 365
- Utilizadores no local cuja identidade é sincronizada com a sua organização do Microsoft 365
Propriedades do parâmetro
| Tipo: | Boolean |
| 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 |
-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 especifica o nome de um caso de Standard de Deteção de Dados Eletrónicos para associar a nova pesquisa de compatibilidade. Se o valor contiver espaços, coloque-o entre aspas.
Não pode utilizar este parâmetro para criar pesquisas de conformidade associadas a casos de Deteção de Dados Eletrónicos Premium.
Se o parâmetro Nome contiver espaços, o valor do parâmetro ExchangeLocation é limpo quando utiliza o parâmetro Case.
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 |
-Confirm
Aplicável: Exchange Server 2016, Exchange Server 2019, Conformidade & de Segurança
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
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 |
-ContentMatchQuery
Aplicável: Exchange Server 2016, Exchange Server 2019, Conformidade & de Segurança
O parâmetro ContentMatchQuery especifica um filtro de pesquisa de conteúdo.
Este parâmetro usa a cadeia de caracteres de pesquisa de texto ou uma consulta formatada através do uso da linguagem de consulta de palavra-chave (KQL). Para obter mais informações, veja Referência da sintaxe da Linguagem de Consulta de Palavras-chave (KQL) e Consultas de palavras-chave e condições de pesquisa para Deteção de Dados Eletrónicos.
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 |
-Description
Aplicável: Exchange Server 2016, Exchange Server 2019, Conformidade & de Segurança
O parâmetro Description especifica uma descrição opcional para a pesquisa de conformidade. 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 |
-ExchangeLocation
Aplicável: Exchange Server 2016, Exchange Server 2019, Conformidade & de Segurança
O parâmetro ExchangeLocation especifica as caixas de correio a incluir. Os valores válidos são:
- Uma caixa de correio de utilizador normal. A inclusão de outros tipos de caixas de correio (por exemplo, caixas de correio inativas ou utilizadores convidados do Microsoft 365) é controlada pelo parâmetro AllowNotFoundExchangeLocationsEnabled.
- Uma caixa de correio
- O valor Tudo para todas as caixas de correio. Você só pode usar esse valor sozinho.
Para especificar uma caixa de correio ou um grupo de distribuição, utilize o endereço de e-mail. Vários valores, separados por vírgulas, podem ser especificados.
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: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-ExchangeLocationExclusion
Aplicável: Exchange Server 2016, Exchange Server 2019, Conformidade & de Segurança
Este parâmetro só é funcional no Exchange local.
Este parâmetro especifica as caixas de correio a excluir quando utiliza o valor Tudo para o parâmetro ExchangeLocation. Os valores válidos são:
- O parâmetro ExchangeLocation especifica as caixas de correio que devem ser incluídas na política. Os valores válidos são:
- Uma caixa de correio
Para especificar uma caixa de correio ou um grupo de distribuição, utilize o endereço de e-mail. Vários valores, separados por vírgulas, podem ser especificados.
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 |
-Force
Aplicável: Exchange Server 2016, Exchange Server 2019, Conformidade & de Segurança
O comutador Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.
Você pode usar essa opção para executar tarefas de modo programático onde a solicitação por entrada administrativa é inadequada.
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 |
-HoldNames
Aplicável: Conformidade do & de Segurança
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro HoldNames especifica as localizações de conteúdo colocadas em suspensão no caso de Deteção de Dados Eletrónicos especificado. Use o valor All para esse parâmetro. Você também precisa especificar o nome de um caso de Descoberta Eletrônica usando o parâmetro Case.
Além disso, se uma localização de conteúdo tiver sido colocada numa suspensão de casos baseada em consulta, apenas os itens que estão em suspensão são procurados quando executar esta pesquisa de conformidade. Por exemplo, se um usuário foi colocado em um caso de retenção baseado em consulta que preserva os itens que foram enviados ou criados antes de uma data específica, somente esses itens serão pesquisados usando os critérios de pesquisa especificados por essa pesquisa de conformidade.
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 |
-IncludeOrgContent
Aplicável: Conformidade do & de Segurança
{{ Fill IncludeOrgContent Description }}
Propriedades do parâmetro
| Tipo: | Boolean |
| 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 |
-IncludeUserAppContent
Aplicável: Conformidade do & de Segurança
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro IncludeUserAppContent especifica que pretende procurar utilizadores que não tenham uma conta de utilizador normal do Microsoft 365 na sua organização. Estes tipos de utilizadores incluem utilizadores sem uma licença de Exchange Online que utilizam aplicações do Office, utilizadores convidados do Microsoft 365 e utilizadores no local cuja identidade é sincronizada com a sua organização do Microsoft 365. Os valores válidos são:
- $true: a localização de armazenamento baseada na nuvem para os utilizadores especificados no parâmetro ExchangeLocation está incluída na pesquisa. Se utilizar o valor Tudo para o parâmetro ExchangeLocation, a localização de armazenamento baseada na cloud para qualquer utilizador convidado ou no local será incluída na pesquisa.
- $false: a localização de armazenamento baseada na cloud para os utilizadores especificados no parâmetro ExchangeLocation não está incluída na pesquisa. Este valor é a predefinição.
Propriedades do parâmetro
| Tipo: | Boolean |
| 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 |
-Language
Aplicável: Exchange Server 2016, Exchange Server 2019, Conformidade & de Segurança
O parâmetro Language especifica o idioma da pesquisa de conformidade.
A entrada válida para este parâmetro é um valor de código de cultura suportado da classe CultureInfo do Microsoft .NET Framework. Por exemplo, da-DK para dinamarquês ou ja-JP para japonês. Para obter mais informações, consulte Classe CultureInfo.
Propriedades do parâmetro
| Tipo: | CultureInfo |
| 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 |
-LogLevel
Aplicável: Exchange Server 2016, Exchange Server 2019
Este parâmetro está disponível somente no Exchange local.
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | ComplianceJobLogLevel |
| 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 |
-Name
Aplicável: Exchange Server 2016, Exchange Server 2019, Conformidade & de Segurança
O parâmetro Nome especifica o nome da pesquisa de compatibilidade. Se o valor contiver espaços, coloque-o entre aspas.
Não utilize espaços no valor deste parâmetro se planear utilizar o parâmetro Case. Se o parâmetro Nome contiver espaços, o valor do parâmetro ExchangeLocation é limpo quando utiliza o parâmetro Case.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PublicFolderLocation
Aplicável: Conformidade do & de Segurança
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro PublicFolderLocation especifica que você deseja incluir todas as pastas públicas na pesquisa. Use o valor All para esse parâmetro.
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 |
-RefinerNames
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: | 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 |
-SharePointLocation
Aplicável: Conformidade do & de Segurança
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro SharePointLocation especifica os sites do SharePoint a incluir. Identifique o site pelo respectivo valor de URL ou use o valor All para incluir todos os sites.
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
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 |
-SharePointLocationExclusion
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: | 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 |
-StatusMailRecipients
Aplicável: Exchange Server 2016, Exchange Server 2019
Este parâmetro está disponível somente no Exchange local.
Esse parâmetro está reservado para uso interno da Microsoft.
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 |
-WhatIf
Aplicável: Exchange Server 2016, Exchange Server 2019, Conformidade & de Segurança
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
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.