powershellscripts.com

Tutorials  PowerShell Cmdlet Help for Get-HotFix



NAME
Get-HotFix

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

SYNTAX
Get-HotFix [[-Id] ] [-ComputerName ] [-Credential ] []

Get-HotFix [-Description ] [-ComputerName ] [-Credential ] []


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


PARAMETERS
-ComputerName
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-Hotf
ix 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
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
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
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


This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

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 ope
rating system. Starting with Windows Vista, this class returns only the updates supplied by Component Based Ser
vicing (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 Framewo
rk SDK at http://go.microsoft.com/fwlink/?LinkID=145071.

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


-------------------------- EXAMPLE 1 --------------------------

C:\PS>get-hotfix


Description
-----------
This command gets all hotfixes on the local computer.





-------------------------- EXAMPLE 2 --------------------------

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 "Sec
urity".





-------------------------- 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
}}


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 --------------------------

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 selec
t the last item in the array.






RELATED LINKS
Online version: http://go.microsoft.com/fwlink/?LinkID=135217
Get-ComputerRestorePoint