Get-CMComplianceRule

  • リファレンス
モジュール:
ConfigurationManager

構成項目のコンプライアンス規則を取得します。

構文

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

説明

構成項目のコンプライアンス規則を取得します。 コンプライアンス 規則では、構成項目設定のコンプライアンスを定義する条件を指定します。 クライアントがコンプライアンスの設定を評価する前に、少なくとも 1 つのコンプライアンス規則が必要です。 詳細については、「Configuration Managerでのコンプライアンス設定の概要」を参照してください。

注:

Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>)。 詳細については、「作業の 開始」を参照してください。

例

例 1: 構成項目のコンプライアンス規則を取得する

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

パラメーター

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

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

-Fast

このパラメーターを追加して、遅延プロパティを自動的に更新しないようにします。 遅延プロパティには、取得するのが比較的非効率的な値が含まれています。 これらのプロパティを取得すると、追加のネットワーク トラフィックが発生し、コマンドレットのパフォーマンスが低下する可能性があります。

このパラメーターを使用しない場合、コマンドレットに警告が表示されます。 この警告を無効にするには、 を設定します $CMPSSuppressFastNotUsedCheck = $true。

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

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

-Id

取得するコンプライアンス規則を持つ構成項目の CI_ID を指定します。 たとえば、「 258895 」のように入力します。

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

-InputObject

取得するコンプライアンス規則を持つ構成項目オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMConfigurationItem を使用します。

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

-Name

取得するコンプライアンス規則を持つ構成項目の名前を指定します。

Type:String
Aliases:LocalizedDisplayName
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PropertyPath

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

-RuleName

構成項目でコンプライアンス規則の名前を指定します。 この値は、コンソールの構成項目プロパティの [コンプライアンス規則] タブの [名前] の値と同じです。

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

Microsoft.SystemsManagementServer.DesiredConfigurationManagement.Rules.Rule