Partager via


Get-HotFix

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

Syntaxe

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 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 à partir de plusieurs ordinateurs filtrés par une chaîne

La Get-Hotfix commande utilise des paramètres pour obtenir les correctifs logiciels installés sur des 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’ordinateur distants. Le paramètre Credential spécifie un compte d’utilisateur 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 à Get-Content partir d’un fichier texte. Les objets dans $A utilisant le pipeline ForEach-Objectsont envoyés vers . Une if instruction utilise l’applet Get-Hotfix de 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 Sort-Object de 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 s’appuie pas sur la communication à distance Windows PowerShell. Si votre ordinateur n’est pas configuré pour exécuter des commandes distantes, utilisez le paramètre ComputerName .

Type:String[]
Alias:CN, __Server, IPAddress
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Credential

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

Tapez un nom d’utilisateur, tel que User01 ou Domain01\User01, ou entrez un objet PSCredential généré par l’applet Get-Credential de 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.

Remarque

Pour plus d’informations sur la protection des données SecureString , consultez Comment secure is SecureString ?.

Type:PSCredential
Position:Named
Valeur par défaut:Current user
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-Id

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

Type:String[]
Alias:HFID
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 WMI Win32_QuickFixEngineering représente une petite mise à jour à l’échelle du système, communément appelée mise à jour d’ingénierie de 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. Les mises à jour fournies par Microsoft Windows Installer (MSI) ou le site Windows Update ne sont pas retournées par Win32_QuickFixEngineering. Pour plus d’informations, consultez Win32_QuickFixEngineering classe.

La Get-HotFix sortie peut varier sur différents systèmes d’exploitation.