Set-CMSoftwareUpdateGroup

在 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

CMSoftwareUpdateGroup 指令程式會變更一或多個 Configuration Manager 軟體更新群組的名稱或描述,或新增或移除一或多個安全性範圍的軟體更新群組。

軟體更新群組是一或多個軟體更新的集合。 您可以將軟體更新新增至軟體更新群組,然後將群組部署至用戶端。 在您部署軟體更新群組之後,您可以將新的軟體更新新增至群組,而 Configuration Manager 會自動加以部署。

注意

從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\> 。 如需詳細資訊,請參閱 快速入門。

範例

範例1:將軟體更新群組新增至安全性範圍

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

這個命令會將名為 SUGroup01 的軟體更新組新增為名為 ScopeNameD02 之安全性範圍的成員。

範例2:從安全性範圍移除軟體更新群組

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

此命令會從名為 ScopeNameD17 的安全性範圍內,從成員資格中移除名為 SUGroup01 的軟體更新群組。

參數

-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

-ClearSupersededSoftwareUpdate

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

-Confirm

執行 Cmdlet 之前提示您確認。

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

-Description

指定軟體更新群組的描述。

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

-DisableWildcardHandling

此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。

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

-ForceWildcardHandling

這個參數會處理萬用字元,而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。

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

-InputObject

指定軟體群組物件。 若要取得軟體群組物件,請使用 CMSoftwareUpdateGroup Cmdlet。

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

-NewName

指定軟體更新群組的名稱。 此名稱會取代目前的群組名稱。

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

-PassThru

新增此參數可傳回代表您正在使用之專案的物件。 根據預設,此 Cmdlet 可能不會產生任何輸出。

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

顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。

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

-名稱

指定軟體更新群組的名稱陣列。

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

-識別碼

指定軟體更新群組的 IDs 陣列。

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

輸入

ConfigurationManagement IResultObject

輸出

系統.物件