Check-PurviewConfig

Módulo:
Exchange PowerShell

Este cmdlet está disponible solo en Security & Compliance PowerShell. Para obtener más información, consulte Security & Compliance PowerShell.

Use el cmdlet de Check-PurviewConfig para validar y revisar las opciones de configuración de su organización en 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.

Sintaxis

Default (valor predeterminado) 

Check-PurviewConfig

    [[-CaseHoldPolicyNameOrId] <String>]
    [[-CaseId] <String>]
    [[-Component] <PurviewConfigComponent>]
    [-Confirm]
    [[-DateTimeUTC] <String>]
    [[-DeviceName] <String>]
    [[-File] <String>]
    [[-FileAsBytes] <Byte[]>]
    [[-IncidentId] <String>]
    [[-ItemId] <String>]
    [[-MessageId] <String>]
    [[-Organization] <OrganizationIdParameter>]
    [[-PolicyName] <String>]
    [-RecipientAddress]
    [[-RecordId] <String>]
    [[-RuleName] <String>]
    [[-SenderAddress] <SmtpAddress>]
    [[-SharepointItemUniqueId] <String>]
    [[-SharepointSiteId] <String>]
    [[-SiteUrl] <String>]
    [[-SitIdentity] <String>]
    [[-TestCases] <String[]>]
    [[-Theme] <PurviewConfigTheme>]
    [[-UserPrincipalName] <SmtpAddress>]
    [-WhatIf]
    [[-Workload] <String>]
    [<CommonParameters>]

Description

Use el cmdlet Check-PurviewConfig para ejecutar casos de prueba de diagnóstico de Microsoft Information Protection para su organización y comprobar los resultados.

Los administradores con el rol de configuración de la organización asignado tienen los permisos necesarios para ejecutar este cmdlet.

Para obtener más información sobre los permisos de rol de administrador en Microsoft Entra ID, consulte ID de plantilla de rol.

Importante

Microsoft promueve encarecidamente el principio de privilegios mínimos. Asignar a las cuentas solo los permisos mínimos necesarios para realizar sus tareas ayuda a reducir los riesgos de seguridad y refuerza la protección general de la organización. El administrador global es un rol con privilegios elevados que normalmente se limita a escenarios de emergencia o cuando no se puede usar otro rol.

Ejemplos

Ejemplo 1

Check-PurviewConfig

En este ejemplo se ejecutan todos los casos de prueba de Microsoft Information Protection que no requieren parámetros adicionales.

Ejemplo 2

Check-PurviewConfig -Component Encryption

En este ejemplo se ejecutan todos los casos de prueba para el componente de cifrado.

Ejemplo 3

Check-PurviewConfig -Component Encryption -Theme LicenseAvailability

En este ejemplo se ejecutan todos los casos para el tema LicenseAvailability en el componente Cifrado.

Ejemplo 4

Check-PurviewConfig -TestCases "MipLabels_EnabledEntities_ScopedLabels" -UserPrincipalName sathya@contoso.onmicrosoft.com

En este ejemplo se ejecuta el caso de prueba denominado MipLabels_EnabledEntities_ScopedLabels, que requiere un valor UserPrincipalName.

Ejemplo 5

Check-PurviewConfig -TestCases "MipLabels_EnabledEntities_ScopedLabels","MipLabels_EnabledEntities_CompareSyncStatus" -UserPrincipalName sathya@contoso.onmicrosoft.com

En este ejemplo se ejecutan los casos de prueba especificados. Se requiere un valor UserPrincipalName para el MipLabels_EnabledEntities_ScopedLabels caso de prueba.

Parámetros

-CaseHoldPolicyNameOrId

Aplicable: Seguridad & cumplimiento

{{ Fill CaseHoldPolicyNameOrId Description }}

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CaseId

Aplicable: Seguridad & cumplimiento

{{ Fill CaseId Description }}

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Component

Aplicable: Seguridad & cumplimiento

El parámetro Component especifica el componente que se analizará en el caso de prueba. Los valores admitidos son:

  • DLP
  • DLPAlerts
  • Cifrado
  • MIPLabels

Propiedades de parámetro

Tipo:PurviewConfigComponent
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Obligatorio: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
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DateTimeUTC

Aplicable: Seguridad & cumplimiento

DateTimeUTC especifica la fecha y hora del caso de prueba en hora universal coordinada (UTC). Por ejemplo, "2025-06-05 14:30:00".

Este parámetro es necesario para los siguientes valores de TestCases:

  • DlpAlerts_CheckAlertsCreated
  • DlpAlerts_FindAlertForActivity

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DeviceName

Aplicable: Seguridad & cumplimiento

{{ Fill DeviceName Description }}

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:2
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-File

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:2
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-FileAsBytes

Aplicable: Seguridad & cumplimiento

{{ Fill FileAsBytes Description }}

Propiedades de parámetro

Tipo:

Byte[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:4
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IncidentId

Aplicable: Seguridad & cumplimiento

El parámetro IncidentId especifica el incidente que se analizará en el caso de prueba.

Puedes encontrar un valor para este parámetro en las búsquedas de registros de auditoría filtradas por la operación DLPRuleMatch en la propiedad IncidentId.

Este parámetro es necesario para el valor TestCases DlpAlerts_FindAlertForActivity.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:3
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ItemId

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:4
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MessageId

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:5
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Organization

Aplicable: Seguridad & cumplimiento

{{ Rellenar descripción de la organización }}

Propiedades de parámetro

Tipo:OrganizationIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:10
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PolicyName

Aplicable: Seguridad & cumplimiento

{{ Fill PolicyName Description }}

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:8
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RecipientAddress

Aplicable: Seguridad & cumplimiento

{{ Fill RecipientAddress Description }}

Propiedades de parámetro

Tipo:SmtpAddress
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:9
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RecordId

Aplicable: Seguridad & cumplimiento

El parámetro RuleName especifica el registro que se analizará en el caso de prueba.

Puede encontrar un valor para este parámetro en el Explorador de actividades filtrado por el tipo de actividad DLPRuleMatch en la propiedad RecordId.

Este parámetro es opcional con el valor TestCases DlpAlerts_FindAlertForActivity.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:6
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RuleName

Aplicable: Seguridad & cumplimiento

El parámetro RuleName especifica la regla DLP que se analizará en el caso de prueba.

Este parámetro es opcional con el valor TestCases DlpAlerts_CheckAlertsCreated.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:7
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SenderAddress

Aplicable: Seguridad & cumplimiento

{{ Fill SenderAddress Description }}

Propiedades de parámetro

Tipo:SmtpAddress
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:12
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SharepointItemUniqueId

Aplicable: Seguridad & cumplimiento

{{ Fill SharepointItemUniqueId Description }}

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:13
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SharepointSiteId

Aplicable: Seguridad & cumplimiento

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:14
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SiteUrl

Aplicable: Seguridad & cumplimiento

{{ Rellenar descripción de SiteUrl }}

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:15
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SitIdentity

Aplicable: Seguridad & cumplimiento

{{ Rellenar descripción de SitIdentity }}

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:16
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-TestCases

Aplicable: Seguridad & cumplimiento

El parámetro TestCases especifica el nombre del caso de prueba que se analizará. Los casos de prueba disponibles y sus parámetros requeridos se describen en la siguiente lista:

  • Encryption_EvaluationDetails: valida los detalles de evaluación del cifrado de correo electrónico. No se requieren otros parámetros. Ejecuta Test-IRMConfiguration cmdlet como parte de sus comprobaciones.
  • Encryption_LicenseAvailability: Comprueba las configuraciones de cifrado del correo electrónico. No se requieren otros parámetros. Ejecuta Get-IRMConfiguration, Get-RMSTemplate, Get-TransportRule y Get-JournalRule cmdlets como parte de sus comprobaciones.
  • MipLabels_EnabledEntities_ScopedLabels: Muestra las etiquetas y la configuración de etiquetas que se aplican a un usuario. Requiere el parámetro UserPrincipalName. Ejecuta Get-Label y Get-LabelPolicy cmdlets como parte de sus comprobaciones.
  • MipLabels_LicenseAvailability: comprueba si la característica de etiqueta MIP está habilitada. No se requieren otros parámetros.
  • DlpAlerts_CheckAlertsCreated: valida la configuración de la regla DLP para las alertas creadas en los últimos 5 días. Requiere el parámetro DateTimeUTC. El parámetro RuleName es opcional.
  • DlpAlerts_FindAlertForActivity: identifica las alertas que faltan para una actividad. Requiere el parámetro DateTimeUTC. Los parámetros IncidentId y RecordId son opcionales.
  • DLP_ScopedEntities: devuelve todas las directivas y reglas de DLP que se aplican a un usuario o un sitio. Requiere el parámetro Workload. Los parámetros SiteUrl y UserPrincipalName son opcionales.

Puede especificar distintos valores separados por comas.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:8
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Theme

Aplicable: Seguridad & cumplimiento

Los filtros del parámetro Tema especifican los que se analizarán en el caso de prueba. Los valores admitidos son:

  • Entidades habilitadas
  • Detalles de evaluación
  • LicenseAvailability

Propiedades de parámetro

Tipo:PurviewConfigTheme
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:9
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-UserPrincipalName

Aplicable: Seguridad & cumplimiento

El parámetro UserPrincipalName especifica la cuenta de usuario que se va a analizar en el caso de prueba (por ejemplo, sathya@contoso.onmicrosoft.com).

  • Necesario para el valor TestCases MipLabels_EnabledEntities_ScopedLabels.
  • Opcional para el valor TestCases DLP_ScopedEntities.

Propiedades de parámetro

Tipo:SmtpAddress
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:10
Obligatorio: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
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Workload

Aplicable: Seguridad & cumplimiento

El parámetro Workload especifica la carga de trabajo del servicio. Los valores de los valores son:

  • Dispositivos de punto de conexión
  • Exchange
  • OneDriveForBusiness
  • SharePoint
  • Teams

Este parámetro es necesario para el valor TestCases DLP_ScopedEntities.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:11
Obligatorio: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.