Get-CMConfigurationItem

リファレンス

モジュール:: ConfigurationManager

Configuration Manager 構成アイテムを取得します。

構文

Get-CMConfigurationItem
   [-Fast]
   [[-Name] <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMConfigurationItem
   [-Fast]
   [-Id] <Int32>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

説明

Get-CMConfigurationItem コマンドレットは、Configuration Manager で構成アイテムオブジェクトを取得します。このコマンドレットを使用して、他のコマンドレットで使用するアイテムを取得できます。たとえば、構成項目を取得して、構成項目を使用してSet-CMConfigurationItem設定を変更できます。

構成アイテムには、コンプライアンスルールと共に 1 つ以上の設定が含まれます。構成項目の詳細については、「Configuration Manager でのコンプライアンスの概要」設定を参照してください。

注意

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

例

例 1: 名前を使用してアイテムを取得する

PS XYZ:\> Get-CMConfigurationItem -Name "ConfigItem76"

このコマンドは、ConfigItem76 という名前の構成アイテムを取得します。

例 2: 別のコマンドレットで使用するアイテムを取得する

PS XYZ:\> $CIObj=Get-CMConfigurationItem -Id "16777568"
PS XYZ:\> Remove-CMConfigurationItem -InputObject $CIObj

最初のコマンドは、指定した識別子を持つ構成アイテムを取得し、その構成アイテムを変数$CIObjします。

2 番目のコマンドは、変数変数内のアイテム$CIObjします。

パラメーター

-DisableWildcardHandling

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

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

-Fast

コマンドレットが遅延プロパティを自動的に更新しないかどうかを示します。

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

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

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

-Id

1 つ以上の構成項目の識別子の配列を指定します。コンマ区切りリストを使用できます。

Type:	Int32
Aliases:	CIId, CI_ID
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

構成項目の名前の配列を指定します。コンマ区切りリストを使用できます。

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

入力

なし

出力

IResultObject[]

IResultObject