Delen via

Get-HotFix

  • Referentie
Module:
Microsoft.PowerShell.Management

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

Syntaxis

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

Description

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 worden geïnstalleerd.

Voorbeelden

Voorbeeld 1: Alle hotfixes ophalen op de lokale computer

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

Voorbeeld 2: Hotfixes ophalen van meerdere computers die zijn gefilterd op een tekenreeks

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

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

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.

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

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.

PS> $A = Get-Content -Path ./Servers.txt
PS> $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.

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

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.

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, wordt Get-Hotfix uitgevoerd op de lokale computer.

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

Type:String[]
Aliassen:CN, __Server, IPAddress
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Credential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om toegang te krijgen tot de computer en opdrachten uit te voeren. Typ een gebruikersnaam, zoals User01, Domain01\User01of voer een PSCredential--object in dat is gegenereerd door de Get-Credential-cmdlet. Als u een gebruikersnaam typt, wordt u gevraagd om een wachtwoord.

Wanneer de parameter Credential niet is opgegeven, gebruikt Get-Hotfix de huidige gebruiker.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Description

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

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-Id

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

Type:String[]
Aliassen:HFID
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

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

Uitvoerwaarden

ManagementObject

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

Notities

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.