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

説明

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

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

注意

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

例

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

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

2 番目のコマンドは 、testTSという名前のデバイス コレクション変数を 、$Collectionします。 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 コマンドレット を使用します。

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

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

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

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

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

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

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

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

ユーザーの確認を求めることなく、コマンドを強制的に実行します。

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

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

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

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object