Get-WsusUpdate

적용 대상: Windows 10, Windows Server Technical Preview

Get-WsusUpdate

Gets the WSUS update object with details about the update.

구문

Parameter Set: ID
Get-WsusUpdate -UpdateId <Guid> [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-RevisionNumber <Int32> ] [-UpdateServer <IUpdateServer> ] [ <CommonParameters>]

Parameter Set: Scoped
Get-WsusUpdate [-Approval <WsusApprovedState> {Approved | Unapproved | AnyExceptDeclined | Declined} ] [-Classification <WsusUpdateClassifications> {All | Critical | Security | WSUS} ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-Status <WsusUpdateInstallationState> {NoStatus | InstalledOrNotApplicable | InstalledOrNotApplicableOrNoStatus | Failed | Needed | FailedOrNeeded | Any} ] [-UpdateServer <IUpdateServer> ] [ <CommonParameters>]

자세한 설명

The Get-WsusUpdate cmdlet gets the Windows Server Update Services (WSUS) update object with details about the update. This cmdlet requires the update unique identifier (GUID) or a set of filter criteria such as classification, approval and status as parameter.

The Get-WsusUpdate cmdlet can be called in two ways:

-- Passing in the Update ID (GUID) and RevisionNumber. This cmdlet returns a single update matching the specified Update ID and revision number.
-- Passing in filter parameters. These parameters include Classification, Approval, and Status. One or more updates matching the specified criteria are returned.

매개 변수

-Approval<WsusApprovedState>

Specifies the approved state of the one or more updates to be returned. 이 매개 변수에 허용되는 값은 다음과 같습니다.

-- Unapproved
-- Declined
-- Approved
-- AnyExceptDeclined

-Classification<WsusUpdateClassifications>

Specifies the classification of updates for which you want to get updates. 이 매개 변수에 허용되는 값은 다음과 같습니다.

-- All
-- Critical
-- Security
-- WSUS

-InformationAction<System.Management.Automation.ActionPreference>

Specifies how this cmdlet responds to an information event. 이 매개 변수에 허용되는 값은 다음과 같습니다.

-- Continue
-- Ignore
-- Inquire
-- SilentlyContinue
-- Stop
-- Suspend

-InformationVariable<System.String>

Specifies an information variable.

-RevisionNumber<Int32>

Specifies the revision number of a specific revision of an update. To specify the latest revision, set to zero.

-Status<WsusUpdateInstallationState>

Specifies the installation status for which to search. An update will be included only if it has at least one computer with the specified status. 이 매개 변수에 허용되는 값은 다음과 같습니다.

-- Needed
-- FailedOrNeeded
-- InstalledNotApplicableOrNoStatus
-- Failed
-- InstalledNotApplicable
-- NoStatus
-- Any

-UpdateId<Guid>

Specifies the update by its GUID. The GUID uniquely identifies the Group Policy Object (GPO).

-UpdateServer<IUpdateServer>

Specifies the object that contains the WSUS server. This value is obtained by calling the Get-WsusServer cmdlet and passing the resulting IUpdateServer object into this cmdlet.

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 TechNet의 about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216)

입력

입력 형식은 cmdlet으로 파이프할 수 있는 개체의 형식입니다.

• None

출력

출력 형식은 cmdlet 실행 시 출력되는 개체의 형식입니다.

• Microsoft.UpdateServices.Commands.WsusUpdate

예

Example 1: Get updates by status

This command gets all unapproved updates with a status of failed or needed.

PS C:\> Get-WsusUpdate -Classification All -Approval Unapproved -Status FailedOrNeeded

Example 2: Get critical unapproved updates

This command gets all critical unapproved updates.

PS C:\> Get-WsusUpdate -Classification Critical -Approval Unapproved -Status Any

관련 항목

Approve-WsusUpdate

Deny-WsusUpdate

Get-WsusServer