Get-HotFix
Obtient les correctifs logiciels qui ont été appliqués aux ordinateurs locaux et distants.
Syntaxe
Get-HotFix [[-Id] <string[]>] [-ComputerName <string[]>] [-Credential <PSCredential>] [<CommonParameters>]
Get-HotFix [-Description <string[]>] [-ComputerName <string[]>] [-Credential <PSCredential>] [<CommonParameters>]
Description
L'applet de commande Get-Hotfix obtient les correctifs logiciels qui ont été appliqués à l'ordinateur local ou aux ordinateurs distants par les services à base de composants.
Paramètres
-ComputerName <string[]>
Spécifie un ordinateur distant. La valeur par défaut est l'ordinateur local.
Tapez le nom NetBIOS, une adresse IP ou le nom de domaine complet d'un ordinateur distant.
Ce paramètre ne s'appuie pas sur la communication à distance Windows PowerShell. Vous pouvez utiliser le paramètre ComputerName de Get-Hotfix même si votre ordinateur n'est pas configuré pour exécuter des commandes distantes.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
Local computer |
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Credential <PSCredential>
Spécifie un compte d'utilisateur qui a l'autorisation d'exécuter cette action. 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, tel que celui généré par l'applet de commande Get-Credential. Si vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
Current user |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Description <string[]>
Obtient uniquement les correctifs logiciels ayant les descriptions spécifiées. Les caractères génériques sont autorisés. La valeur par défaut est tous les correctifs logiciels présents sur l'ordinateur.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
All hotfixes |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
true |
-Id <string[]>
Obtient uniquement les correctifs logiciels portant les ID de correctif logiciel spécifiés. La valeur par défaut est tous les correctifs logiciels présents sur l'ordinateur.
Obligatoire ? |
false |
Position ? |
1 |
Valeur par défaut |
All hotfixes |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
Entrées |
None Vous ne pouvez pas diriger d'entrée vers Get-HotFix. |
Sorties |
System.Management.ManagementObject#root\CIMV2\Win32_QuickFixEngineering Get-Hotfix retourne des objets qui représentent les correctifs logiciels sur l'ordinateur. |
Remarques
Cette applet de commande utilise la classe WMI de Win32_QuickFixEngineering, qui représente des petites mises à jour à l'échelle du système d'exploitation. En commençant par Windows Vista, cette classe retourne uniquement les mises à jour fournies par les services à base de composants (CBS, Component Based Servicing). Elle n'inclut pas les mises à jour fournies par Microsoft Windows Installer (MSI) ou le site de mise à jour Windows. Pour plus d'informations, consultez la rubrique sur la classe Win32_QuickFixEngineering (page éventuellement en anglais) dans le Kit de développement Microsoft .NET Framework SDK à l'adresse https://go.microsoft.com/fwlink/?LinkID=145071.
La sortie de cette applet de commande peut être différente sur d'autres systèmes d'exploitation.
Exemple 1
C:\PS>get-hotfix
Description
-----------
Cette commande obtient tous les correctifs logiciels présents sur l'ordinateur local.
Exemple 2
C:\PS>get-hotfix -description Security* -computername Server01, Server02 -cred Server01\admin01
Description
-----------
Cette commande obtient tous les correctifs logiciels présents sur les ordinateurs Server01 et Server02 dont la description commence par « Sécurité ».
Exemple 3
C:\PS>$a = get-content servers.txt
C:\PS> $a | foreach { if (!(get-hotfix -id KB957095 -computername $_)) { add-content $_ -path Missing-kb953631.txt }}
Description
-----------
Dans cet exemple, les commandes créent un fichier texte qui répertorie le nom des ordinateurs pour lesquels une mise à jour de sécurité est manquante.
Ces commandes utilisent l'applet de commande Get-Hotfix pour obtenir la mise à jour de sécurité KB957095 sur tous les ordinateurs dont le nom est répertorié dans le fichier Servers.txt.
Lorsqu'une mise à jour est manquante sur un ordinateur, l'applet de commande Add-Content inscrit le nom de cet ordinateur dans le fichier Missing-KB953631.txt.
Exemple 4
C:\PS>(get-hotfix | sort installedon)[-1]
Description
-----------
Cette commande obtient le correctif logiciel le plus récent présent sur l'ordinateur.
Elle obtient les correctifs logiciels, les trie en fonction de la valeur de la propriété InstalledOn et utilise la notation de tableau pour sélectionner le dernier élément du tableau.