Share via

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
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

Aggiungere questo parametro per eseguire il comando senza richiedere conferma.

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

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

Type:SwitchParameter
Aliases:RefreshDistributionPointAfterRemoveSoftwareUpdateFromPackage
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareUpdate

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

Type:IResultObject[]
Aliases:SoftwareUpdates
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Aliases:SoftwareUpdateIds
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareUpdateName

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

Type:String[]
Aliases:SoftwareUpdateNames
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-SoftwareUpdatePackage

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

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

-SoftwareUpdatePackageId

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareUpdatePackageName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object