Condividi tramite


Get-CMDeviceCollectionVariable

Ottenere una variabile di raccolta di dispositivi.

Sintassi

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

Descrizione

Usare questo cmdlet per ottenere le variabili della sequenza di attività in una raccolta di dispositivi. Le raccolte predefinite non possono avere variabili. Qualsiasi raccolta di destinazione deve avere un ID che inizia con il codice del sito, non SMScon .

Per altre informazioni, vedere Come impostare le variabili della sequenza di attività.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Ottenere una variabile di raccolta di dispositivi per nome

Questo comando ottiene la variabile di raccolta denominata testTS per la raccolta di dispositivi denominata Device.

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

Esempio 2: Ottenere tutte le variabili non mascherate per una raccolta

In questo esempio vengono recuperate tutte le variabili dai server IT della raccolta e l'elenco viene filtrato in base solo alle variabili non nascoste. Vengono quindi visualizzati il nome e il valore per ogni variabile in una tabella.

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

Parametri

-Collection

Specificare un oggetto raccolta di dispositivi per ottenere le relative variabili. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection o Get-CMDeviceCollection .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CollectionId

Specificare l'ID di una raccolta di dispositivi per ottenere le relative variabili. Questo valore è la proprietà CollectionID , ad esempio XYZ00012. Poiché non è possibile impostare variabili nelle raccolte predefinite, questo valore inizia con il codice del sito, non SMScon .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CollectionName

Specificare il nome di una raccolta di dispositivi per ottenere le relative variabili.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VariableName

Specificare il nome di una variabile di raccolta da ottenere.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

IResultObject[]

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_CollectionVariable classe WMI del server.