Get-WsusUpdate
Betrifft: Windows 10, Windows Server Technical Preview
Get-WsusUpdate
Gets the WSUS update object with details about the update.
Syntax
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>]
Detaillierte Beschreibung
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.
Parameter
-Approval<WsusApprovedState>
Specifies the approved state of the one or more updates to be returned. Die zulässigen Werte für diesen Parameter sind:
-- Unapproved
-- Declined
-- Approved
-- AnyExceptDeclined
Aliase |
none |
Erforderlich? |
false |
Position? |
named |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-Classification<WsusUpdateClassifications>
Specifies the classification of updates for which you want to get updates. Die zulässigen Werte für diesen Parameter sind:
-- All
-- Critical
-- Security
-- WSUS
Aliase |
none |
Erforderlich? |
false |
Position? |
named |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-InformationAction<System.Management.Automation.ActionPreference>
Specifies how this cmdlet responds to an information event. Die zulässigen Werte für diesen Parameter sind:
-- Continue
-- Ignore
-- Inquire
-- SilentlyContinue
-- Stop
-- Suspend
Aliase |
infa |
Erforderlich? |
false |
Position? |
named |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-InformationVariable<System.String>
Specifies an information variable.
Aliase |
iv |
Erforderlich? |
false |
Position? |
named |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-RevisionNumber<Int32>
Specifies the revision number of a specific revision of an update. To specify the latest revision, set to zero.
Aliase |
none |
Erforderlich? |
false |
Position? |
named |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-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. Die zulässigen Werte für diesen Parameter sind:
-- Needed
-- FailedOrNeeded
-- InstalledNotApplicableOrNoStatus
-- Failed
-- InstalledNotApplicable
-- NoStatus
-- Any
Aliase |
none |
Erforderlich? |
false |
Position? |
named |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-UpdateId<Guid>
Specifies the update by its GUID. The GUID uniquely identifies the Group Policy Object (GPO).
Aliase |
none |
Erforderlich? |
true |
Position? |
named |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-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.
Aliase |
none |
Erforderlich? |
false |
Position? |
named |
Standardwert |
none |
Pipelineeingaben akzeptieren? |
true (ByValue) |
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Eingaben
Der Eingabetyp ist der Typ der Objekte, die Sie per Piping an das Cmdlet übergeben können.
- None
Ausgaben
Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.
- Microsoft.UpdateServices.Commands.WsusUpdate
Beispiele
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