Remove-CMSoftwareUpdateFromPackage

  • Riferimento
Modulo:
ConfigurationManager

Rimuovere un aggiornamento da un pacchetto di aggiornamento software.

Sintassi

Remove-CMSoftwareUpdateFromPackage
      -SoftwareUpdateId <String[]>
      -SoftwareUpdatePackageId <String>
      [-RefreshDistributionPoint]
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMSoftwareUpdateFromPackage
      -SoftwareUpdate <IResultObject[]>
      -SoftwareUpdatePackageId <String>
      [-RefreshDistributionPoint]
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMSoftwareUpdateFromPackage
      -SoftwareUpdate <IResultObject[]>
      -SoftwareUpdatePackageName <String>
      [-RefreshDistributionPoint]
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMSoftwareUpdateFromPackage
      -SoftwareUpdate <IResultObject[]>
      -SoftwareUpdatePackage <IResultObject>
      [-RefreshDistributionPoint]
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMSoftwareUpdateFromPackage
      -SoftwareUpdateId <String[]>
      -SoftwareUpdatePackageName <String>
      [-RefreshDistributionPoint]
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMSoftwareUpdateFromPackage
      -SoftwareUpdateId <String[]>
      -SoftwareUpdatePackage <IResultObject>
      [-RefreshDistributionPoint]
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMSoftwareUpdateFromPackage
      -SoftwareUpdateName <String[]>
      -SoftwareUpdatePackageId <String>
      [-RefreshDistributionPoint]
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMSoftwareUpdateFromPackage
      -SoftwareUpdateName <String[]>
      -SoftwareUpdatePackageName <String>
      [-RefreshDistributionPoint]
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMSoftwareUpdateFromPackage
      -SoftwareUpdateName <String[]>
      -SoftwareUpdatePackage <IResultObject>
      [-RefreshDistributionPoint]
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Usare questo cmdlet per rimuovere l'aggiornamento software specificato da un pacchetto.

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 aggiornamento e aggiornare il contenuto

In questo esempio viene innanzitutto ottenuto l'ID di un aggiornamento software. Ottiene quindi un pacchetto di aggiornamento software in base al relativo ID. L'ultimo comando rimuove l'aggiornamento dal pacchetto. Aggiorna il contenuto nel punto di distribuzione e non richiede conferma.

$SU0 = "Bing Bar 7.1 (KB2673770)"
$SU0_ID = ( Get-CMSoftwareUpdate -Name $SU0 -Fast ).CI_ID

$suppkg1 = Get-CMSoftwareUpdateDeploymentPackage -Id "XYZ0000C"

Remove-CMSoftwareUpdateFromPackage -SoftwareUpdatePackageId $suppkg1.PackageID -SoftwareUpdateId $SU0_ID -RefreshDistributionPoint -Force

Esempio 2: Rimuovere due aggiornamenti ma non aggiornare il contenuto

In questo esempio vengono prima definiti i nomi di due aggiornamenti software. Ottiene quindi un pacchetto di aggiornamento software in base al relativo ID. L'ultimo comando rimuove entrambi gli aggiornamenti software dal pacchetto. Poiché questo comando non include il parametro Force , richiede la conferma. Poiché non include il parametro RefreshDistributionPoint , è necessario aggiornare manualmente il contenuto nei punti di distribuzione.

$SU1 = "Bing Bar 7.1 (KB2673771)"
$SU2 = "Bing Bar 7.1 (KB2673772)"

$suppkg1 = Get-CMSoftwareUpdateDeploymentPackage -Id "XYZ0000C"

Remove-CMSoftwareUpdateFromPackage -SoftwareUpdatePackage $suppkg1 -SoftwareUpdateName ($SU1, $SU2)

Parametri

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
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

Aggiungere questo parametro per eseguire il comando senza richiedere conferma.

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

-RefreshDistributionPoint

Aggiungere questo parametro per aggiornare il contenuto del pacchetto nei punti di distribuzione. Se non si include questo parametro, è necessario aggiornare manualmente i punti di distribuzione. Per altre informazioni, vedere Gestire il contenuto distribuito.

Tipo:SwitchParameter
Alias:RefreshDistributionPointAfterRemoveSoftwareUpdateFromPackage
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SoftwareUpdate

Specificare una matrice di oggetti di aggiornamento software da rimuovere dal pacchetto. Per ottenere questo oggetto, usare il cmdlet Get-CMSoftwareUpdate .

Tipo:IResultObject[]
Alias:SoftwareUpdates
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SoftwareUpdateId

Specificare una matrice di ID per gli aggiornamenti software da rimuovere dal pacchetto. Questo valore è il CI_ID dell'aggiornamento, ad esempio 1584792.

Tipo:String[]
Alias:SoftwareUpdateIds
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SoftwareUpdateName

Specificare una matrice di nomi per gli aggiornamenti software da rimuovere dal pacchetto.

Tipo:String[]
Alias:SoftwareUpdateNames
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-SoftwareUpdatePackage

Specificare un oggetto pacchetto di aggiornamento software da cui rimuovere gli aggiornamenti. Per ottenere questo oggetto, usare il cmdlet Get-CMSoftwareUpdateDeploymentPackage .

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

-SoftwareUpdatePackageId

Specificare un ID pacchetto di aggiornamento software da cui rimuovere gli aggiornamenti. Questo valore è un ID pacchetto standard, ad esempio XYZ0035E.

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

-SoftwareUpdatePackageName

Specificare un nome del pacchetto di aggiornamento software da cui rimuovere gli aggiornamenti.

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:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object