Share via

Set-CMSoftwareUpdateGroup

  • Referência
Módulo:
ConfigurationManager

Altera as configurações dos grupos de atualização de software no Configuration Manager.

Syntax

Set-CMSoftwareUpdateGroup
   [-AddSoftwareUpdate <IResultObject[]>]
   [-ClearExpiredSoftwareUpdate]
   [-ClearSoftwareUpdate]
   [-ClearSupersededSoftwareUpdate]
   [-Description <String>]
   -Id <Int32>
   [-NewName <String>]
   [-PassThru]
   [-RemoveSoftwareUpdate <IResultObject[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMSoftwareUpdateGroup
   [-AddSoftwareUpdate <IResultObject[]>]
   [-ClearExpiredSoftwareUpdate]
   [-ClearSoftwareUpdate]
   [-ClearSupersededSoftwareUpdate]
   [-Description <String>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemoveSoftwareUpdate <IResultObject[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMSoftwareUpdateGroup
   [-AddSoftwareUpdate <IResultObject[]>]
   [-ClearExpiredSoftwareUpdate]
   [-ClearSoftwareUpdate]
   [-ClearSupersededSoftwareUpdate]
   [-Description <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveSoftwareUpdate <IResultObject[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-CMSoftwareUpdateGroup altera o nome ou a descrição de um ou mais grupos de atualização de software do Configuration Manager, ou adiciona ou remove grupos de atualização de software para um ou mais escopos de segurança.

Um grupo de atualização de software é uma coleção de uma ou mais atualizações de software. Você pode adicionar atualizações de software a um grupo de atualização de software e, em seguida, implantar o grupo em clientes. Depois de implantar um grupo de atualização de software, você pode adicionar novas atualizações de software ao grupo e o Configuration Manager as implanta automaticamente.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Adicionar um grupo de atualização de software a um escopo de segurança

PS XYZ:\> Set-CMSoftwareUpdateGroup -SecurityScopeAction AddMembership -SecurityScopeName "ScopeNameD02" -Name "SUGroup01"

Este comando adiciona um grupo de atualização de software chamado SUGroup01 como membro do escopo de segurança chamado ScopeNameD02.

Exemplo 2: Remover um grupo de atualização de software de um escopo de segurança

PS XYZ:\> Set-CMSoftwareUpdateGroup -SecurityScopeAction RemoveMembership -SecurityScopeName "ScopeNameD17" -Name "SUGroup01"

Este comando remove o grupo de atualização de software chamado SUGroup01 da associação no escopo de segurança chamado ScopeNameD17.

Parâmetros

-AddSoftwareUpdate

Type:IResultObject[]
Aliases:AddSoftwareUpdates
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ClearExpiredSoftwareUpdate

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

-ClearSoftwareUpdate

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

-ClearSupersedSoftwareUpdate

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Especifica uma descrição para um grupo de atualização de software.

Type:String
Aliases:LocalizedDescription
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

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

-Id

Especifica uma matriz de IDs de grupos de atualização de software.

Type:Int32
Aliases:CIId, CI_ID
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifica um objeto de grupo de software. Para obter um objeto de grupo de software, use o cmdlet Get-CMSoftwareUpdateGroup.

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

-Name

Especifica uma matriz de nomes de grupos de atualização de software.

Type:String
Aliases:LocalizedDisplayName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-NewName

Especifica um nome para um grupo de atualização de software. Esse nome substitui o nome atual do grupo.

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

-PassThru

Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

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

-RemoveSoftwareUpdate

Type:IResultObject[]
Aliases:RemoveSoftwareUpdates
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object