Partager via

Get-HotFix

Module:
Microsoft.PowerShell.Management Module

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

Syntaxe

Default (Par défaut) 

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

DESCRIPTION 

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

Description

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

L’applet de commande Get-HotFix 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 de commande Get-HotFix 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 commande Get-HotFix utilise des paramètres pour installer des correctifs logiciels 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

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 variable $A contient des noms d’ordinateurs obtenus par Get-Content à partir d’un fichier texte. Les objets de $A sont envoyés vers le bas du pipeline vers ForEach-Object. Une instruction utilise l’applet de commande avec le paramètre id de 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 de commande Add-Content é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 commande Sort-Object. trie les objets par ordre croissant et utilise le paramètre Property pour évaluer chaque date de InstalledOn. La notation de tableau [-1] 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.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:CN, __Serveur, adresse IP

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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 de commande Get-Credential. 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 de SecureString, consultez Quelle est la sécurité de SecureString ?.

Propriétés du paramètre

Type:PSCredential
Valeur par défaut:Current user
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False

Jeux de paramètres

Description
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Id

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

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:HFID

Jeux de paramètres

Default
Position:0
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

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 Win32_QuickFixEngineeringclasse WMI représente une petite mise à jour à l’échelle du système, communément appelée mise à jour d’ingénierie 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 sortie Get-HotFix peut varier sur différents systèmes d’exploitation.