Compartilhar via


Set-CMSoftwareUpdateGroup

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

Sintaxe

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 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 âmbitos de segurança.

Um grupo de atualizações de software é uma coleção de uma ou mais atualizações de software. Pode adicionar atualizações de software a um grupo de atualização de software e, em seguida, implementar o grupo em clientes. Depois de implementar um grupo de atualização de software, pode adicionar novas atualizações de software ao grupo e o Configuration Manager implementa-as automaticamente.

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: Adicionar um grupo de atualização de software a um âmbito de segurança

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

Este comando adiciona um grupo de atualização de software denominado SUGroup01 como membro do âmbito de segurança denominado ScopeNameD02.

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

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

Este comando remove o grupo de atualização de software denominado SUGroup01 da associação no âmbito de segurança denominado ScopeNameD17.

Parâmetros

-AddSoftwareUpdate

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

-ClearExpiredSoftwareUpdate

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

-ClearSoftwareUpdate

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

-ClearSupersededSoftwareUpdate

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

-Confirm

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

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

-Description

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

Tipo:String
Aliases:LocalizedDescription
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

-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

-Id

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

Tipo:Int32
Aliases:CIId, CI_ID
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

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

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

-Name

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

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

-NewName

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

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

-PassThru

Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

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

-RemoveSoftwareUpdate

Tipo:IResultObject[]
Aliases:RemoveSoftwareUpdates
Cargo:Named
Valor padrão:None
Obrigatório:False
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:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object