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..
Utilize o cmdlet Check-PurviewConfig para validar e rever 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 (Padrão)
Check-PurviewConfig
[[-Component] <PurviewConfigComponent>]
[-Confirm]
[[-DateTimeUTC] <String>]
[[-DeviceName] <String>]
[[-File] <String>]
[[-FileAsBytes] <Byte[]>]
[[-IncidentId] <String>]
[[-ItemId] <String>]
[[-MessageId] <String>]
[[-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
Utilize o cmdlet Check-PurviewConfig para executar o Microsoft Proteção de Informações casos de teste de diagnóstico para a sua organização e marcar os resultados.
Os administradores com a função Configuração da Organização atribuída têm as permissões necessárias para executar este cmdlet.
Para saber mais sobre as permissões de função de administrador no Microsoft Entra ID, veja IDs de modelo de função.
Importante
A Microsoft defende fortemente o princípio do menor privilégio. Atribuir apenas as permissões mínimas necessárias para realizar as respetivas tarefas ajuda a reduzir os riscos de segurança e reforça a proteção geral da sua organização. O Administrador Global é uma função altamente privilegiada que normalmente limita a cenários de emergência ou quando não pode utilizar uma função diferente.
Exemplos
Exemplo 1
Check-PurviewConfig
Este exemplo executa todos os casos de teste do Microsoft Proteção de Informações que não requerem parâmetros adicionais.
Exemplo 2
Check-PurviewConfig -Component Encryption
Este exemplo executa todos os casos de teste do componente Encriptação.
Exemplo 3
Check-PurviewConfig -Component Encryption -Theme LicenseAvailability
Este exemplo executa todos os casos do tema LicenseAvailability no componente Encriptação.
Exemplo 4
Check-PurviewConfig -TestCases "MipLabels_EnabledEntities_ScopedLabels" -UserPrincipalName sathya@contoso.onmicrosoft.com
Este exemplo executa o caso de teste com o nome 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. É necessário um valor UserPrincipalName para o MipLabels_EnabledEntities_ScopedLabels caso de teste.
Parâmetros
-Component
Aplicável: Conformidade do & de Segurança
O parâmetro Componente especifica o componente a analisar 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: Conformidade do & de Segurança
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não 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 confirmar 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: Conformidade do & de Segurança
O DateTimeUTC especifica a data-hora do caso de teste em Hora Universal Coordenada (UTC). Por exemplo, "2025-06-05 14:30:00".
Este parâmetro é necessário para os seguintes valores 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: Conformidade do & de Segurança
{{ Descrição do Nome do Dispositivo de Preenchimento }}
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: Conformidade do & de Segurança
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: Conformidade do & de Segurança
{{ Fill 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: Conformidade do & de Segurança
O parâmetro IncidentId especifica o incidente a analisar no caso de teste.
Pode encontrar um valor para este parâmetro nas pesquisas de registos de auditoria filtradas pela operação DLPRuleMatch na propriedade IncidentId.
Este 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: Conformidade do & de Segurança
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: Conformidade do & de Segurança
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 |
-PolicyName
Aplicável: Conformidade do & de Segurança
{{ Descrição do Nome da Política de Preenchimento }}
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: Conformidade do & de Segurança
{{ Fill RecipientAddress Description }}
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: Conformidade do & de Segurança
O parâmetro RuleName especifica o registo a analisar no caso de teste.
Pode encontrar um valor para este parâmetro em Activity Explorer filtrado pelo tipo de atividade DLPRuleMatch na propriedade RecordId.
Este 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: Conformidade do & de Segurança
O parâmetro RuleName especifica a regra DLP a analisar no caso de teste.
Este 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: Conformidade do & de Segurança
{{ Fill SenderAddress Description }}
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: Conformidade do & de Segurança
{{ Fill 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: Conformidade do & de Segurança
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: Conformidade do & de Segurança
{{ Descrição do SiteUrl de Preenchimento }}
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: Conformidade do & de Segurança
{{ Fill 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: Conformidade do & de Segurança
O parâmetro TestCases especifica o nome do caso de teste a analisar. Os casos de teste disponíveis e os respetivos parâmetros necessários estão descritos na lista seguinte:
- Encryption_EvaluationDetails: valida os detalhes da avaliação da encriptação de e-mail. Não são necessários outros parâmetros. Executa Test-IRMConfiguration cmdlet como parte das respetivas verificações.
- Encryption_LicenseAvailability: verifica as configurações de encriptação de e-mail. Não são necessários outros parâmetros. Executa os cmdlets Get-IRMConfiguration, Get-RMSTemplate, Get-TransportRule e Get-JournalRule como parte das verificações.
- MipLabels_EnabledEntities_ScopedLabels: mostra as etiquetas e as definições de etiqueta que se aplicam a um utilizador. Requer o parâmetro UserPrincipalName. Executa Get-Label e Get-LabelPolicy cmdlets como parte das respetivas verificações.
- MipLabels_LicenseAvailability: verifica se a funcionalidade Etiqueta MIP está ativada. Não são necessários outros parâmetros.
- 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 em falta para uma atividade. Requer o parâmetro DateTimeUTC. Os parâmetros IncidentId e RecordId são opcionais.
- DLP_ScopedEntities: Devolve todas as políticas e regras DLP que se aplicam a um utilizador ou a um site. Requer o parâmetro Carga de Trabalho. 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: Conformidade do & de Segurança
Os filtros de parâmetros de Tema especificam os mesmos a analisar 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: Conformidade do & de Segurança
O parâmetro UserPrincipalName especifica a conta de utilizador a analisar 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: Conformidade do & de Segurança
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: Conformidade do & de Segurança
O parâmetro Carga de trabalho especifica a carga de trabalho do serviço. Os valores dos valores são:
- EndpointDevices
- Exchange
- OneDriveForBusiness
- Microsoft Office SharePoint Online
- Teams
Este 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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.