Set-CMDeviceCollectionVariable

  • Riferimento
Modulo:
ConfigurationManager

Configurare una variabile di raccolta di dispositivi.

Sintassi

Set-CMDeviceCollectionVariable
   -InputObject <IResultObject>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDeviceCollectionVariable
   -CollectionId <String>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDeviceCollectionVariable
   -CollectionName <String>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per modificare una variabile di 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 Configuration Manager cmdlet dall'unità del sito Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Modificare il nome di una variabile

Il primo comando ottiene l'oggetto raccolta di dispositivi denominato Device e lo archivia nella variabile $Collection .

Il secondo comando modifica il nome della variabile di raccolta testTS in NewVariable.

$Collection = Get-CMCollection -Name "Device"
Set-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -NewVariableName "NewVariable"

Esempio 2: Modificare un valore di variabile

Questo comando modifica il valore della variabile testTS nella raccolta Device . Imposta il nuovo valore della variabile su 12.

Set-CMDeviceCollectionVariable -CollectionName "Device" -VariableName "testTS" -NewVariableValue 12

Parametri

-CollectionId

Specificare l'ID di una raccolta di dispositivi per configurare una variabile. 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 .

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

-CollectionName

Specificare il nome di una raccolta di dispositivi per configurare una variabile.

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

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-InputObject

Specificare un oggetto raccolta di dispositivi per configurare una variabile. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection o Get-CMDeviceCollection .

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

-IsMask

Impostare questo parametro su $true per indicare che il valore della variabile è nascosto. I valori mascherati non vengono visualizzati nella console di Configuration Manager, nella proprietà Value nella classe WMI SMS_CollectionVariable o nel file di log della sequenza di attività. La sequenza di attività può comunque usare la variabile .

Una volta nascosta, non è possibile smascherarne una. Se si maschera il valore di una variabile, ma non lo si vuole mascherare, è necessario eliminare e ricreare la variabile.

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

-NewVariableName

Specificare un nuovo nome per la variabile di raccolta. Usare questo parametro per rinominare la variabile.

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

-NewVariableValue

Specificare un nuovo valore per la variabile di raccolta.

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

-VariableName

Specificare il nome della variabile di raccolta da modificare.

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

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object

Note

Per impostare la priorità della variabile, usare il cmdlet Set-CMCollection con il parametro VariablePriority . Per visualizzare la priorità della variabile corrente, usare il cmdlet Get-CMCollectionSetting .