Check-PurviewConfig
Este cmdlet está disponível apenas no PowerShell de Segurança e Conformidade. Para obter mais informações, consulte PowerShell de Segurança e Conformidade..
Use o cmdlet Check-PurviewConfig para validar e examinar as definições de configuração da sua organização no Microsoft Purview.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
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 o cmdlet Check-PurviewConfig para executar casos de teste de diagnóstico do Microsoft Proteção de Informações para sua organização e marcar os resultados.
Os administradores com a função de Configuração da Organização atribuída têm as permissões necessárias para executar esse cmdlet.
Para saber mais sobre as permissões de função de administrador no Microsoft Entra ID, consulte IDs de modelo de função.
Importante
A Microsoft defende fortemente o princípio do privilégio mínimo. Atribuir às contas apenas as permissões mínimas necessárias para realizar suas tarefas ajuda a reduzir os riscos de segurança e fortalece a proteção geral da sua organização. O Administrador Global é uma função altamente privilegiada que normalmente você limita a cenários de emergência ou quando não é possível usar uma função diferente.
Exemplos
Exemplo 1
Check-PurviewConfig
Este exemplo executa todos os casos de teste da Proteção de Informações da Microsoft que não exigem parâmetros adicionais.
Exemplo 2
Check-PurviewConfig -Component Encryption
Este exemplo executa todos os casos de teste para o componente de Criptografia.
Exemplo 3
Check-PurviewConfig -Component Encryption -Theme LicenseAvailability
Este exemplo executa todos os casos para o tema LicenseAvailability no componente de Criptografia.
Exemplo 4
Check-PurviewConfig -TestCases "MipLabels_EnabledEntities_ScopedLabels" -UserPrincipalName sathya@contoso.onmicrosoft.com
Este exemplo executa o caso de teste chamado MipLabels_EnabledEntities_ScopedLabels, que requer um valor UserPrincipalName.
Exemplo 5
Check-PurviewConfig -TestCases "MipLabels_EnabledEntities_ScopedLabels","MipLabels_EnabledEntities_CompareSyncStatus" -UserPrincipalName sathya@contoso.onmicrosoft.com
Este exemplo executa os casos de teste especificados. Um valor UserPrincipalName é necessário para o caso de teste MipLabels_EnabledEntities_ScopedLabels.
Parâmetros
-CaseHoldPolicyNameOrId
Aplicável: Segurança & Conformidade
{{ Preencher CaseHoldPolicyNameOrId Description }}
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-CaseId
Aplicável: Segurança & Conformidade
{{ Preencher CaseId Description }}
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Component
Aplicável: Segurança & Conformidade
O parâmetro Component especifica o componente a ser analisado no caso de teste. Os valores válidos são:
- DLP
- DLPAlerts
- Criptografia
- MIPLabels
Propriedades do parâmetro
| Tipo: | PurviewConfigComponent |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Segurança & Conformidade
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a reconhecer o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DateTimeUTC
Aplicável: Segurança & Conformidade
O DateTimeUTC especifica a data/hora do caso de teste em UTC (Tempo Universal Coordenado). Por exemplo, "2025-06-05 14:30:00".
Esse parâmetro é necessário para os seguintes valores de TestCases:
- DlpAlerts_CheckAlertsCreated
- DlpAlerts_FindAlertForActivity
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DeviceName
Aplicável: Segurança & Conformidade
{{ Preencher DeviceName Description }}
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 2 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-File
Aplicável: Segurança & Conformidade
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 2 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-FileAsBytes
Aplicável: Segurança & Conformidade
{{ Preencher FileAsBytes Description }}
Propriedades do parâmetro
| Tipo: | Byte[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 4 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IncidentId
Aplicável: Segurança & Conformidade
O parâmetro IncidentId especifica o incidente a ser analisado no caso de teste.
Você pode encontrar um valor para esse parâmetro em pesquisas de log de auditoria filtradas pela operação DLPRuleMatch na propriedade IncidentId.
Esse parâmetro é necessário para o valor TestCases DlpAlerts_FindAlertForActivity.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 3 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ItemId
Aplicável: Segurança & Conformidade
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 4 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MessageId
Aplicável: Segurança & Conformidade
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 5 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Organization
Aplicável: Segurança & Conformidade
{{ Preencher Descrição da Organização }}
Propriedades do parâmetro
| Tipo: | OrganizationIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 10 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PolicyName
Aplicável: Segurança & Conformidade
{{ Preencher PolicyName Description }}
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 8 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RecipientAddress
Aplicável: Segurança & Conformidade
{{ Preencher descrição do endereçodestinatário }}
Propriedades do parâmetro
| Tipo: | SmtpAddress |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 9 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RecordId
Aplicável: Segurança & Conformidade
O parâmetro RuleName especifica o registro a ser analisado no caso de teste.
Você pode encontrar um valor para esse parâmetro no Activity Explorer filtrado pelo tipo de atividade DLPRuleMatch na propriedade RecordId.
Esse parâmetro é opcional com o valor TestCases DlpAlerts_FindAlertForActivity.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 6 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RuleName
Aplicável: Segurança & Conformidade
O parâmetro RuleName especifica a regra DLP a ser analisada no caso de teste.
Esse parâmetro é opcional com o valor TestCases DlpAlerts_CheckAlertsCreated.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 7 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SenderAddress
Aplicável: Segurança & Conformidade
{{ Preencher EndereçoDeRemetente Descrição }}
Propriedades do parâmetro
| Tipo: | SmtpAddress |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 12 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SharepointItemUniqueId
Aplicável: Segurança & Conformidade
{{ Preencher SharepointItemUniqueId Description }}
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 13 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SharepointSiteId
Aplicável: Segurança & Conformidade
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 14 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SiteUrl
Aplicável: Segurança & Conformidade
{{ Preencher SiteUrl Description }}
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 15 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SitIdentity
Aplicável: Segurança & Conformidade
{{ Preencher SitIdentity Description }}
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 16 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-TestCases
Aplicável: Segurança & Conformidade
O parâmetro TestCases especifica o nome do caso de teste a ser analisado. Os casos de teste disponíveis e seus parâmetros necessários são descritos na lista a seguir:
- Encryption_EvaluationDetails: valida os detalhes de avaliação da criptografia de email. Nenhum outro parâmetro é necessário. Executa Test-IRMConfiguration cmdlet como parte de suas verificações.
- Encryption_LicenseAvailability: verifica as configurações de criptografia de email. Nenhum outro parâmetro é necessário. Executa Get-IRMConfiguration, Get-RMSTemplate, Get-TransportRule e Get-JournalRule cmdlets como parte de suas verificações.
- MipLabels_EnabledEntities_ScopedLabels: mostra os rótulos e as configurações de rótulos que se aplicam a um usuário. Requer o parâmetro UserPrincipalName. Executa cmdlets Get-Label e Get-LabelPolicy como parte de suas verificações.
- MipLabels_LicenseAvailability: Verifica se o recurso Rótulo MIP está habilitado. Nenhum outro parâmetro é necessário.
- DlpAlerts_CheckAlertsCreated: valida a configuração da regra DLP para alertas criados nos últimos 5 dias. Requer o parâmetro DateTimeUTC. O parâmetro RuleName é opcional.
- DlpAlerts_FindAlertForActivity: Identifica alertas ausentes de uma atividade. Requer o parâmetro DateTimeUTC. Os parâmetros IncidentId e RecordId são opcionais.
- DLP_ScopedEntities: retorna todas as políticas e regras de DLP que se aplicam a um usuário ou site. Requer o parâmetro Workload. Os parâmetros SiteUrl e UserPrincipalName são opcionais.
Vários valores, separados por vírgulas, podem ser especificados.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 8 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Theme
Aplicável: Segurança & Conformidade
Os filtros de parâmetro Theme especificam os que devem ser analisados no caso de teste. Os valores válidos são:
- EnabledEntities
- EvaluationDetails
- LicenseAvailability
Propriedades do parâmetro
| Tipo: | PurviewConfigTheme |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 9 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-UserPrincipalName
Aplicável: Segurança & Conformidade
O parâmetro UserPrincipalName especifica a conta de usuário a ser analisada no caso de teste (por exemplo, sathya@contoso.onmicrosoft.com).
- Necessário para o valor TestCases MipLabels_EnabledEntities_ScopedLabels.
- Opcional para o valor TestCases DLP_ScopedEntities.
Propriedades do parâmetro
| Tipo: | SmtpAddress |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 10 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Segurança & Conformidade
A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Workload
Aplicável: Segurança & Conformidade
O parâmetro Workload especifica a carga de trabalho do serviço. Os valores de valor são:
- EndpointDevices
- Exchange
- OneDriveForBusiness
- Microsoft Office SharePoint Online
- Teams
Esse parâmetro é necessário para o valor TestCases DLP_ScopedEntities.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 11 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.