Set-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 Set-ComplianceSearch para modificar las búsquedas de cumplimiento que no se ejecutan en Exchange Server 2016 o posterior y en el portal de cumplimiento Microsoft Purview.
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
Set-ComplianceSearch
[-Identity] <ComplianceSearchIdParameter>
[-AddExchangeLocation <String[]>]
[-AddExchangeLocationExclusion <String[]>]
[-AddSharePointLocation <String[]>]
[-AddSharePointLocationExclusion <String[]>]
[-AllowNotFoundExchangeLocationsEnabled <Boolean>]
[-Confirm]
[-ContentMatchQuery <String>]
[-Description <String>]
[-ExchangeLocation <String[]>]
[-ExchangeLocationExclusion <String[]>]
[-Force]
[-HoldNames <String[]>]
[-IncludeOrgContent <Boolean>]
[-IncludeUserAppContent <Boolean>]
[-Language <CultureInfo>]
[-Name <String>]
[-PublicFolderLocation <String[]>]
[-RefinerNames <String[]>]
[-RemoveExchangeLocation <String[]>]
[-RemoveExchangeLocationExclusion <String[]>]
[-RemovePublicFolderLocation <String[]>]
[-RemoveSharePointLocation <String[]>]
[-RemoveSharePointLocationExclusion <String[]>]
[-SharePointLocation <String[]>]
[-SharePointLocationExclusion <String[]>]
[-WhatIf]
[<CommonParameters>] Description
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
Set-ComplianceSearch -Identity "Project X" -ExchangeLocation AllEn este ejemplo se cambia la búsqueda de cumplimiento existente denominada Project X. El ámbito de la búsqueda de Exchange se cambia a todos los buzones.
Ejemplo 2
Set-ComplianceSearch -Identity "Contoso Case Search 1" -HoldNames All -ExchangeLocation $null -SharePointLocation $nullEn este ejemplo se cambia una búsqueda de cumplimiento existente asociada a un caso de exhibición de documentos electrónicos en el portal de cumplimiento Microsoft Purview. El ámbito de la búsqueda se cambia de buscar en buzones seleccionados y sitios de SharePoint a buscar en todas las ubicaciones de contenido que se han colocado en espera en el caso de eDiscovery.
Ejemplo 3
Set-ComplianceSearch -Identity "China Subsidiary Search" -Language zh-CNEn este ejemplo se cambia la configuración de idioma de una búsqueda de cumplimiento existente a chino.
Es posible que tenga que cambiar la configuración de idioma si usa palabras clave que no son en inglés en la consulta de búsqueda (que se especifica en el parámetro ContentMatchQuery).
Parámetros
-AddExchangeLocation
El parámetro AddExchangeLocation especifica los buzones que se van a agregar a la lista de buzones incluidos cuando no se usa el valor All para el parámetro ExchangeLocation. 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
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 |
-AddExchangeLocationExclusion
Este parámetro solo funciona en Exchange local.
Este parámetro especifica los buzones que se van a agregar a la lista de buzones excluidos cuando se usa el valor All para el parámetro ExchangeLocation. 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
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 |
-AddSharePointLocation
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro AddSharePointLocation especifica los sitios de SharePoint Online que se van a agregar a la lista de sitios incluidos cuando no se usa el valor All para el parámetro SharePointLocation. Identifique el sitio por su valor de dirección URL.
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 |
-AddSharePointLocationExclusion
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 |
-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
- 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 |
-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 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.
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: | 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:
- 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
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 espera en el caso de exhibición de documentos electrónicos. Usa el valor All para este parámetro. Puede usar este parámetro solo para las búsquedas de cumplimiento que están asociadas con un caso de eDiscovery.
Si las ubicaciones de contenido de la búsqueda de cumplimiento incluyen buzones, también debe usar el parámetro ExchangeLocation con el valor $null. De forma similar, si la búsqueda de cumplimiento incluye sitios de SharePoint, también debe usar el parámetro SharePointLocation con el valor $null.
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 reinicie 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 |
-Identity
El parámetro Identity especifica la búsqueda de cumplimiento que desea modificar.
Cuando se usa este parámetro, el parámetro Identity es obligatorio, pero se omite el valor. Por ejemplo, utilice el valor 000 para el parámetro Identity.
- Nombre
- JobRunId (GUID)
JobRunId (GUID)
| Type: | ComplianceSearchIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, 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 cualquiera de los parámetros de ubicación de Exchange 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 |
-Name
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, 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 |
-RemoveExchangeLocation
El parámetro RemoveExchangeLocation especifica los buzones que se van a quitar de la lista de buzones incluidos cuando no se usa el valor All para el parámetro ExchangeLocation. Los valores admitidos son:
- Este parámetro especifica los buzones de correo que se eliminarán de la lista de buzones excluidos al usar el valor All para el parámetro ExchangeLocation. 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 |
-RemoveExchangeLocationExclusion
Este parámetro solo funciona en Exchange local.
Este parámetro especifica los buzones que se van a quitar de la lista de buzones excluidos cuando se usa el valor All para el parámetro ExchangeLocation. Los valores admitidos son:
- Este parámetro especifica los buzones de correo que se eliminarán de la lista de buzones excluidos al usar el valor All para el parámetro ExchangeLocation. 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 |
-RemovePublicFolderLocation
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 |
-RemoveSharePointLocation
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro RemoveSharePointLocation especifica los sitios de SharePoint Online que se van a quitar de la lista de sitios incluidos cuando no se usa el valor All para el parámetro SharePointLocation. Identifique el sitio por su valor de dirección URL.
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 |
-RemoveSharePointLocationExclusion
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 |
-WhatIf
El modificador WhatIf no funciona en PowerShell de cumplimiento de seguridad & .
El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.
| 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 |