New-ComplianceCase
Este cmdlet está disponible solo en Security & Compliance PowerShell. Para obtener más información, consulte Security & Compliance PowerShell.
Use el cmdlet New-ComplianceCase para crear casos de eDiscovery en el portal de cumplimiento Microsoft Purview. Los casos de eDiscovery se usan para poner ubicaciones de contenido en espera, realizar búsquedas de contenido asociadas con el caso y exportar resultados de búsqueda.
Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.
Nota:
En la nube, este cmdlet tiene los siguientes requisitos:
- Versión 3.9.0 o posterior del módulo de PowerShell de Exchange Online (agosto de 2025).
- Use el parámetro EnableSearchOnlySession cuando ejecute el comando Connect-IPPSSession para conectarse a Security & Compliance PowerShell.
Sintaxis
Default (valor predeterminado)
New-ComplianceCase
[-Name] <String>
[-CaseType <ComplianceCaseType>]
[-Confirm]
[-Description <String>]
[-DomainController <Fqdn>]
[-ExternalId <String>]
[-SecondaryCaseType <String>]
[-SourceCaseType <String>]
[-WhatIf]
[<CommonParameters>]
Description
Para usar este cmdlet en Security & Compliance PowerShell, debe tener asignados permisos. Para obtener más información vea Permisos en el portal de cumplimiento de Microsoft Purview.
Ejemplos
Ejemplo 1
New-ComplianceCase -Name "Fabrikam Litigation"
En este ejemplo se crea un nuevo caso de eDiscovery Standard denominado Fabrikam Litigation.
Ejemplo 2
New-ComplianceCase -Name "Coho Case 03082020" -CaseType AdvancedEdiscovery -ExternalId "SaraDavis v. Coho Winery"
En este ejemplo se crea un nuevo caso de eDiscovery Premium denominado Coho Case 03082020 y se especifica un identificador de caso opcional de "SaraDavis v. Bodega Coho".
Parámetros
-CaseType
Aplicable: Seguridad & cumplimiento
El parámetro CaseType especifica el tipo de caso de cumplimiento que desea crear. Los valores admitidos son:
- AdvancedEdiscovery: los casos de eDiscovery Premium se usan para administrar investigaciones legales o de otro tipo.
- ComplianceClassifier: Este tipo de caso corresponde a un clasificador entrenable.
- ComplianceWorkspace: este valor está reservado para uso interno de Microsoft.
- DataInvestigation: los casos de investigación de datos se usan para investigar incidentes de derrame de datos.
- DSR: los casos de solicitud del interesado (DSR) se usan para administrar las investigaciones de DSR del Reglamento general de protección de datos (RGPD).
- eDiscovery: los casos de eDiscovery (también denominados eDiscovery Standard) se usan para administrar investigaciones legales o de otro tipo. Este valor es el predeterminado.
- InsiderRisk: Los casos de riesgo interno se usan para administrar casos de administración de riesgo interno. Normalmente, los casos de administración de riesgos internos se crean manualmente en el portal de cumplimiento de Microsoft Purview para investigar más a fondo la actividad basada en una alerta de riesgo.
- InternalInvestigation: este valor está reservado para uso interno de Microsoft.
- Política de supervisión: Este tipo de caso corresponde a la política de cumplimiento de la comunicación.
Propiedades de parámetro
| Tipo: | ComplianceCaseType |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Aplicable: Seguridad & cumplimiento
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador al cmdlet depende de si el cmdlet requiere confirmación antes de continuar.
- Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta:
-Confirm:$false. - La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. Para estos cmdlets, especificar el modificador Confirm sin un valor introduce una pausa que le obliga a reconocer el comando antes de continuar.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Description
Aplicable: Seguridad & cumplimiento
El parámetro Description especifica una descripción para el caso de cumplimiento. La longitud máxima es de 256 caracteres. Si el valor contiene espacios, escriba el valor entre comillas (").
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-DomainController
Aplicable: Seguridad & cumplimiento
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | Fqdn |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExternalId
Aplicable: Seguridad & cumplimiento
El parámetro ExternalId especifica un identificador opcional o un número de caso externo que puede asociar al nuevo caso de cumplimiento.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Name
Aplicable: Seguridad & cumplimiento
El parámetro Name especifica el nombre único del caso de cumplimiento. La longitud máxima es de 64 caracteres. Si el valor contiene espacios, escríbalo entre comillas (").
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SecondaryCaseType
Aplicable: Seguridad & cumplimiento
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SourceCaseType
Aplicable: Seguridad & cumplimiento
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Aplicable: Seguridad & cumplimiento
El modificador WhatIf no funciona en Security & Compliance PowerShell.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.