Condividi tramite

Remove-CMConfigurationItem

  • Riferimento
Modulo:
ConfigurationManager

Rimuove gli elementi di configurazione da Configuration Manager.

Sintassi

Remove-CMConfigurationItem
      [-Force]
      [-Id] <Int32>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMConfigurationItem
      [-Force]
      [-InputObject] <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMConfigurationItem
      [-Force]
      [-Name] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Il cmdlet Remove-CMConfigurationItem rimuove gli elementi di configurazione specificati da Configuration Manager. È possibile specificare gli elementi in base a ID, nome o tramite il cmdlet .

Gli elementi di configurazione contengono una o più impostazioni, insieme alle regole di conformità. Gli elementi in genere definiscono un'unità di configurazione desiderata.

Se si rimuove un elemento di configurazione distribuito in una raccolta, verrà rimossa anche la distribuzione.

Per altre informazioni sugli elementi di configurazione, vedere Introduzione alle impostazioni di conformità in Configuration Manager.

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 un elemento usando un ID

PS XYZ:\> Remove-CMConfigurationItem -Id "16777568"

Questo comando rimuove un elemento di configurazione con l'identificatore specificato.

Esempio 2: Rimuovere un elemento usando un nome

PS XYZ:\> Remove-CMConfigurationItem -Name "ConfigItem76"

Questo comando rimuove un elemento di configurazione denominato ConfigItem76.

Esempio 3: Rimuovere un elemento usando una variabile

PS XYZ:\> $CIObj=Get-CMConfigurationItem -Id "16777568"
PS XYZ:\> Remove-CMConfigurationItem -InputObject $CIObj

Il primo comando ottiene un elemento di configurazione con l'identificatore specificato e lo archivia nella variabile $CIObj.

Il secondo comando rimuove l'elemento archiviato nella variabile $CIObj.

Parametri

-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

-Id

Specifica una matrice di identificatori per uno o più elementi di configurazione. È possibile usare un elenco delimitato da virgole.

Tipo:Int32
Alias:CIId, CI_ID
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specifica un oggetto elemento di configurazione. Per ottenere un oggetto elemento di configurazione, è possibile usare il cmdlet Get-CMConfigurationItem .

Tipo:IResultObject
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica una matrice di nomi di elementi di configurazione.

Tipo:String
Alias:LocalizedDisplayName
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-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