Gets the hotfixes that have been applied to the local and remote computers.

Syntax

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

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

Description

The Get-Hotfix cmdlet gets the hotfixes that have been applied to the local computer or to remote computers by Component-Based Servicing.

Parameters

-ComputerName <string[]>

Specifies a remote computer. The default is the local computer.

Type the NetBIOS name, an Internet Protocol (IP) address, or a fully qualified domain name of a remote computer.

This parameter does not rely on Windows PowerShell remoting. You can use the ComputerName parameter of Get-Hotfix even if your computer is not configured to run remote commands.

Required?

false

Position?

named

Default Value

Local computer

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-Credential <PSCredential>

Specifies a user account that has permission to perform this action. The default is the current user.

Type a user name, such as "User01" or "Domain01\User01", or enter a PSCredential object, such as one generated by the Get-Credential cmdlet. If you type a user name, you will be prompted for a password.

Required?

false

Position?

named

Default Value

Current user

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Description <string[]>

Gets only hotfixes with the specified descriptions. Wildcards are permitted. The default is all hotfixes on the computer.

Required?

false

Position?

named

Default Value

All hotfixes

Accept Pipeline Input?

false

Accept Wildcard Characters?

true

-Id <string[]>

Gets only hotfixes with the specified hotfix IDs. The default is all hotfixes on the computer.

Required?

false

Position?

1

Default Value

All hotfixes

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs and Outputs

The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet returns.

Inputs

None

You cannot pipe input to Get-HotFix.

Outputs

System.Management.ManagementObject#root\CIMV2\Win32_QuickFixEngineering

Get-Hotfix returns objects that represent the hotfixes on the computer.

Notes

This cmdlet uses the Win32_QuickFixEngineering WMI class, which represents small system-wide updates of the operating system. Starting with Windows Vista, this class returns only the updates supplied by Component Based Servicing (CBS). It does not include updates that are supplied by Microsoft Windows Installer (MSI) or the Windows update site. For more information, see the Win32_QuickFixEngineering class topic in the Microsoft .NET Framework SDK at https://go.microsoft.com/fwlink/?LinkID=145071.

The output of this cmdlet might be different on different operating systems.

Example 1

C:\PS>get-hotfix

This command gets all hotfixes on the local computer.






Example 2

C:\PS>get-hotfix -description Security* -computername Server01, Server02 -cred Server01\admin01

This command gets all hotfixes on the Server01 and Server02 computers that have a description that begins with "Security".






Example 3

C:\PS>$a = get-content servers.txt

C:\PS> $a | foreach { if (!(get-hotfix -id KB957095 -computername $_)) { add-content $_ -path Missing-kb953631.txt }}

The commands in this example create a text file listing the names of computers that are missing a security update.

The commands use the Get-Hotfix cmdlet to get the KB957095 security update on all of the computers whose names are listed in the Servers.txt file.

If a computer does not have the update, the Add-Content cmdlet writes the computer name in the Missing-KB953631.txt file.






Example 4

C:\PS>(get-hotfix | sort installedon)[-1]

This command gets the most recent hotfix on the computer. 

It gets the hotfixes, sorts them by the value of the InstalledOn property, and then it uses array notation to select the last item in the array.






See Also




Table Of Contents