Set-CMDeviceCollectionVariable
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 SMS
con .
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 SMS
con .
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 .
Collegamenti correlati
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per