Invoke-CMWmiMethod

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

WMI メソッドを呼び出します。

構文

Invoke-CMWmiMethod
      [-ClassName] <String>
      -MethodName <String>
      [-Parameter <Hashtable>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-CMWmiMethod
      [-InputObject] <IResultObject>
      -MethodName <String>
      [-Parameter <Hashtable>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Invoke-CMWmiMethod コマンドレットは、Configuration Manager で提供される Windows Management Instrumentation (WMI) メソッドを呼び出します。

注:

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

例

例 1: パイプラインを使用して WMI メソッドを呼び出す

PS XYZ:\> Get-CMBoundaryGroup -Name "Boundary1" | Invoke-CMWmiMethod -MethodName "AddBoundary" -Parameter @{BoundaryId = 16777217,16777218}

このコマンドでは、WMI メソッドを使用して境界グループに境界の配列を追加します。

コマンドは Boundary1 という名前の境界グループ オブジェクトを取得し、パイプライン演算子を使用して オブジェクトを Invoke-CMWmiMethod に渡します。 Invoke-CMWmiMethod は WMI メソッド AddBoundary を呼び出し、ID で指定された境界を境界グループ Boundary1 に追加します。

パラメーター

-ClassName

呼び出す静的メソッドを含む WMI クラスの名前を指定します。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

管理オブジェクトまたは構成管理オブジェクトを指定します。

型:IResultObject
Aliases:Instance
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-MethodName

呼び出すメソッドの名前を指定します。 このパラメーターは必須であり、null または空にすることはできません。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Parameter

プロパティの名前と メソッドの値を指定します。 名前と値は、名前と値のペアである必要があります。 名前と値のペアは、コマンド ラインでハッシュ テーブルとして渡されます。

型:Hashtable
Aliases:Parameters
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object