Freigeben über

Remove-CMDeviceCollectionVariable

  • Referenz
Modul:
ConfigurationManager

Entfernen Sie eine Gerätesammlungsvariable.

Syntax

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

Beschreibung

Verwenden Sie dieses Cmdlet, um eine Gerätesammlungsvariable zu entfernen. Standardsammlungen dürfen keine Variablen aufweisen. Jede Sammlung, auf die Sie abzielen, sollte über eine ID verfügen, die mit dem Websitecode beginnt, nicht SMS.

Weitere Informationen finden Sie unter Festlegen von Tasksequenzvariablen.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Entfernen einer Gerätesammlungsvariablen

Der erste Befehl ruft das Gerätesammlungsobjekt mit dem Namen Device ab und speichert es in der variablen $Collection .

Der zweite Befehl entfernt die Gerätesammlungsvariable testTS aus der Gerätesammlung, die in der $Collection-Variablen gespeichert ist. Wenn Sie den Force-Parameter angeben, werden Sie nicht dazu aufgefordert, bevor die Variable entfernt wird.

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

Beispiel 2: Entfernen aller Variablen aus einer Gerätesammlung

In diesem Beispiel wird zunächst das Cmdlet Get-CMDeviceCollectionVariable verwendet, um alle Variablen auf den IT-Servern der Gerätesammlung abzurufen und die Objekte in der Arrayvariable vars zu speichern. Anschließend durchläuft er jedes Element im Array und entfernt die Variable anhand des Namens.

Der Force-Parameter wird verwendet, damit Sie nicht aufgefordert werden, jede Variable zu entfernen.

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

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

Da der VariableName-Parameter keine Wildcards zulässt, verwenden Sie diesen Prozess, wenn Sie schnell alle Variablen aus einer Gerätesammlung löschen müssen.

Parameter

-Collection

Geben Sie ein Gerätesammlungsobjekt an, um dessen Variablen zu entfernen. Verwenden Sie zum Abrufen dieses Objekts die Cmdlets Get-CMCollection oder Get-CMDeviceCollection .

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-CollectionId

Geben Sie die ID einer Gerätesammlung an, um deren Variablen zu entfernen. Dieser Wert ist die CollectionID-Eigenschaft , z. B XYZ00012. . Da Sie keine Variablen für Standardsammlungen festlegen können, beginnt dieser Wert mit dem Websitecode und nicht SMSmit .

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CollectionName

Geben Sie den Namen einer Gerätesammlung an, um deren Variablen zu entfernen.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Erzwingt die Ausführung des Befehls ohne Benutzerbestätigung.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VariableName

Geben Sie den Namen einer zu entfernenden Sammlungsvariable an. Dieser Parameter akzeptiert keine Platzhalterzeichen.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object