Gets the hotfixes that have been applied to the local and remote computers.
Syntax
 Copy Code |
|
|---|---|
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 command supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, OutBuffer, OutVariable, WarningAction, and WarningVariable. 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 http://go.microsoft.com/fwlink/?LinkID=145071.
The output of this cmdlet might be different on different operating systems.
Example 1
| Copy Code |
|
|---|---|
C:\PS>get-hotfix |
|
Description
-----------
This command gets all hotfixes on the local computer.
Example 2
| Copy Code |
|
|---|---|
C:\PS>get-hotfix -description Security* -computername Server01, Server02 -cred Server01\admin01 |
|
Description
-----------
This command gets all hotfixes on the Server01 and Server02 computers that have a description that begins with "Security".
Example 3
| Copy Code |
|
|---|---|
C:\PS>$a = get-content servers.txt
C:\PS> $a | foreach { if (!(get-hotfix -id KB957095 -computername $_)) { add-content $_ -path Missing-kb953631.txt }}
|
|
Description
-----------
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
| Copy Code |
|
|---|---|
C:\PS>(get-hotfix | sort installedon)[-1] |
|
Description
-----------
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.