Get-WsusUpdate

업데이트 날짜: 2013년 10월

적용 대상: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

Get-WsusUpdate

Gets the Windows Server Update Services (WSUS) update object with details about the update.

구문

Parameter Set: ID
Get-WsusUpdate -UpdateId <Guid> [-RevisionNumber <Int32> ] [-UpdateServer <IUpdateServer> ] [ <CommonParameters>]

Parameter Set: Scoped
Get-WsusUpdate [-Approval <WsusApprovedState> ] [-Classification <WsusUpdateClassifications> ] [-Status <WsusUpdateInstallationState> ] [-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 will return 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 will be 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

-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 piping the resulting IUpdateServer object into this cmdlet.

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216).

입력

입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.

• None

출력

출력 유형은 cmdlet이 내보내는 개체의 유형입니다.

• Microsoft.UpdateServices.Commands.WsusUpdate

  WsusUpdate

예제

EXAMPLE 1

This example gets allunapproved updates with a status of failed or needed.

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

EXAMPLE 2

This example gets allcriticalunapproved updates.

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

관련 항목

Approve-WsusServer

Deny-WsusServer

Get-WsusServer