New-ComplianceSearch
Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.
Use el cmdlet New-ComplianceSearch para crear búsquedas de cumplimiento en Exchange Server 2016 o posterior y en el portal de cumplimiento Microsoft Purview. Este cmdlet se usa para definir los criterios 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.
Syntax
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
Una búsqueda de cumplimiento exige al menos una ubicación. Por ejemplo, buzones que usan el parámetro ExchangeLocation o sitios de SharePoint con el parámetro SharePointLocation.
Después de crear una búsqueda de cumplimiento con el cmdlet New-ComplianceSearch, se ejecuta la búsqueda con el cmdlet Start-ComplianceSearch.
Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.
En Exchange local, este cmdlet está disponible en el rol De búsqueda de buzones. De forma predeterminada, este rol solo se asigna al grupo de roles Administración de detección.
Para usar este cmdlet en PowerShell de cumplimiento de seguridad & , debe tener asignados permisos. Para obtener más información vea Permisos en el portal de cumplimiento de Microsoft Purview.
Ejemplos
Ejemplo 1
New-ComplianceSearch -Name "Hold Project X" -ExchangeLocation "Finance Department"En este ejemplo se crea una nueva búsqueda de cumplimiento denominada Hold-Project X que busca en todos los miembros del grupo de distribución denominado Finance Department. Como la búsqueda no usa el parámetro ContentMatchQuery, se busca en todos los elementos de los buzones.
Ejemplo 2
New-ComplianceSearch -Name "Hold-Tailspin Toys" -ExchangeLocation "Research Department" -ContentMatchQuery "'Patent' AND 'Project Tailspin Toys'"En este ejemplo se crea una nueva búsqueda de cumplimiento denominada Hold-Tailspin Toys que busca en todos los miembros del grupo de distribución denominado Research Department. Como la búsqueda usa el parámetro ContentMatchQuery, solo se busca en los mensajes que coinciden con la consulta.
Ejemplo 3
New-ComplianceSearch -Name "AnnBeebe-InactiveMailbox" -ExchangeLocation .annb@contoso.onmicrosoft.com -AllowNotFoundExchangeLocationsEnabled $trueEn este ejemplo se crea una nueva búsqueda de cumplimiento denominada InactiveMailbox Anadíaz que busca en un buzón inactivo y devuelve todos los elementos en el buzón. Para buscar buzones inactivos, deberá usar la dirección SMTP principal del buzón inactivo, precedido por un punto ("."). También debe incluir el parámetro AllowNotFoundExchangeLocationsEnabled para que la búsqueda no intente validar la existencia del buzón inactivo.
Parámetros
-AllowNotFoundExchangeLocationsEnabled
El parámetro AllowNotFoundExchangeLocationsEnabled especifica si se deben incluir buzones que no sean buzones de usuario normales en la búsqueda de cumplimiento. Los valores admitidos son:
- $true: la búsqueda no intenta validar la existencia del buzón antes de continuar. Este valor es necesario si desea buscar buzones que no se resuelven como buzones normales.
- $false: la búsqueda intenta validar la existencia del buzón antes de continuar. Si especifica un buzón que no es un buzón de usuario normal, se producirá un error en la búsqueda. Este es el valor predeterminado.
Los tipos de buzón que se ven afectados por el valor de este parámetro incluyen:
- Buzones de correo inactivos
- Usuarios sin una licencia de Exchange Online que usan aplicaciones de Office
- Microsoft 365 usuarios invitados
- Usuarios locales cuya identidad se sincroniza con la organización de Microsoft 365
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-Case
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro Case especifica el nombre de un caso estándar de eDiscovery con el que asociar la nueva búsqueda de cumplimiento. Si el valor contiene espacios, escríbalo entre comillas.
No puede usar este parámetro para crear búsquedas de cumplimiento asociadas a casos de eDiscovery Premium.
Si el parámetro Name contiene espacios, el valor del parámetro ExchangeLocation se borra cuando se usa el parámetro Case.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Confirm
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.
- Los cmdlets destructivos (por ejemplo, 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 demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-ContentMatchQuery
El parámetro ContentMatchQuery especifica un filtro de búsqueda de contenido.
Este parámetro usa una cadena de búsqueda de texto o una consulta con formato mediante el idioma de consulta de palabra clave (KQL). Para obtener más información, vea Referencia de sintaxis del Lenguaje de consulta de palabras clave (KQL) y Consultas de palabras clave y condiciones de búsqueda para eDiscovery.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-Description
El parámetro Description especifica una descripción opcional para la búsqueda de cumplimiento. Si el valor contiene espacios, escríbalo entre comillas.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-ExchangeLocation
El parámetro ExchangeLocation especifica los buzones que se van a incluir. Los valores admitidos son:
- Un buzón de usuario normal. El parámetro AllowNotFoundExchangeLocationsEnabled controla la inclusión de otros tipos de buzones (por ejemplo, buzones inactivos o Microsoft 365 usuarios invitados).
- Un buzón de correo
- Valor All para todos los buzones. Este valor únicamente se puede usar solo.
Para especificar un buzón de correo o un grupo de distribución, use la dirección de correo electrónico. Puede especificar distintos valores separados por comas.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-ExchangeLocationExclusion
Este parámetro solo funciona en Exchange local.
Este parámetro especifica los buzones que se van a excluir cuando se usa el valor All para el parámetro ExchangeLocation. Los valores admitidos son:
- El parámetro ExchangeLocation especifica los buzones de correo que se incluirán en la directiva. Los valores válidos son:
- Un buzón de correo
Para especificar un buzón de correo o un grupo de distribución, use la dirección de correo electrónico. Puede especificar distintos valores separados por comas.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-Force
El modificador Force oculta los mensajes de advertencia o confirmación. No es necesario especificar un valor con este modificador.
Este modificador se puede usar para ejecutar tareas mediante programación en las que no es apropiado solicitar una entrada administrativa.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-HoldNames
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro HoldNames especifica que se buscarán las ubicaciones de contenido que se han colocado en suspensión en el caso de eDiscovery especificado. Use el valor All para este parámetro. También necesita especificar el nombre de un caso de eDiscovery con el parámetro Case.
Además, si se ha colocado una ubicación de contenido en una suspensión de caso basada en consultas, solo se buscarán los elementos que están en suspensión cuando ejecute esta búsqueda de cumplimiento. Por ejemplo, si se ha colocado un usuario en una suspensión de caso basada en consultas que conserva elementos que se han enviado o creado antes de una fecha especificada, solo se buscarían esos elementos con los criterios de búsqueda especificados mediante esta búsqueda de cumplimiento.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-IncludeOrgContent
{{ Fill IncludeOrgContent Description }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-IncludeUserAppContent
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro IncludeUserAppContent especifica que desea buscar en la ubicación de almacenamiento basada en la nube los usuarios que no tienen una cuenta de usuario de Microsoft 365 normal en su organización. Estos tipos de usuarios incluyen usuarios sin una licencia de Exchange Online que usan aplicaciones de Office, Microsoft 365 usuarios invitados y usuarios locales cuya identidad se sincroniza con la organización de Microsoft 365. Los valores admitidos son:
- $true: la ubicación de almacenamiento basada en la nube para los usuarios especificados en el parámetro ExchangeLocation se incluirá en la búsqueda. Si usa el valor All para el parámetro ExchangeLocation, la ubicación de almacenamiento basada en la nube para cualquier usuario invitado o local se incluirá en la búsqueda.
- $false: la ubicación de almacenamiento basada en la nube para los usuarios especificados en el parámetro ExchangeLocation no se incluirá en la búsqueda. Este es el valor predeterminado.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Language
El parámetro Language especifica el idioma de la búsqueda de cumplimiento.
La entrada válida para este parámetro es un valor de código de referencia cultural admitido de la Microsoft clase CultureInfo de .NET Framework. Por ejemplo, da-DK para danés o ja-JP para japonés. Para obtener más información, vea CultureInfo (clase).
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-LogLevel
Este parámetro solo está disponible en Exchange local.
Este parámetro está reservado para uso interno de Microsoft.
| Type: | ComplianceJobLogLevel |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Name
El parámetro Name especifica el nombre de la búsqueda de cumplimiento. Si el valor contiene espacios, escríbalo entre comillas.
No use espacios en el valor de este parámetro si tiene previsto usar el parámetro Case. Si el parámetro Name contiene espacios, el valor del parámetro ExchangeLocation se borra cuando se usa el parámetro Case.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-PublicFolderLocation
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro PublicFolderLocation especifica que desea incluir todas las carpetas públicas en la búsqueda. Use el valor All para este parámetro.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RefinerNames
Este parámetro solo está disponible en el servicio basado en la nube.
Este parámetro está reservado para uso interno de Microsoft.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SharePointLocation
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro SharePointLocation especifica los sitios de SharePoint Online que se van a incluir. Identifique el sitio por su valor de dirección URL o use el valor All para incluir todos los sitios.
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SharePointLocationExclusion
Este parámetro solo está disponible en el servicio basado en la nube.
Este parámetro está reservado para uso interno de Microsoft.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-StatusMailRecipients
Este parámetro solo está disponible en Exchange local.
Este parámetro está reservado para uso interno de Microsoft.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-WhatIf
Este parámetro está reservado para uso interno de Microsoft.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |