New-CMDeviceCollectionVariable
Creare una variabile di raccolta di dispositivi.
Sintassi
New-CMDeviceCollectionVariable
-InputObject <IResultObject>
[-IsMask <Boolean>]
[-Value <String>]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMDeviceCollectionVariable
-CollectionId <String>
[-IsMask <Boolean>]
[-Value <String>]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMDeviceCollectionVariable
-CollectionName <String>
[-IsMask <Boolean>]
[-Value <String>]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Descrizione
Usare questo cmdlet per creare una variabile di raccolta di dispositivi. È possibile usare una variabile di raccolta di dispositivi per definire variabili della sequenza di attività personalizzate e i relativi valori associati che devono essere usati dai dispositivi in una raccolta. Le variabili della sequenza di attività sono un set di coppie nome e valore che forniscono un meccanismo per configurare e personalizzare i passaggi di una sequenza di attività quando la sequenza di attività viene distribuita in una raccolta specifica.
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: Creare una variabile di raccolta di dispositivi
Il primo comando ottiene l'oggetto raccolta di dispositivi denominato Device e lo archivia nella variabile $Collection .
Il secondo comando crea una variabile di raccolta denominata testTS con il valore test001 per l'oggetto raccolta archiviato in $Collection.
$Collection = Get-CMCollection -Name "Device"
New-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -Value "test001"Parametri
-CollectionId
Specificare l'ID di una raccolta di dispositivi in cui creare la 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 .
| 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 in cui creare la variabile.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Confirm
Richiede la conferma prima di eseguire il cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| 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 |
-InputObject
Specificare un oggetto raccolta di dispositivi in cui creare la variabile. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection o Get-CMDeviceCollection .
| Tipo: | IResultObject |
| Alias: | Collection |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | 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.
Se non si include questo parametro, i valori non vengono mascherati per impostazione predefinita.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Value
Specificare un valore per la variabile di raccolta.
| Tipo: | String |
| Alias: | VariableValue |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-VariableName
Specificare un nome per la variabile di raccolta da creare.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-WhatIf
Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
Input
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Output
IResultObject[]
IResultObject
Note
Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_CollectionSettings classe WMI del server.