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

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.

Voorbeelden

Voorbeeld 1: Alle hotfixes ophalen op de lokale computer

De Get-Hotfix cmdlet haalt alle hotfixes op 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 die zijn gefilterd op een tekenreeks

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

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

Get-Hotfixfiltert de uitvoer met de parameter Description en de tekenreeksbeveiliging die het sterretje (*) bevat. De parameter ComputerName bevat een door komma's gescheiden tekenreeks met namen van externe computers. Met de parameter Referentie geeft u 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.

$A = Get-Content -Path ./Servers.txt
$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 een tekstbestand. De objecten in $A worden naar de pijplijn verzonden.ForEach-Object Een if instructie maakt gebruik van de Get-Hotfix cmdlet met de id-parameter 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 Sort-Object cmdlet. Sort-Object sorteert objecten oplopende volgorde en gebruikt de parameter Eigenschap om elke InstalledOn-datum te evalueren. De matrix-notatie [-1] selecteert de meest recente 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 deze 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. 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 SecureString.

Notitie

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

Type:PSCredential
Position:Named
Default value:Current user
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 tekenreeks met een computernaam doorsluisen naar deze cmdlet.

Uitvoerwaarden

ManagementObject

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

Notities

Deze cmdlet is alleen beschikbaar op Windows-platforms.

De Win32_QuickFixEngineering WMI-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 klasse voor meer informatie.

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