Gets the WSUS computer object that represents the client computer.
PowerShell · Risk: Low · Documentation Verified
Last verified: 2026-10-26
Microsoft UpdateServices reference: Gets the WSUS computer object that represents the client computer. The syntax and selected example below are adapted from the pinned Windows Server 2025 reference. Module availability, target configuration and delegated permissions determine whether it can run in your environment. Documentation and parameter text: Microsoft, CC BY 4.0; formatting adapted by Cmdlet World. No execution testing is claimed.
Use an account with the target resource permissions documented for Get-WsusComputer. Modifying administrative cmdlets may require elevation or delegated administration. This catalog does not assert that ordinary users can execute the command.
Supported environments
Windows / UpdateServices · Windows Server 2025 documentation; feature/module prerequisites apply
Parameters
-All
Specifies that all computers are to be returned. The information displayed includes the computer name, IP address, operating system, and last status report time.
-ComputerTargetGroups
Specifies the list of target group to search.
-ComputerUpdateStatus
Specifies the computer update state as represented in the WSUS Console user interface. The acceptable values for this parameter are: - FailedOrNeeded - InstalledNotApplicableOrNoStatus - Failed - InstalledNotApplicable - NoStatus - Any
-ExcludedInstallationStates
Specifies the installation states to exclude. The acceptable values for this parameter are: - All - Downloaded - Failed - Installed - InstalledPendingReboot - NotApplicable - NotInstalled - Unknown
-FromLastReportedStatusTime
Specifies the earliest reported status time. This parameter can be used in combination with the _ToLastReportedStatusTime_ parameter in order to create a date range to use in the search.
-FromLastSyncTime
Specifies the earliest last synchronization time for which to search. This parameter can be used in combination with the _ToLastSynchTime_ parameter in order to create a date range to use in the search.
-IncludeDownstreamComputerTargets
Specifies that clients of a downstream server should be included, not clients of this server.
-IncludeSubgroups
Specifies that the _ComputerTargetGroups_ parameter should include descendant groups. This value has no impact if the _ComputerTargetGroups_ parameter is not used.
-IncludedInstallationStates
Specifies the installation states to include. The acceptable values for this parameter are: - All - Downloaded - Failed - Installed - InstalledPendingReboot - NotApplicable - NotInstalled - Unknown
-NameIncludes
Specifies the partial name of the computer for which to search.
-RequestedTargetGroupNames
Specifies the list of requested target group names for which to search.
-ToLastReportedStatusTime
Specifies the latest reported status time. This parameter can be used in combination with the _FromLastReportedStatusTime_ parameter in order to create a date range to use in the search.
-ToLastSyncTime
Specifies the latest last synchronization time for which to search. This parameter can be used in combination with the _FromLastSynchTime_ parameter in order to create a date range to use in the search.
-UpdateServer
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.
Prerequisites
Windows with the UpdateServices module and the Windows feature or management tools that provide it. Confirm target connectivity and version compatibility using the linked Microsoft reference.
Security considerations
This is a read-oriented cmdlet; protect any sensitive results and check the documented effects of your selected parameters.
Examples
Example 1: Get all client computers
Get-WsusComputer -All
This command gets all client computers. Source: Microsoft, CC BY 4.0; transcript prompt/output removed. This example was not executed.