Partager via


Get-HotFix

Obtient les correctifs logiciels installés sur les ordinateurs locaux ou distants.

Syntax

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

Description

Cette applet de commande est disponible uniquement sur la plateforme Windows.

L’applet Get-Hotfix de commande utilise la classe WMI Win32_QuickFixEngineering pour répertorier les correctifs logiciels installés sur l’ordinateur local ou sur les ordinateurs distants spécifiés.

Exemples

Exemple 1 : Obtenir tous les correctifs logiciels sur l’ordinateur local

L’applet Get-Hotfix de commande obtient tous les correctifs logiciels installés sur l’ordinateur local.

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

Exemple 2 : Obtenir des correctifs logiciels de plusieurs ordinateurs filtrés par une chaîne

La Get-Hotfix commande utilise des paramètres pour obtenir l’installation des correctifs logiciels sur les ordinateurs distants. Les résultats sont filtrés par une chaîne de description spécifiée.

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

Get-Hotfix filtre la sortie avec le paramètre Description et la chaîne Security qui inclut le caractère générique astérisque (*). Le paramètre ComputerName inclut une chaîne séparée par des virgules de noms d’ordinateurs distants. Le paramètre Credential spécifie un compte d’utilisateur qui est autorisé à accéder aux ordinateurs distants et à exécuter des commandes.

Exemple 3 : vérifier si une mise à jour est installée et écrire des noms d’ordinateurs dans un fichier

Les commandes de cet exemple vérifient si une mise à jour particulière est installée. Si la mise à jour n’est pas installée, le nom de l’ordinateur est écrit dans un fichier texte.

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

La $A variable contient des noms d’ordinateurs obtenus par Get-Content à partir d’un fichier texte. Les objets dans $A sont envoyés vers le bas du pipeline vers ForEach-Object. Une if instruction utilise l’applet de Get-Hotfix commande avec le paramètre Id et un numéro d’ID spécifique pour chaque nom d’ordinateur. Si l’ID de correctif logiciel spécifié n’est pas installé sur un ordinateur, l’applet Add-Content de commande écrit le nom de l’ordinateur dans un fichier.

Exemple 4 : Obtenir le correctif logiciel le plus récent sur l’ordinateur local

Cet exemple obtient le correctif logiciel le plus récent installé sur un ordinateur.

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

Get-Hotfix envoie les objets vers le bas du pipeline à l’applet de Sort-Object commande . Sort-Object trie les objets par ordre croissant et utilise le paramètre Property pour évaluer chaque date InstalledOn . La notation [-1] de tableau sélectionne le correctif logiciel installé le plus récent.

Paramètres

-ComputerName

Spécifie un ordinateur distant. Tapez le nom NetBIOS, une adresse IP (Internet Protocol) ou un nom de domaine complet (FQDN) d’un ordinateur distant.

Lorsque le paramètre ComputerName n’est pas spécifié, Get-Hotfix s’exécute sur l’ordinateur local.

Le paramètre ComputerName ne repose pas sur Windows PowerShell communication à distance. Si votre ordinateur n’est pas configuré pour exécuter des commandes à distance, utilisez le paramètre ComputerName .

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

-Credential

Spécifie un compte d’utilisateur qui a l’autorisation d’accéder à l’ordinateur et d’exécuter des commandes. La valeur par défaut est l’utilisateur actuel

Tapez un nom d’utilisateur, par exemple User01 ou Domain01\User01, ou entrez un objet PSCredential généré par l’applet de Get-Credential commande. Si vous tapez un nom d’utilisateur, vous êtes invité à entrer le mot de passe.

Les informations d’identification sont stockées dans un objet PSCredential et le mot de passe est stocké en tant que SecureString.

Notes

Pour plus d’informations sur la protection des données SecureString , consultez Comment SecureString est-il sécurisé ?.

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

-Description

Get-HotFix utilise le paramètre Description pour spécifier les types de correctifs logiciels. Les caractères génériques sont autorisés.

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

-Id

Filtre les Get-HotFix résultats pour les ID de correctif logiciel spécifiques. Les caractères génériques ne sont pas acceptés.

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

Entrées

String

Vous pouvez diriger une chaîne contenant un nom d’ordinateur vers cette applet de commande.

Sorties

ManagementObject

Cette applet de commande retourne des objets représentant les correctifs logiciels sur l’ordinateur.

Notes

Cette applet de commande est disponible uniquement sur les plateformes Windows.

La classe WMIWin32_QuickFixEngineering représente une petite mise à jour à l’échelle du système, communément appelée mise à jour de l’ingénierie à correctif rapide (QFE), appliquée au système d’exploitation actuel. Cette classe retourne uniquement les mises à jour fournies par la maintenance basée sur les composants (CBS). Ces mises à jour ne sont pas répertoriées dans le Registre. Mises à jour fournis par Microsoft Windows Installer (MSI) ou le site Windows Update ne sont pas retournés par Win32_QuickFixEngineering. Pour plus d’informations, consultez Win32_QuickFixEngineering classe.

La Get-HotFix sortie peut varier selon les systèmes d’exploitation.