Get-WsusComputer

업데이트 날짜: 2013년 10월

적용 대상: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

Get-WsusComputer

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

구문

Parameter Set: AllComputers
Get-WsusComputer [-All] [-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] [-NameIncludes <String> ] [-RequestedTargetGroupNames <StringCollection> ] [-ToLastReportedStatusTime <DateTime> ] [-ToLastSyncTime <DateTime> ] [-UpdateServer <IUpdateServer> ] [ <CommonParameters>]

자세한 설명

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.

매개 변수

-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. 이 매개 변수에 허용되는 값은 다음과 같습니다.
-- FailedOrNeeded
-- InstalledNotApplicableOrNoStatus
-- Failed
-- InstalledNotApplicable
-- NoStatus
-- Any

-ExcludedInstallationStates<UpdateInstallationStates[]>

Specifies the installation states to exclude. 이 매개 변수에 허용되는 값은 다음과 같습니다.
-- 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. 이 매개 변수에 허용되는 값은 다음과 같습니다.
-- All
-- Downloaded
-- Failed
-- Installed
-- InstalledPendingReboot
-- NotApplicable
-- NotInstalled
-- Unknown

-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 piping the resulting IUpdateServer object into this cmdlet.

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216).

입력

입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.

• Microsoft.UpdateServices.Commands.IUpdateServer

  IUpdateServer

출력

출력 유형은 cmdlet이 내보내는 개체의 유형입니다.

• None

예제

EXAMPLE 1

This example gets all client computers.

PS C:\> Get-WsusComputer -All

EXAMPLE 2

This example gets the client computer whose name includes contoso.

PS C:\> Get-WsusComputer -NameIncludes contoso

EXAMPLE 3

This example 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

관련 항목

Add-WsusComputer

Get-WsusServer