Partilhar via


Get-CMComplianceRule

SYNOPSIS

Obtenha uma regra de conformidade para um item de configuração.

SYNTAX

ById

Get-CMComplianceRule [-Fast] [-Id] <Int32> [-PropertyPath <String>] [-RuleName <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

ByValue

Get-CMComplianceRule [-Fast] -InputObject <IResultObject> [-PropertyPath <String>] [-RuleName <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

ByName

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 do item de configuração. Antes que o cliente avalie uma definição de conformidade, deve ter pelo menos uma regra de conformidade. Para obter mais informações, consulte Começar com as definições de conformidade no Gestor de Configuração.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1: Obtenha uma regra de conformidade para um item de configuração

Get-CMComplianceRule -Name "BitLocker data drive protection" -RuleName "06 must exist" -Fast

PARAMETERS

-DisableWildcardHandling

Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- Rápido

Adicione este parâmetro para não atualizar automaticamente as propriedades preguiçosas. As propriedades preguiçosas contêm valores que são relativamente ineficientes de recuperação. Obter estas propriedades pode causar tráfego adicional de rede e diminuir o desempenho do cmdlet.

Se não utilizar este parâmetro, o cmdlet apresenta um aviso. Para desativar este aviso, desative $CMPSSuppressFastNotUsedCheck = $true .

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- ID

Especifique o CI_ID para o item de configuração que tem a regra de conformidade que pretende obter. Por exemplo, 258895.

Type: Int32
Parameter Sets: ById
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InputObject

Especifique um objeto de item de configuração que tenha a regra de conformidade que pretende obter. Para obter este objeto, utilize o Get-CMConfigurationItem.

Type: IResultObject
Parameter Sets: ByValue
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

Especifique o nome do item de configuração que tem a regra de conformidade que pretende obter.

Type: String
Parameter Sets: ByName
Aliases: LocalizedDisplayName

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- PropertyPath

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RegraName

Especifique o nome da regra de conformidade no item de configuração. Este valor é o mesmo que o valor Nome no separador Regras de Conformidade das propriedades do item de configuração na consola.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

Microsoft.SystemsManageserver.DesiredConfigurationManagement.Rules.Rule

NOTAS

Get-CMConfigurationItem

Get-CMComplianceSetting