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.