Get-CMDeviceCollectionVariable

  • Referenz
Modul:
ConfigurationManager

Ruft eine Gerätesammlungsvariable ab.

Syntax

Get-CMDeviceCollectionVariable
   -CollectionName <String>
   [-VariableName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMDeviceCollectionVariable
   -Collection <IResultObject>
   [-VariableName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMDeviceCollectionVariable
   -CollectionId <String>
   [-VariableName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um die Tasksequenzvariablen für eine Gerätesammlung abzurufen. 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: Abrufen einer Gerätesammlungsvariablen anhand des Namens

Dieser Befehl ruft die Sammlungsvariable testTS für die Gerätesammlung mit dem Namen Device ab.

Get-CMDeviceCollectionVariable -CollectionName "DeviceCollection02" -VariableName "testTS"

Beispiel 2: Abrufen aller nicht maskierten Variablen für eine Sammlung

In diesem Beispiel werden alle Variablen von den IT-Sammlungsservern abgerufen und die Liste nur auf die Variablen gefiltert, die nicht ausgeblendet sind. Anschließend werden der Name und der Wert für jede Variable in einer Tabelle angezeigt.

Get-CMDeviceCollectionVariable -CollectionName "IT servers" | Where-Object { -not $_.IsMasked } | Select-Object Name, Value

Parameter

-Collection

Geben Sie ein Gerätesammlungsobjekt an, um die zugehörigen Variablen abzurufen. Verwenden Sie zum Abrufen dieses Objekts die Cmdlets Get-CMCollection oder Get-CMDeviceCollection .

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

-CollectionId

Geben Sie die ID einer Gerätesammlung an, um deren Variablen abzurufen. 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 abzurufen.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
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

-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 abzurufenden Sammlungsvariablen an.

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

Eingaben

None

Ausgaben

IResultObject[]

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_CollectionVariable WMI-Serverklasse.