Condividi tramite

Remove-CMSoftwareUpdateAutoDeploymentRule

  • Riferimento
Modulo:
ConfigurationManager

Rimuove le regole di distribuzione di Configuration Manager per gli aggiornamenti software automatici.

Sintassi

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

Descrizione

Il cmdlet Remove-CMSoftwareUpdateAutoDeploymentRule rimuove le regole di distribuzione di Configuration Manager specificate per gli aggiornamenti software automatici.

Configuration Manager usa le regole per gestire la distribuzione automatica degli aggiornamenti software. Quando viene eseguita una regola, Configuration Manager aggiunge gli aggiornamenti idonei per la regola a un gruppo di aggiornamenti software. Il server di Configuration Manager scarica i file di contenuto e li copia nei punti di distribuzione e quindi aggiorna i computer client.

È possibile specificare regole da rimuovere in base all'ID o al nome oppure specificare un oggetto regola usando il cmdlet Get-CMSoftwareUpdateAutoDeploymentRule . Questo cmdlet elimina le regole in modo permanente. È possibile usare il cmdlet Disable-CMSoftwareUpdateAutoDeploymentRule per sospendere una regola.

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 regola di distribuzione per nome

PS XYZ:\> Remove-CMSoftwareUpdateAutoDeploymentRule -Name "Weekly Driver Updates"
Remove
Are you sure you wish to remove SoftwareUpdateAutoDeploymentRule: Name="Weekly Driver Updates"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"):

Questo comando rimuove una regola denominata Aggiornamenti settimanali del driver. Poiché il comando non include il parametro Force , il cmdlet richiede prima di eliminare la regola.

Esempio 2: Rimuovere una regola di distribuzione in base all'ID

PS XYZ:\> Remove-CMSoftwareUpdateAutoDeploymentRule -Id "16777217" -Force

Questo comando disabilita una regola di distribuzione con l'ID 16777217. Questo comando include il parametro Force , quindi il cmdlet non richiede la rimozione della regola.

Esempio 3: Rimuovere una regola di distribuzione usando una variabile

PS XYZ:\> $CMSUADR = Get-CMSoftwareUpdateAutoDeploymentRule -Name "Weekly Driver Updates"
PS XYZ:\> Remove-CMSoftwareUpdateAutoDeploymentRule -InputObject $CMSUADR -Force

Il primo comando ottiene una regola di distribuzione con il nome specificato e quindi la archivia nella variabile $CMSUADR.

Il secondo comando rimuove la regola archiviata nella variabile .

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 ID per le regole per la distribuzione automatica degli aggiornamenti software. Questo valore è la proprietà AutoDeploymentID dell'oggetto regola di distribuzione.

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

-InputObject

Specifica un oggetto regola di distribuzione automatica dell'aggiornamento software. Per ottenere un oggetto regola di distribuzione, usare Get-CMSoftwareUpdateAutoDeploymentRule.

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

-Name

Specifica il nome di una regola per la distribuzione automatica degli aggiornamenti software.

Tipo:String
Posizione:0
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