Get-WsusComputer

Betrifft: Windows 10, Windows Server Technical Preview

Get-WsusComputer

Gets the WSUS computer object that represents the client computer.

Syntax

Parameter Set: AllComputers
Get-WsusComputer [-All] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-UpdateServer <IUpdateServer> ] [ <CommonParameters>]

Parameter Set: Scoped
Get-WsusComputer [-ComputerTargetGroups <StringCollection> ] [-ComputerUpdateStatus <WsusUpdateInstallationState> {Any | Failed | FailedOrNeeded | InstalledOrNotApplicable | InstalledOrNotApplicableOrNoStatus | Needed | NoStatus} ] [-ExcludedInstallationStates <UpdateInstallationStates[]> ] [-FromLastReportedStatusTime <DateTime> ] [-FromLastSyncTime <DateTime> ] [-IncludedInstallationStates <UpdateInstallationStates[]> ] [-IncludeDownstreamComputerTargets] [-IncludeSubgroups] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-NameIncludes <String> ] [-RequestedTargetGroupNames <StringCollection> ] [-ToLastReportedStatusTime <DateTime> ] [-ToLastSyncTime <DateTime> ] [-UpdateServer <IUpdateServer> ] [ <CommonParameters>]

Detaillierte Beschreibung

The Get-WsusComputer cmdlet gets one or more Windows Server Update Services (WSUS) 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 passed into this cmdlet, then the specified server will be used rather than the local server.

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

Parameter

-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<StringCollection>

Specifies the list of target group to search.

-ComputerUpdateStatus<WsusUpdateInstallationState>

Specifies the computer update state as represented in the WSUS Console user interface. Die zulässigen Werte für diesen Parameter sind:

-- FailedOrNeeded
-- InstalledNotApplicableOrNoStatus
-- Failed
-- InstalledNotApplicable
-- NoStatus
-- Any

-ExcludedInstallationStates<UpdateInstallationStates[]>

Specifies the installation states to exclude. Die zulässigen Werte für diesen Parameter sind:

-- All
-- Downloaded
-- Failed
-- Installed
-- InstalledPendingReboot
-- NotApplicable
-- NotInstalled
-- Unknown

-FromLastReportedStatusTime<DateTime>

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<DateTime>

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<UpdateInstallationStates[]>

Specifies the installation states to include. Die zulässigen Werte für diesen Parameter sind:

-- All
-- Downloaded
-- Failed
-- Installed
-- InstalledPendingReboot
-- NotApplicable
-- NotInstalled
-- Unknown

-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

-InformationVariable<System.String>

Specifies an information variable.

-NameIncludes<String>

Specifies the partial name of the computer for which to search.

-RequestedTargetGroupNames<StringCollection>

Specifies the list of requested target group names for which to search.

-ToLastReportedStatusTime<DateTime>

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<DateTime>

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<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.

<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.

• Microsoft.UpdateServices.Commands.IUpdateServer

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

• None

Beispiele

Example 1: Get all client computers

This command gets all client computers.

PS C:\> Get-WsusComputer -All

Example 2: Get client computers that have names that contain a string

This command gets the client computer whose name includes contoso.

PS C:\> Get-WsusComputer -NameIncludes "contoso"

Example 3: Get client computers by specifying dates

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

PS C:\> Get-WsusComputer -FromLastReportedStatusTime 6/1/10 -ToLastReportedStatusTime 6/30/10

Verwandte Themen

Add-WsusComputer

Get-WsusServer