PowerShell Logo Small

Get-WsusComputer



This is the built-in help made by Microsoft for the command 'Get-WsusComputer', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Gets the Windows Server Update Services (WSUS) computer object that represents the client computer.

SYNTAX


Get-WsusComputer [-All] [-UpdateServer <IUpdateServer>] [<CommonParameters>]
Get-WsusComputer [-ComputerTargetGroups <StringCollection>] [-ComputerUpdateStatus {Any | Failed | FailedOrNeeded | InstalledOrNotApplicable |
InstalledOrNotApplicableOrNoStatus | Needed | NoStatus}] [-ExcludedInstallationStates <UpdateInstallationStates[]>] [-FromLastReportedStatusTime <DateTime>]
[-FromLastSyncTime <DateTime>] [-IncludedInstallationStates <UpdateInstallationStates[]>] [-IncludeDownstreamComputerTargets] [-IncludeSubgroups] [-NameIncludes <String>]
[-RequestedTargetGroupNames <StringCollection>] [-ToLastReportedStatusTime <DateTime>] [-ToLastSyncTime <DateTime>] [-UpdateServer <IUpdateServer>] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Get-WsusComputer cmdlet retrieves one or more computers based on the specified filtering criteria such as operating system, computer name, update installation status,
last reported status time, and etcetera.


If the Get-WsusServer cmdlet is run and the resulting IUpdateServer object is piped into this cmdlet, then the specified server will be used rather than the local server.


This cmdlet can be piped into the Add-WsusComputer cmdlet.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=789388
Add-WsusComputer
Get-WsusServer

REMARKS

<

Examples


EXAMPLE 1

PS C:\> Get-WsusComputer -All
Computer IP Address Operating System Last Status Report
-------- ---------- ---------------- ------------------
contoso XXXX:XXXX:XX:X:XXXX:XXX:XXXX: Windows Server 2008 6/2/2010 12:00:00 AM
XXXX Enterprise Edition (full
installation)



This example gets all client computers.






EXAMPLE 2

PS C:\> Get-WsusComputer -NameIncludes contoso
Computer IP Address Operating System Last Status Report
-------- ---------- ---------------- ------------------
contoso XXXX:XXXX:XX:X:XXXX:XXX:XXXX: Windows Server 2008 6/2/2010 12:00:00 AM
XXXX Enterprise Edition (full
installation)



This example gets the client computer whose name includes contoso.






EXAMPLE 3

PS C:\> Get-WsusComputer -FromLastReportedStatusTime 6/1/10 -ToLastReportedStatusTime 6/30/10
Computer IP Address Operating System Last Status Report
-------- ---------- ---------------- ------------------
contoso XXXX:XXXX:XX:X:XXXX:XXX:XXXX: Windows Server 2008 6/2/2010 12:00:00 AM
XXXX Enterprise Edition (full
installation)



This example gets all client computers with a last reported status date and time between June 1, 2010 and June 30, 2010.