Compartir a través de


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 All

En 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 $null

En 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-CN

En 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