Remove-CMSoftwareUpdateFromPackage
Entfernen sie ein Update aus einem Softwareupdatepaket.
Syntax
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>]
Beschreibung
Verwenden Sie dieses Cmdlet, um das angegebene Softwareupdate aus einem Paket zu entfernen.
Hinweis
Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>
. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1: Entfernen eines Updates und Aktualisieren des Inhalts
In diesem Beispiel wird zunächst die ID eines Softwareupdates abgerufen. Anschließend wird ein Softwareupdatepaket anhand seiner ID abgerufen. Der letzte Befehl entfernt das Update aus dem Paket. Er aktualisiert den Inhalt auf dem Verteilungspunkt und fordert nicht zur Bestätigung auf.
$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
Beispiel 2: Entfernen von zwei Updates, aber aktualisieren Sie den Inhalt nicht
In diesem Beispiel werden zunächst die Namen von zwei Softwareupdates definiert. Anschließend wird ein Softwareupdatepaket anhand seiner ID abgerufen. Mit dem letzten Befehl werden beide Softwareupdates aus dem Paket entfernt. Da dieser Befehl den Force-Parameter nicht enthält, wird zur Bestätigung aufgefordert. Da er den RefreshDistributionPoint-Parameter nicht enthält, müssen Sie den Inhalt auf Verteilungspunkten manuell aktualisieren.
$SU1 = "Bing Bar 7.1 (KB2673771)"
$SU2 = "Bing Bar 7.1 (KB2673772)"
$suppkg1 = Get-CMSoftwareUpdateDeploymentPackage -Id "XYZ0000C"
Remove-CMSoftwareUpdateFromPackage -SoftwareUpdatePackage $suppkg1 -SoftwareUpdateName ($SU1, $SU2)
Parameter
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Force
Fügen Sie diesen Parameter hinzu, um den Befehl auszuführen, ohne zur Bestätigung zu fragen.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RefreshDistributionPoint
Fügen Sie diesen Parameter hinzu, um den Paketinhalt auf den Verteilungspunkten zu aktualisieren. Wenn Sie diesen Parameter nicht einschließen, müssen Sie Verteilungspunkte manuell aktualisieren. Weitere Informationen finden Sie unter Verwalten verteilter Inhalte.
Typ: | SwitchParameter |
Aliase: | RefreshDistributionPointAfterRemoveSoftwareUpdateFromPackage |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SoftwareUpdate
Geben Sie ein Array von Softwareupdateobjekten an, die aus dem Paket entfernt werden sollen. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMSoftwareUpdate .
Typ: | IResultObject[] |
Aliase: | SoftwareUpdates |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-SoftwareUpdateId
Geben Sie ein Array von IDs für Softwareupdates an, die aus dem Paket entfernt werden sollen. Dieser Wert ist der CI_ID des Updates, z. B 1584792
. .
Typ: | String[] |
Aliase: | SoftwareUpdateIds |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SoftwareUpdateName
Geben Sie ein Array von Namen für Softwareupdates an, die aus dem Paket entfernt werden sollen.
Typ: | String[] |
Aliase: | SoftwareUpdateNames |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | True |
-SoftwareUpdatePackage
Geben Sie ein Softwareupdatepaketobjekt an, aus dem die Updates entfernt werden sollen. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMSoftwareUpdateDeploymentPackage .
Typ: | IResultObject |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-SoftwareUpdatePackageId
Geben Sie eine Softwareupdatepaket-ID an, aus der die Updates entfernt werden sollen. Dieser Wert ist eine Standardpaket-ID, z. B XYZ0035E
. .
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SoftwareUpdatePackageName
Geben Sie einen Softwareupdatepaketnamen an, aus dem die Updates entfernt werden sollen.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
System.Object