Get-HotFix

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

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

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De Get-HotFix cmdlet gebruikt de Win32_QuickFixEngineering WMI-klasse om hotfixes weer te geven die zijn geïnstalleerd op de lokale computer of opgegeven externe computers.

Met de Get-HotFix-cmdlet worden alle hotfixes geïnstalleerd op de lokale computer.

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

De opdracht Get-HotFix maakt gebruik van parameters om hotfixes op externe computers op te halen. De resultaten worden gefilterd op een opgegeven beschrijvingstekenreeks.

$hotFixParams = @{
    Description = "Security*"
    ComputerName = "Server01, Server02"
    Credential = "Domain01\admin01"
}
Get-HotFix @hotFixParams

filtert de uitvoer met de parameter Description en de tekenreeks Security dat het sterretje () bevat. De parameter ComputerName bevat een door komma's gescheiden tekenreeks met namen van externe computers. De parameter Credential geeft een gebruikersaccount op dat gemachtigd is voor toegang tot de externe computers en opdrachten uit te voeren.

De opdrachten in dit voorbeeld controleren of een bepaalde update is geïnstalleerd. Als de update niet is geïnstalleerd, wordt de computernaam naar een tekstbestand geschreven.

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

De variabele $A bevat computernamen die zijn verkregen door Get-Content uit een tekstbestand. De objecten in $A worden via de pijplijn naar ForEach-Objectverzonden. Een if-instructie maakt gebruik van de Get-HotFix cmdlet met de parameter Id en een specifiek id-nummer voor elke computernaam. Als op een computer de opgegeven hotfix-id niet is geïnstalleerd, schrijft de Add-Content cmdlet de computernaam naar een bestand.

In dit voorbeeld wordt de meest recente hotfix geïnstalleerd op een computer.

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

Get-HotFix verzendt de objecten in de pijplijn naar de cmdlet Sort-Object. Sort-Object objecten sorteert op oplopende volgorde en gebruikt de parameter Eigenschap om elke InstalledOn-datum te evalueren. De matrix-notatie [-1] de meest recente geïnstalleerde hotfix selecteert.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt een tekenreeks met een computernaam doorsluisen naar deze cmdlet.

Met deze cmdlet worden objecten geretourneerd die de hotfixes op de computer vertegenwoordigen.

Deze cmdlet is alleen beschikbaar op Windows-platforms.

De Win32_QuickFixEngineeringWMI-klasse vertegenwoordigt een kleine systeembrede update, ook wel een QFE-update (Quick Fix Engineering) genoemd, die wordt toegepast op het huidige besturingssysteem. Deze klasse retourneert alleen de updates die worden geleverd door CBS (Component Based Servicing). Deze updates worden niet vermeld in het register. Updates die worden geleverd door Microsoft Windows Installer (MSI) of de Windows Update-site worden niet geretourneerd door Win32_QuickFixEngineering. Zie Win32_QuickFixEngineering klassevoor meer informatie.

De Get-HotFix uitvoer kan variëren op verschillende besturingssystemen.