次の方法で共有

Remove-CMDeviceCollectionVariable

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

デバイス コレクション変数を削除します。

構文

Remove-CMDeviceCollectionVariable
      -Collection <IResultObject>
      [-Force]
      -VariableName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeviceCollectionVariable
      -CollectionId <String>
      [-Force]
      -VariableName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeviceCollectionVariable
      -CollectionName <String>
      [-Force]
      -VariableName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

このコマンドレットを使用して、デバイス コレクション変数を削除します。 既定のコレクションには変数を含めることはできません。 ターゲットとするコレクションには、 SMSではなくサイト コードで始まる ID が必要です。

詳細については、「 タスク シーケンス変数を設定する方法」を参照してください。

注:

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

例

例 1: デバイス コレクション変数を削除する

最初のコマンドは、 Device という名前のデバイス コレクション オブジェクトを取得し、 $Collection 変数に格納します。

2 番目のコマンドは、$Collection変数に格納されているデバイス コレクションから testTS という名前のデバイス コレクション変数を削除します。 Force パラメーターを指定すると、変数が削除される前にプロンプトが表示されません。

$Collection = Get-CMCollection -Name "Device"
Remove-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -Force

例 2: デバイス コレクションからすべての変数を削除する

この例では、まず Get-CMDeviceCollectionVariable コマンドレットを使用して、デバイス コレクション IT サーバー のすべての変数を取得し、 オブジェクトを vars 配列変数に格納します。 次に、配列内の各項目をループし、名前で変数を削除します。

Force パラメーターは、各変数の削除を求めないように使用されます。

$collName = "IT servers"
$vars = Get-CMDeviceCollectionVariable -CollectionName $collName

foreach ( $var in $vars ) {
  Remove-CMDeviceCollectionVariable -CollectionName $collName -VariableName $var -Force
}

VariableName パラメーターではワイルドカードが許可されないため、デバイス コレクションからすべての変数をすばやくクリアする必要がある場合は、このプロセスを使用します。

パラメーター

-Collection

変数を削除するデバイス コレクション オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMCollection コマンドレットまたは Get-CMDeviceCollection コマンドレットを 使用します。

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

-CollectionId

デバイス コレクションの ID を指定して、その変数を削除します。 この値は CollectionID プロパティです (たとえば、 XYZ00012)。 既定のコレクションでは変数を設定できないため、この値は SMSではなくサイト コードで始まります。

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

-CollectionName

変数を削除するデバイス コレクションの名前を指定します。

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

-Confirm

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

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

-DisableWildcardHandling

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

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

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。

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

-ForceWildcardHandling

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

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

-VariableName

削除するコレクション変数の名前を指定します。 このパラメーターはワイルドカード文字を受け取りません。

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

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object