Remove-CMDeviceCollectionVariable
Rimuovere una variabile di raccolta di dispositivi.
Sintassi
Remove-CMDeviceCollectionVariable
-Collection <IResultObject>
[-Force]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMDeviceCollectionVariable
-CollectionId <String>
[-Force]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMDeviceCollectionVariable
-CollectionName <String>
[-Force]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Usare questo cmdlet per rimuovere 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: Rimuovere 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 rimuove la variabile di raccolta di dispositivi denominata testTS dalla raccolta di dispositivi archiviata nella variabile $Collection . Se si specifica il parametro Force , non viene richiesto prima che la variabile venga rimossa.
$Collection = Get-CMCollection -Name "Device"
Remove-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -Force
Esempio 2: Rimuovere tutte le variabili da una raccolta di dispositivi
In questo esempio viene innanzitutto usato il cmdlet Get-CMDeviceCollectionVariable per ottenere tutte le variabili nella raccolta di dispositivi server IT e archiviare gli oggetti nella variabile di matrice vars . Esegue quindi un ciclo di ogni elemento nella matrice e rimuove la variabile in base al nome.
Il parametro Force viene usato in modo che non venga richiesto di rimuovere ogni variabile.
$collName = "IT servers"
$vars = Get-CMDeviceCollectionVariable -CollectionName $collName
foreach ( $var in $vars ) {
Remove-CMDeviceCollectionVariable -CollectionName $collName -VariableName $var -Force
}
Poiché il parametro VariableName non consente i caratteri jolly, usare questo processo se è necessario cancellare rapidamente tutte le variabili da una raccolta di dispositivi.
Parametri
-Collection
Specificare un oggetto raccolta di dispositivi per rimuovere le relative variabili. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection o Get-CMDeviceCollection .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CollectionId
Specificare l'ID di una raccolta di dispositivi per rimuovere 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 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 rimuovere le relative variabili.
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 |
-Force
Forza l'esecuzione del comando senza richiedere la conferma dell'utente.
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 |
-VariableName
Specificare il nome di una variabile di raccolta da rimuovere. Questo parametro non accetta caratteri jolly.
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
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