Remove-CMDeviceCollectionVariable

  • Riferimento
Modulo:
ConfigurationManager

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 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: 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 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 .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly: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 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 rimuovere le relative variabili.

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

-Force

Forza l'esecuzione del comando senza richiedere la conferma dell'utente.

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 rimuovere. Questo parametro non accetta caratteri jolly.

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

System.Object