Share via


Get-HotFix

Hiermee haalt u de hotfixes op die zijn geïnstalleerd op lokale of externe computers.

Syntax

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

Description

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De Get-Hotfix cmdlet haalt hotfixes of updates op die zijn geïnstalleerd op de lokale computer of opgegeven externe computers. De updates kunnen worden geïnstalleerd door Windows Update, Microsoft Update, Windows Server Update Services of handmatig.

Voorbeelden

Voorbeeld 1: Alle hotfixes op de lokale computer ophalen

Met de Get-Hotfix cmdlet worden alle hotfixes opgehaald die op de lokale computer zijn geïnstalleerd.

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

Voorbeeld 2: hotfixes ophalen van meerdere computers gefilterd op een tekenreeks

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

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

Get-Hotfix filtert de uitvoer met de parameter Description en de tekenreeks Beveiliging die het jokerteken 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 is gemachtigd voor toegang tot de externe computers en het uitvoeren van opdrachten.

Voorbeeld 3: controleren of een update is geïnstalleerd en computernamen naar een bestand schrijven

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

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

De $A variabele bevat computernamen die zijn verkregen door Get-Content uit een tekstbestand. De objecten in $A worden door de pijplijn verzonden naar ForEach-Object. 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.

Voorbeeld 4: de meest recente hotfix op de lokale computer ophalen

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

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

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

Parameters

-ComputerName

Hiermee geeft u een externe computer. Typ de NetBIOS-naam, een IP-adres (Internet Protocol) of een FQDN (Fully Qualified Domain Name) van een externe computer.

Wanneer de parameter ComputerName niet is opgegeven, Get-Hotfix wordt uitgevoerd op de lokale computer.

De parameter ComputerName is niet afhankelijk van Windows PowerShell externe communicatie. Als uw computer niet is geconfigureerd voor het uitvoeren van externe opdrachten, gebruikt u de parameter ComputerName .

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

-Credential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is voor toegang tot de computer en het uitvoeren van opdrachten. De standaardwaarde is de huidige gebruiker

Typ een gebruikersnaam, zoals User01 of Domain01\User01, of voer een PSCredential-object in dat is gegenereerd door de Get-Credential cmdlet. Als u een gebruikersnaam typt, wordt u gevraagd het wachtwoord in te voeren.

Referenties worden opgeslagen in een PSCredential-object en het wachtwoord wordt opgeslagen als een SecureString.

Notitie

Zie Hoe veilig is SecureString? voor meer informatie over SecureString-gegevensbeveiliging.

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

-Description

Get-HotFix gebruikt de parameter Description om hotfixtypen op te geven. Jokertekens zijn toegestaan.

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

-Id

Filtert de Get-HotFix resultaten voor specifieke hotfix-id's. Jokertekens worden niet geaccepteerd.

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

Invoerwaarden

String

U kunt een of meer computernamen doorsnijden naar Get-HotFix.

Uitvoerwaarden

ManagementObject

Get-HotFix retourneert objecten die de hotfixes op de computer vertegenwoordigen.

Notities

Deze cmdlet is alleen beschikbaar op Windows-platforms.

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

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