Get-WsusUpdate
S'applique à: Windows 10, Windows Server Technical Preview
Get-WsusUpdate
Gets the WSUS update object with details about the update.
Syntaxe
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>]
Description détaillée
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.
Paramètres
-Approval<WsusApprovedState>
Specifies the approved state of the one or more updates to be returned. Les valeurs acceptables pour ce paramètre sont les suivantes :
-- Unapproved
-- Declined
-- Approved
-- AnyExceptDeclined
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Classification<WsusUpdateClassifications>
Specifies the classification of updates for which you want to get updates. Les valeurs acceptables pour ce paramètre sont les suivantes :
-- All
-- Critical
-- Security
-- WSUS
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-InformationAction<System.Management.Automation.ActionPreference>
Specifies how this cmdlet responds to an information event. Les valeurs acceptables pour ce paramètre sont les suivantes :
-- Continue
-- Ignore
-- Inquire
-- SilentlyContinue
-- Stop
-- Suspend
Alias |
infa |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-InformationVariable<System.String>
Specifies an information variable.
Alias |
iv |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-RevisionNumber<Int32>
Specifies the revision number of a specific revision of an update. To specify the latest revision, set to zero.
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
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. Les valeurs acceptables pour ce paramètre sont les suivantes :
-- Needed
-- FailedOrNeeded
-- InstalledNotApplicableOrNoStatus
-- Failed
-- InstalledNotApplicable
-- NoStatus
-- Any
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-UpdateId<Guid>
Specifies the update by its GUID. The GUID uniquely identifies the Group Policy Object (GPO).
Alias |
none |
Requis ? |
true |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
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.
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
true (ByValue) |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez . about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entrées
Le type d'entrée correspond au type des objets que vous pouvez adresser à l'applet de commande.
- None
Sorties
Le type de sortie correspond au type des objets que l'applet de commande émet.
- Microsoft.UpdateServices.Commands.WsusUpdate
Exemples
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