Sdílet prostřednictvím

Get-HotFix

Modul:
Microsoft.PowerShell.Management Module

Získá opravy hotfix, které jsou nainstalovány v místních nebo vzdálených počítačích.

Syntax

Default (Výchozí) 

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

DESCRIPTION 

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

Description

Tato rutina je dostupná jenom na platformě Windows.

Rutina Get-Hotfix získá opravy hotfix nebo aktualizace, které jsou nainstalovány v místním počítači nebo určené vzdálené počítače. Aktualizace mohou být nainstalovány službou Windows Update, Microsoft Update, službou Windows Server Update Services nebo ručně.

Příklady

Příklad 1: Získání všech oprav hotfix na místním počítači

Rutina Get-Hotfix získá všechny opravy hotfix nainstalované v místním počítači.

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

Příklad 2: Získání oprav hotfix z více počítačů filtrovaných podle řetězce

Příkaz Get-Hotfix používá parametry k získání oprav hotfix nainstalovaných na vzdálených počítačích. Výsledky jsou filtrovány podle zadaného řetězce popisu.

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

filtruje výstup pomocí parametru popis a řetězce Security, který obsahuje zástupný znak hvězdičky (). Parametr ComputerName obsahuje řetězec oddělený čárkami s názvy vzdálených počítačů. Parametr přihlašovacích údajů určuje uživatelský účet, který má oprávnění pro přístup ke vzdáleným počítačům a spouštění příkazů.

Příklad 3: Ověření, jestli je nainstalovaná aktualizace, a zápis názvů počítačů do souboru

Příkazy v tomto příkladu ověřují, jestli byla nainstalována konkrétní aktualizace. Pokud aktualizace není nainstalovaná, název počítače se zapíše do textového souboru.

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

Proměnná $A obsahuje názvy počítačů získané Get-Content z textového souboru. Objekty v $A se odesílají do kanálu ForEach-Object. Příkaz if používá rutinu Get-Hotfix s parametrem ID a konkrétním číslem ID pro každý název počítače. Pokud počítač nemá nainstalované zadané ID opravy hotfix, rutina Add-Content zapíše název počítače do souboru.

Příklad 4: Získání nejnovější opravy hotfix v místním počítači

Tento příklad získá nejnovější opravu hotfix nainstalovanou v počítači.

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

Get-Hotfix odešle objekty dolů kanálu do rutiny Sort-Object. seřadí objekty vzestupně a pomocí parametru vlastnost vyhodnotí každý InstalledOn date. Zápis pole [-1] vybere nejnovější nainstalovanou opravu hotfix.

Parametry

-ComputerName

Určuje vzdálený počítač. Zadejte název NetBIOS, IP adresu (Internet Protocol) nebo plně kvalifikovaný název domény (FQDN) vzdáleného počítače.

Pokud není zadaný parametr ComputerName, Get-Hotfix běží na místním počítači.

Parametr ComputerName nespoléhá na vzdálené komunikace Windows PowerShellu. Pokud váš počítač není nakonfigurovaný tak, aby spouštět vzdálené příkazy, použijte parametr ComputerName.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Čína, __Server, IP adresa

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Credential

Určuje uživatelský účet, který má oprávnění pro přístup k počítači a spouštění příkazů. Výchozí hodnota je aktuální uživatel.

Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte objekt PSCredential vygenerovaný rutinou Get-Credential. Pokud zadáte uživatelské jméno, zobrazí se výzva k zadání hesla.

Přihlašovací údaje jsou uloženy v objektu PSCredential a heslo je uloženo jako SecureString.

Poznámka:

Další informace o ochraně dat SecureString najdete v tématu Jak zabezpečený je SecureString?.

Vlastnosti parametru

Typ:PSCredential
Default value:Current user
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Description

Get-HotFix k určení typů oprav hotfix používá parametr Popis. Jsou povoleny zástupné symboly.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

Description
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Id

Filtruje výsledky Get-HotFix pro konkrétní ID oprav hotfix. Zástupné cardy nejsou přijaty.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:HFID

Sady parametrů

Default
Position:0
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

Jeden nebo více názvů počítačů můžete generovat na Get-HotFix.

Výstupy

ManagementObject

Get-HotFix vrátí objekty, které představují opravy hotfix v počítači.

Poznámky

Tento cmdlet je dostupný pouze na platformách Windows.

Win32_QuickFixEngineeringtřídy rozhraní WMI představuje malou aktualizaci pro celý systém, která se běžně označuje jako aktualizace QFE (Quick-Fix Engineering) použitá v aktuálním operačním systému. Tato třída vrací pouze aktualizace poskytované službou CBS (Component Based Servicing). Tyto aktualizace nejsou uvedené v registru. Aktualizace poskytované instalační službou systému Microsoft Windows (MSI) nebo webem Windows Update se nevrácejí Win32_QuickFixEngineering. Další informace najdete v tématu Win32_QuickFixEngineering třídy.

Výstup Get-HotFix se může lišit v různých operačních systémech.