Get-WsusComputer
적용 대상: Windows 10, Windows Server Technical Preview
Get-WsusComputer
Gets the WSUS computer object that represents the client computer.
구문
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>]
자세한 설명
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.
매개 변수
-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.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-ComputerTargetGroups<StringCollection>
Specifies the list of target group to search.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-ComputerUpdateStatus<WsusUpdateInstallationState>
Specifies the computer update state as represented in the WSUS Console user interface. 이 매개 변수에 허용되는 값은 다음과 같습니다.
-- FailedOrNeeded
-- InstalledNotApplicableOrNoStatus
-- Failed
-- InstalledNotApplicable
-- NoStatus
-- Any
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-ExcludedInstallationStates<UpdateInstallationStates[]>
Specifies the installation states to exclude. 이 매개 변수에 허용되는 값은 다음과 같습니다.
-- All
-- Downloaded
-- Failed
-- Installed
-- InstalledPendingReboot
-- NotApplicable
-- NotInstalled
-- Unknown
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-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.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-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.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-IncludeDownstreamComputerTargets
Specifies that clients of a downstream server should be included, not clients of this server.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-IncludeSubgroups
Specifies that the ComputerTargetGroups parameter should include descendant groups. This value has no impact if the ComputerTargetGroups parameter is not used.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-IncludedInstallationStates<UpdateInstallationStates[]>
Specifies the installation states to include. 이 매개 변수에 허용되는 값은 다음과 같습니다.
-- All
-- Downloaded
-- Failed
-- Installed
-- InstalledPendingReboot
-- NotApplicable
-- NotInstalled
-- Unknown
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-InformationAction<System.Management.Automation.ActionPreference>
Specifies how this cmdlet responds to an information event. 이 매개 변수에 허용되는 값은 다음과 같습니다.
-- Continue
-- Ignore
-- Inquire
-- SilentlyContinue
-- Stop
-- Suspend
별칭 |
infa |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-InformationVariable<System.String>
Specifies an information variable.
별칭 |
iv |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-NameIncludes<String>
Specifies the partial name of the computer for which to search.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-RequestedTargetGroupNames<StringCollection>
Specifies the list of requested target group names for which to search.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-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.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-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.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
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.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
True (ByValue) |
와일드카드 문자 허용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 TechNet의 about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216)
입력
입력 형식은 cmdlet으로 파이프할 수 있는 개체의 형식입니다.
- Microsoft.UpdateServices.Commands.IUpdateServer
출력
출력 형식은 cmdlet 실행 시 출력되는 개체의 형식입니다.
- None
예
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