Remove-CMSoftwareUpdateFromPackage

Módulo:

ConfigurationManager

Remover uma atualização de um pacote de atualização de software.

Sintaxe

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

Description

Utilize este cmdlet para remover a atualização de software especificada de um pacote.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Remover uma atualização e atualizar o conteúdo

Este exemplo obtém primeiro o ID de uma atualização de software. Em seguida, obtém um pacote de atualização de software pelo respetivo ID. O último comando remove a atualização do pacote. Atualiza o conteúdo no ponto de distribuição e não pede confirmação.

$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

Exemplo 2: Remover duas atualizações, mas não atualizar o conteúdo

Este exemplo define primeiro os nomes de duas atualizações de software. Em seguida, obtém um pacote de atualização de software pelo respetivo ID. O último comando remove ambas as atualizações de software do pacote. Uma vez que este comando não inclui o parâmetro Force , pede confirmação. Uma vez que não inclui o parâmetro RefreshDistributionPoint , tem de atualizar manualmente o conteúdo em pontos de distribuição.

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

$suppkg1 = Get-CMSoftwareUpdateDeploymentPackage -Id "XYZ0000C"

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

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Force

Adicione este parâmetro para executar o comando sem pedir confirmação.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RefreshDistributionPoint

Adicione este parâmetro para atualizar o conteúdo do pacote nos pontos de distribuição. Se não incluir este parâmetro, terá de atualizar manualmente os pontos de distribuição. Para obter mais informações, veja Gerir conteúdo distribuído.

Tipo:	SwitchParameter
Aliases:	RefreshDistributionPointAfterRemoveSoftwareUpdateFromPackage
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SoftwareUpdate

Especifique uma matriz de objetos de atualização de software a remover do pacote. Para obter este objeto, utilize o cmdlet Get-CMSoftwareUpdate .

Tipo:	IResultObject[]
Aliases:	SoftwareUpdates
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-SoftwareUpdateId

Especifique uma matriz de IDs para atualizações de software a remover do pacote. Este valor é o CI_ID da atualização, por exemplo 1584792.

Tipo:	String[]
Aliases:	SoftwareUpdateIds
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SoftwareUpdateName

Especifique uma matriz de nomes para atualizações de software a remover do pacote.

Tipo:	String[]
Aliases:	SoftwareUpdateNames
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	True

-SoftwareUpdatePackage

Especifique um objeto de pacote de atualização de software a partir do qual pretende remover as atualizações. Para obter este objeto, utilize o cmdlet Get-CMSoftwareUpdateDeploymentPackage .

Tipo:	IResultObject
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-SoftwareUpdatePackageId

Especifique um ID do pacote de atualização de software a partir do qual pretende remover as atualizações. Este valor é um ID de pacote padrão, por exemplo XYZ0035E.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SoftwareUpdatePackageName

Especifique um nome de pacote de atualização de software a partir do qual pretende remover as atualizações.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object

Links Relacionados

• Get-CMSoftwareUpdateDeploymentPackage
• New-CMSoftwareUpdateDeploymentPackage
• Set-CMSoftwareUpdateDeploymentPackage
• Remove-CMSoftwareUpdateDeploymentPackage
• Get-CMSoftwareUpdate
• Save-CMSoftwareUpdate