Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Approve-WsusUpdate

Approve-WsusUpdate

microsoft.updateservices.commands.dll

Synopsis

Approves an update to be applied to clients.

Syntax

Approve-WsusUpdate [-Action] [-TargetGroupName] [-Update] [-Confirm] [-WhatIf] [<CommonParameters>]

Detailed Description

The Approve-WsusUpdate cmdlet is used to approve an update to be applied to clients. This operation requires Server Update Services (WSUS) Administrator privileges.

To use this cmdlet, run the Get-WsusUpdate cmdlet and pipe the resulting WsusUpdate object into this cmdlet.

Parameters

-Action <UpdateApprovalAction>

Specifies the action that clients should perform when applying the associated update. The acceptable values for this parameter are:  -- Install -- Not Approved -- Uninstall

Aliases

None

Required?

true

Position

named

Default value

None

Accept pipeline input?

false

Accept wildcard characters?

false

-TargetGroupName <String>

Specifies the name of the computer target group for which to run this cmdlet.

Aliases

None

Required?

true

Position

named

Default value

None

Accept pipeline input?

false

Accept wildcard characters?

false

-Update <WsusUpdate>

Specifies the object that contains the server of the update to be approved or denied as well as the update to be approved or denied. This value is obtained by running the Get-WsusUpdate cmdlet and piping the resulting WsusUpdate object into this cmdlet.

Aliases

None

Required?

true

Position

named

Default value

None

Accept pipeline input?

true (ByValue)

Accept wildcard characters?

false

-Confirm <SwitchParameter>

Prompts you for confirmation before running the cmdlet.

Aliases

None

Required?

false

Position

named

Default value

false

Accept pipeline input?

false

Accept wildcard characters?

false

-WhatIf <SwitchParameter>

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Aliases

None

Required?

false

Position

named

Default value

false

Accept pipeline input?

false

Accept wildcard characters?

false

Input Type

Microsoft UpdateServices.Commands.WsusUpdate

Return Type


Notes

None

Examples

EXAMPLE 1

This example approves for installation all unapproved updates with a status of failed or needed.

PS C:\> Get-WsusUpdate -Classification All -Approval Unapproved -Status FailedOrNeeded | Approve-WsusUpdate -Action Install -TargetGroupName "All Computers"

Online Version
Get-WsusUpdate