Get-HotFix

ローカル コンピューターまたはリモート コンピューターにインストールされている修正プログラムを取得します。

構文

Get-HotFix
   [[-Id] <String[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-HotFix
   [-Description <String[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

説明

このコマンドレットは、Windows プラットフォームでのみ使用できます。

このコマンドレットは Get-HotfixWin32_QuickFixEngineering WMI クラスを使用して、ローカル コンピューターまたは指定されたリモート コンピューターにインストールされている修正プログラムを一覧表示します。

例 1: ローカル コンピューター上のすべての修正プログラムを取得する

コマンドレットは Get-Hotfix 、ローカル コンピューターにインストールされているすべての修正プログラムを取得します。

Get-HotFix

Source         Description      HotFixID      InstalledBy          InstalledOn
------         -----------      --------      -----------          -----------
Server01       Update           KB4495590     NT AUTHORITY\SYSTEM  5/16/2019 00:00:00
Server01       Security Update  KB4470788     NT AUTHORITY\SYSTEM  1/22/2019 00:00:00
Server01       Update           KB4480056     NT AUTHORITY\SYSTEM  1/24/2019 00:00:00

例 2: 文字列でフィルター処理された複数のコンピューターから修正プログラムを取得する

このコマンドでは Get-Hotfix 、パラメーターを使用して、リモート コンピューターにインストールされている修正プログラムを取得します。 結果は、指定された説明文字列でフィルター処理されます。

Get-HotFix -Description Security* -ComputerName Server01, Server02 -Credential Domain01\admin01

Get-Hotfixでは、Description パラメーターと、アスタリスク (*) ワイルドカードを含む文字列 Security を使用して出力がフィルター処理されます。 ComputerName パラメーターには、リモート コンピューター名のコンマ区切り文字列が含まれています。 Credential パラメーターは、リモート コンピューターにアクセスしてコマンドを実行するアクセス許可を持つユーザー アカウントを指定します。

例 3: 更新プログラムがインストールされているかどうかを確認し、コンピューター名をファイルに書き込む

この例のコマンドは、特定の更新プログラムがインストールされているかどうかを確認します。 更新プログラムがインストールされていない場合、コンピューター名はテキスト ファイルに書き込まれます。

$A = Get-Content -Path ./Servers.txt
$A | ForEach-Object { if (!(Get-HotFix -Id KB957095 -ComputerName $_))
    { Add-Content $_ -Path ./Missing-KB957095.txt }}

この $A 変数には、テキスト ファイルから取得した Get-Content コンピューター名が含まれています。 内の $A オブジェクトは、パイプライン ForEach-Objectの下に送信されます。 ステートメントではifGet-HotfixId パラメーターと各コンピューター名の特定の ID 番号を持つコマンドレットを使用します。 指定した修正プログラム ID がコンピューターにインストールされていない場合、 Add-Content コマンドレットはコンピューター名をファイルに書き込みます。

例 4: ローカル コンピューターで最新の修正プログラムを取得する

この例では、コンピューターにインストールされている最新の修正プログラムを取得します。

(Get-HotFix | Sort-Object -Property InstalledOn)[-1]

Get-Hotfix は、オブジェクトをパイプラインからコマンドレットに Sort-Object 送信します。 Sort-Objectはオブジェクトを昇順で並べ替え、Property パラメーターを使用して各 InstalledOn 日付を評価します。 配列表記 [-1] では、最新のインストール済み修正プログラムが選択されます。

パラメーター

-ComputerName

リモート コンピューターを指定します。 NetBIOS 名、インターネット プロトコル (IP) アドレス、またはリモート コンピューターの完全修飾 doメイン 名 (FQDN) を入力します。

ComputerName パラメーターが指定されていない場合は、Get-Hotfixローカル コンピューターで実行されます。

ComputerName パラメーターは、Windows PowerShell リモート処理に依存しません。 リモート コマンドを実行するようにコンピューターが構成されていない場合は、ComputerName パラメーターを使用します。

Type:String[]
Aliases:CN, __Server, IPAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

コンピューターにアクセスしてコマンドを実行するアクセス許可を持つユーザー アカウントを指定します。 既定値は現在のユーザーです

User01 や Doメイン01\User01 などのユーザー名を入力するか、コマンドレットによって生成された PSCredential オブジェクトをGet-Credential入力します。 ユーザー名を入力すると、パスワードの入力を求められます。

資格情報は PSCredential オブジェクトに格納され、パスワードは SecureString として格納されます。

Note

SecureString データ保護の詳細については、「SecureString のセキュリティ保護方法」を参照してください

Type:PSCredential
Position:Named
Default value:Current user
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Get-HotFixでは、Description パラメーターを使用して修正プログラムの種類を指定します。 ワイルドカードを使用できます。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Id

特定の Get-HotFix 修正プログラム ID の結果をフィルター処理します。 ワイルドカードは受け入れられません。

Type:String[]
Aliases:HFID
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

String

コンピューター名を含む文字列をこのコマンドレットにパイプできます。

出力

ManagementObject

このコマンドレットは、コンピューター上の修正プログラムを表すオブジェクトを返します。

メモ

このコマンドレットは、Windows プラットフォームでのみ使用できます。

Win32_QuickFixEngineeringWMI クラス、現在のオペレーティング システムに適用される、システム全体の小規模な更新プログラム (一般にクイック修正エンジニアリング (QFE) 更新プログラムと呼ばれます) を表します。 このクラスは、コンポーネント ベースのサービス (CBS) によって提供される更新プログラムのみを返します。 これらの更新プログラムはレジストリに一覧表示されません。 更新 Microsoft Windows インストーラー (MSI) またはWindows Update サイトは、Win32_QuickFixEngineeringによって返されません。 詳細については、クラスWin32_QuickFixEngineering参照してください

出力は Get-HotFix 、オペレーティング システムによって異なる場合があります。