以前、WSUS (Windows Server Update Services) の Windows PowerShell コマンドレット一覧 (https://kogelog.com/2013/12/21/20131221-01/) というブログ エントリを公開しましたが、Windows Server 2012 R2 の情報を元にしていました。
さすがに情報の鮮度がなくなっている状況なので、Windows Server 2019 (バージョン 1809; OS ビルド 17763.1039) で確認した WSUS コマンドレットを日本語の情報として纏めてみました。
※Windows Server 2019 と Windows Server 2016 でコマンドレットの違いは (たぶん) ないです。
このブログ エントリでは、「Get-WsusComputer」コマンドレットのヘルプ情報 (意訳）について記載します (WSUS コマンドレット一覧については、「Windows Server 2019 で利用可能な WSUS の Windows PowerShell コマンドレットについて」を参照)。
Get-WsusComputer コマンドレット (意訳)
名前
Get-WsusComputer
概要
クライアント コンピューターを表す WSUS コンピューター オブジェクトを取得します。
構文
Get-WsusComputer
[-All]
[-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]
[-InformationVariable <System.String>]
[-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]
[-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]
[-InformationVariable <System.String>]
[-NameIncludes <String>]
[-RequestedTargetGroupNames <StringCollection>]
[-ToLastReportedStatusTime <DateTime>]
[-ToLastSyncTime <DateTime>]
[-UpdateServer <IUpdateServer>]
[<CommonParameters>]
説明
Get-WsusComputer コマンドレットは、オペレーティング システム、コンピューター名、更新プログラムのインストール状態、最後に報告された状態時間などの指定されたフィルター条件に基づいて、1 つ以上の Windows Server Update Services (WSUS) コンピューター情報を取得します。
Get-WsusServer コマンドレットが実行され、結果の IUpdateServer オブジェクトがこのコマンドレットに渡される場合、ローカル サーバーではなく指定されたサーバーが使用されます。
このコマンドレットは、Add-WsusComputer コマンドレットに渡すことが可能です。
パラメーター
-All [<SwitchParameter>]
すべてのコンピューターの結果を返す場合に指定します。表示される情報には、コンピューター名、IP アドレス、オペレーティング システム、および最終ステータス レポート時間が含まれます。
| 必須 | false |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-ComputerTargetGroups [<StringCollection>]
検索するターゲット グループのリストを指定します。
| 必須 | false |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-ComputerUpdateStatus [<WsusUpdateInstallationState>]
WSUS コンソールのユーザー インターフェースに表示されるコンピューターの更新状態を指定します。このパラメーターで利用可能な値は、次のとおりです :
- FailedOrNeeded
- InstalledNotApplicableOrNoStatus
- Failed
- InstalledNotApplicable
- NoStatus
- Any
| 必須 | false |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-ExcludedInstallationStates [<UpdateInstallationStates[]>]
除外するインストール状態を指定します。このパラメーターで利用可能な値は、次のとおりです :
- All
- Downloaded
- Failed
- Installed
- InstalledPendingReboot
- NotApplicable
- NotInstalled
- Unknown
| 必須 | false |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-FromLastReportedStatusTime [<DateTime>]
最も早く報告されたステータス時間を指定します。このパラメーターは、検索で使用する日付範囲を作成するために、ToLastReportedStatusTime パラメーターと組み合わせて使用可能です。
| 必須 | false |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-FromLastSyncTime [<DateTime>]
検索する最も早い最後の同期時間を指定します。このパラメーターは、検索で使用する日付範囲を作成するために、ToLastSynchTime パラメーターと組み合わせて使用可能です。
| 必須 | false |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-IncludeDownstreamComputerTargets [<SwitchParameter>]
このサーバーのクライアントではなく、ダウンストリーム サーバーのクライアントを含める場合に指定します。
| 必須 | false |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-IncludeSubgroups [<SwitchParameter>]
ComputerTargetGroups パラメーターに子孫グループを含める場合に指定します。ComputerTargetGroups パラメーターを使用しない場合、この値は影響しません。
| 必須 | false |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-IncludedInstallationStates [<UpdateInstallationStates[]>]
インストール状態を含める場合に指定します。このパラメーターで利用可能な値は、次のとおりです :
- All
- Downloaded
- Failed
- Installed
- InstalledPendingReboot
- NotApplicable
- NotInstalled
- Unknown
| 必須 | false |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-InformationAction [<System.Management.Automation.ActionPreference>]
このコマンドレットが情報イベントに応答する方法を指定します。このパラメーターで利用可能な値は、次のとおりです :
- Continue
- Ignore
- Inquire
- SilentlyContinue
- Stop
- Suspend
| 必須 | false |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-InformationVariable [<System.String>]
情報変数を指定します。
| 必須 | false |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-NameIncludes [<String>]
検索するコンピューターの部分的な名前を指定します。
| 必須 | false |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-RequestedTargetGroupNames [<StringCollection>]
検索する要求されたターゲット グループ名のリストを指定します。
| 必須 | false |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-ToLastReportedStatusTime [<DateTime>]
報告された最新のステータス時間を指定します。このパラメーターは、検索で使用する日付範囲を作成するために、FromLastReportedStatusTime パラメーターと組み合わせて使用可能です。
| 必須 | false |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-ToLastSyncTime [<DateTime>]
検索する最新の最後の同期時間を指定します。このパラメーターは、検索で使用する日付範囲を作成するために、FromLastSynchTime パラメーターと組み合わせて使用可能です。
| 必須 | false |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-UpdateServer [<IUpdateServer>]
WSUS サーバーを含むオブジェクトを指定します。この値は、Get-WsusServer コマンドレットを呼び出し、結果の IUpdateServer オブジェクトをこのコマンドレットに渡すことで取得されます。
| 必須 | false |
|---|---|
| 位置 | named |
| 既定値 | none |
| パイプライン入力を許可する | True (ByValue) |
| ワイルドカード文字を許可する | false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer, PipelineVariable、および OutVariable。詳細については、about_CommonParameters を参照してください。
入力
- Microsoft.UpdateServices.Commands.IUpdateServer
出力
- None
例
例 1 : すべてのクライアント コンピューター情報を取得する
コマンド
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)
コマンドの説明
このコマンドは、すべてのクライアント コンピューター情報を取得します。
例 2 : 文字列を含む名前を持つクライアント コンピューター情報を取得する
コマンド
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)
コマンドの説明
このコマンドは、名前に contoso が含まれるクライアント コンピューター情報を取得します。
例 3 : 指定した日付のクライアント コンピューター情報を取得する
コマンド
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)
コマンドの説明
このコマンドは、2010 年 6 月 1 日から 2010 年 6 月 30 日までの間に最後に報告されたステータス日時を持つすべてのクライアント コンピューター情報を取得します。
関連するリンク
- Add-WsusComputer
- Get-WsusServer
参考
- UpdateServices (Windows 10 and Windows Server 2016 PowerShell)
https://docs.microsoft.com/en-us/powershell/module/updateservices/?view=win10-ps - Get-WsusComputer
https://docs.microsoft.com/en-us/powershell/module/updateservices/Get-WsusComputer?view=win10-ps