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 Configuration Manager cmdlet dall'unità del sito 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.

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

-Id

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

Type:Int32
Aliases:CIId, CI_ID
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:IResultObject
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Specifica una matrice di nomi di elementi di configurazione.

Type:String
Aliases:LocalizedDisplayName
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-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