Get-CMComplianceRule
Obtenha uma regra de conformidade para um item de configuração.
Sintaxe
Get-CMComplianceRule
[-Fast]
[-Id] <Int32>
[-PropertyPath <String>]
[-RuleName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMComplianceRule
[-Fast]
-InputObject <IResultObject>
[-PropertyPath <String>]
[-RuleName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMComplianceRule
[-Fast]
[-Name] <String>
[-PropertyPath <String>]
[-RuleName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Description
Obtenha uma regra de conformidade para um item de configuração. As regras de conformidade especificam as condições que definem a conformidade de uma configuração de item. Antes que o cliente avalie uma configuração de conformidade, ele deve ter pelo menos uma regra de conformidade. Para obter mais informações, consulte Introdução às configurações de conformidade no Configuration Manager.
Observação
Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, confira introdução.
Exemplos
Exemplo 1: obter uma regra de conformidade para um item de configuração
Get-CMComplianceRule -Name "BitLocker data drive protection" -RuleName "06 must exist" -Fast
Parâmetros
-DisableWildcardHandling
Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Fast
Adicione esse parâmetro para não atualizar automaticamente propriedades preguiçosas. Propriedades preguiçosas contêm valores relativamente ineficientes para recuperar. Obter essas propriedades pode causar tráfego de rede adicional e diminuir o desempenho do cmdlet.
Se você não usar esse parâmetro, o cmdlet exibirá um aviso. Para desabilitar esse aviso, defina $CMPSSuppressFastNotUsedCheck = $true
.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Id
Especifique o CI_ID para o item de configuração que tem a regra de conformidade que você deseja obter. Por exemplo, 258895
.
Tipo: | Int32 |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-InputObject
Especifique um objeto de item de configuração que tenha a regra de conformidade que você deseja obter. Para obter esse objeto, use o Get-CMConfigurationItem.
Tipo: | IResultObject |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-Name
Especifique o nome do item de configuração que tem a regra de conformidade que você deseja obter.
Tipo: | String |
Aliases: | LocalizedDisplayName |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PropertyPath
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RuleName
Especifique o nome da regra de conformidade no item de configuração. Esse valor é o mesmo que o valor Nome na guia Regras de Conformidade das propriedades do item de configuração no console.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
Microsoft.SystemsManagementServer.DesiredConfigurationManagement.Rules.Rule
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de