Compartir a través de

Get-CMComplianceRule

  • Referencia
Módulo:
ConfigurationManager

Obtenga una regla de cumplimiento para un elemento de configuración.

Sintaxis

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

Obtenga una regla de cumplimiento para un elemento de configuración. Las reglas de cumplimiento especifican las condiciones que definen el cumplimiento de una configuración de elemento de configuración. Antes de que el cliente evalúe una configuración de cumplimiento, debe tener al menos una regla de cumplimiento. Para obtener más información, consulte Introducción a la configuración de cumplimiento en Configuration Manager.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Obtener una regla de cumplimiento para un elemento de configuración

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

Parámetros

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Fast

Agregue este parámetro para no actualizar automáticamente las propiedades diferidas. Las propiedades diferidas contienen valores relativamente ineficaces para recuperar. La obtención de estas propiedades puede provocar tráfico de red adicional y reducir el rendimiento del cmdlet.

Si no usa este parámetro, el cmdlet muestra una advertencia. Para deshabilitar esta advertencia, establezca $CMPSSuppressFastNotUsedCheck = $true.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Id

Especifique el CI_ID para el elemento de configuración que tiene la regla de cumplimiento que desea obtener. Por ejemplo, 258895.

Tipo:Int32
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Especifique un objeto de elemento de configuración que tenga la regla de cumplimiento que desea obtener. Para obtener este objeto, use Get-CMConfigurationItem.

Tipo:IResultObject
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Especifique el nombre del elemento de configuración que tiene la regla de cumplimiento que desea obtener.

Tipo:String
Alias:LocalizedDisplayName
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PropertyPath

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RuleName

Especifique el nombre de la regla de cumplimiento en el elemento de configuración. Este valor es el mismo que el valor Nombre de la pestaña Reglas de cumplimiento de las propiedades del elemento de configuración de la consola.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

Microsoft.SystemsManagementServer.DesiredConfigurationManagement.Rules.Rule