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-Websitelaufwerk aus, z. PS XYZ:\>B. . 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 .

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 .

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

-CollectionName

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

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-VariableName

Geben Sie den Namen einer abzurufenden Sammlungsvariablen an.

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

Eingaben

None

Ausgaben

IResultObject[]

IResultObject

Hinweise

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