New-ComplianceCase
Este cmdlet está disponível apenas no PowerShell de Segurança e Conformidade. Para obter mais informações, consulte PowerShell de Segurança e Conformidade..
Use o cmdlet New-ComplianceCase para criar casos de Descoberta Eletrônica no portal de conformidade do Microsoft Purview. Você usa casos de Descoberta Eletrônica para colocar locais de conteúdo em espera, executar Pesquisas de Conteúdo associadas ao caso e exportar resultados de pesquisa.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Observação
Na nuvem, esse cmdlet tem os seguintes requisitos:
- Versão 3.9.0 ou posterior do módulo do PowerShell do Exchange Online (agosto de 2025).
- Use o parâmetro EnableSearchOnlySession ao executar o comando Connect-IPPSSession para se conectar ao PowerShell de Segurança & Conformidade.
Sintaxe
Default (Default)
New-ComplianceCase
[-Name] <String>
[-CaseType <ComplianceCaseType>]
[-Confirm]
[-Description <String>]
[-DomainController <Fqdn>]
[-ExternalId <String>]
[-SecondaryCaseType <String>]
[-SourceCaseType <String>]
[-WhatIf]
[<CommonParameters>]
Description
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-ComplianceCase -Name "Fabrikam Litigation"
Este exemplo cria um novo caso de Descoberta Eletrônica Standard chamado Fabrikam Litigation.
Exemplo 2
New-ComplianceCase -Name "Coho Case 03082020" -CaseType AdvancedEdiscovery -ExternalId "SaraDavis v. Coho Winery"
Este exemplo cria um novo caso Premium de Descoberta Eletrônica chamado Coho Case 03082020 e especifica um caso opcional Id de "SaraDavis v. Coho Winery".
Parâmetros
-CaseType
Aplicável: Segurança & Conformidade
O parâmetro CaseType especifica o tipo de caso de conformidade que você deseja criar. Os valores válidos são:
- AdvancedEdiscovery: Os casos do eDiscovery Premium são usados para gerenciar investigações legais ou outros tipos de investigações.
- ComplianceClassifier: esse tipo de caso corresponde a um classificador treinável.
- ComplianceWorkspace: esse valor é reservado para uso interno da Microsoft.
- DataInvestigation: Os casos de investigação de dados são usados para investigar incidentes de despejo de dados.
- DSR: Os casos de DSR (Solicitação do Titular dos Dados) são usados para gerenciar investigações de DSR do GDPR (Regulamento Geral sobre a Proteção de Dados).
- Descoberta Eletrônica: Os casos de Descoberta Eletrônica (também chamados de Descoberta Eletrônica Standard) são usados para gerenciar investigações legais ou outros tipos de investigações. Esse valor é o padrão.
- InsiderRisk: os casos de risco interno são usados para gerenciar casos de gerenciamento de risco interno. Normalmente, os casos de gerenciamento de risco interno são criados manualmente no portal de conformidade do Microsoft Purview para investigar ainda mais a atividade com base em um alerta de risco.
- InternalInvestigation: esse valor é reservado para uso interno da Microsoft.
- SupervisionPolicy: esse tipo de caso corresponde à política de conformidade de comunicação.
Propriedades do parâmetro
| Tipo: | ComplianceCaseType |
| 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: Segurança & Conformidade
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer 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 reconhecer 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 |
-Description
Aplicável: Segurança & Conformidade
O parâmetro Description especifica uma descrição para o caso de conformidade. O comprimento máximo é de 256 caracteres. 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 |
-DomainController
Aplicável: Segurança & Conformidade
Esse parâmetro está reservado para uso interno da Microsoft.
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 |
-ExternalId
Aplicável: Segurança & Conformidade
O parâmetro ExternalId especifica uma ID opcional ou número de caso externo que você pode associar ao novo caso 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 |
-Name
Aplicável: Segurança & Conformidade
O parâmetro Name especifica o nome exclusivo do caso de conformidade. O tamanho máximo é de 64 caracteres. 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: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SecondaryCaseType
Aplicável: Segurança & Conformidade
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 |
-SourceCaseType
Aplicável: Segurança & Conformidade
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: Segurança & Conformidade
A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.
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 dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.