Freigeben über

Get-CMComplianceRule

  • Referenz
Modul:
ConfigurationManager

Ruft eine Konformitätsregel für ein Konfigurationselement ab.

Syntax

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>]

Beschreibung

Ruft eine Konformitätsregel für ein Konfigurationselement ab. Kompatibilitätsregeln geben die Bedingungen an, die die Kompatibilität einer Konfigurationselementeinstellung definieren. Bevor der Client eine Einstellung auf Konformität auswertet, muss er über mindestens eine Konformitätsregel verfügen. Weitere Informationen finden Sie unter Erste Schritte mit Konformitätseinstellungen in Configuration Manager.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Abrufen einer Konformitätsregel für ein Konfigurationselement

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

Parameter

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Fast

Fügen Sie diesen Parameter hinzu, um verzögerte Eigenschaften nicht automatisch zu aktualisieren. Verzögerte Eigenschaften enthalten Werte, die relativ ineffizient abgerufen werden können. Das Abrufen dieser Eigenschaften kann zusätzlichen Netzwerkdatenverkehr verursachen und die Cmdlet-Leistung beeinträchtigen.

Wenn Sie diesen Parameter nicht verwenden, zeigt das Cmdlet eine Warnung an. Um diese Warnung zu deaktivieren, legen Sie fest $CMPSSuppressFastNotUsedCheck = $true.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Geben Sie die CI_ID für das Konfigurationselement an, das über die Konformitätsregel verfügt, die Sie abrufen möchten. Beispiel: 258895.

Typ:Int32
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Geben Sie ein Konfigurationselementobjekt an, das über die Konformitätsregel verfügt, die Sie abrufen möchten. Verwenden Sie get-CMConfigurationItem, um dieses Objekt abzurufen.

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Geben Sie den Namen des Konfigurationselements an, das die Konformitätsregel enthält, die Sie abrufen möchten.

Typ:String
Aliase:LocalizedDisplayName
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PropertyPath

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RuleName

Geben Sie den Namen der Konformitätsregel im Konfigurationselement an. Dieser Wert ist identisch mit dem Name-Wert auf der Registerkarte Kompatibilitätsregeln der Konfigurationselementeigenschaften in der Konsole.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

Microsoft.SystemsManagementServer.DesiredConfigurationManagement.Rules.Rule