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 が必要です。

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

注:

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

例

例 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 コマンドレットを 使用します。

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

-CollectionId

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

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

-CollectionName

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

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

-Confirm

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

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

-DisableWildcardHandling

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

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

-Force

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

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

-VariableName

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

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

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object