Compartir a través de

Get-HotFix

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Obtiene las revisiones instaladas en equipos locales o remotos.

Sintaxis

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

Description

Este cmdlet solo está disponible en la plataforma Windows.

El cmdlet Get-HotFix usa la clase WMI de Win32_QuickFixEngineering para enumerar las revisiones instaladas en el equipo local o en los equipos remotos especificados.

Ejemplos

Ejemplo 1: Obtención de todas las revisiones en el equipo local

El cmdlet Get-HotFix obtiene todas las revisiones instaladas en el equipo 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

Ejemplo 2: Obtención de revisiones de varios equipos filtrados por una cadena

El comando Get-HotFix usa parámetros para obtener revisiones instaladas en equipos remotos. Los resultados se filtran mediante una cadena de descripción especificada.

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

Get-HotFix filtra la salida con el parámetro Description y la cadena Security que incluye el comodín asterisco (*). El parámetro ComputerName incluye una cadena separada por comas de nombres de equipos remotos. El parámetro credential especifica una cuenta de usuario que tiene permiso para acceder a los equipos remotos y ejecutar comandos.

Ejemplo 3: Comprobar si hay instalada una actualización y escribir nombres de equipo en un archivo

Los comandos de este ejemplo comprueban si hay instalada una actualización determinada. Si la actualización no está instalada, el nombre del equipo se escribe en un archivo de texto.

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

La variable $A contiene nombres de equipo obtenidos por Get-Content de un archivo de texto. Los objetos de $A se envían por la canalización a ForEach-Object. Una instrucción if usa el cmdlet Get-HotFix con el parámetro id. de y un número de identificador específico para cada nombre de equipo. Si un equipo no tiene instalado el identificador de revisión especificado, el cmdlet Add-Content escribe el nombre de equipo en un archivo.

Ejemplo 4: Obtención de la revisión más reciente en el equipo local

En este ejemplo se obtiene la revisión más reciente instalada en un equipo.

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

Get-HotFix envía los objetos de la canalización al cmdlet Sort-Object. Sort-Object ordena los objetos por orden ascendente y usa el parámetro Property para evaluar cada fecha de InstalledOn. La notación de matriz [-1] selecciona la revisión instalada más reciente.

Parámetros

-ComputerName

Especifica un equipo remoto. Escriba el nombre NetBIOS, una dirección ip (Protocolo de Internet) o un nombre de dominio completo (FQDN) de un equipo remoto.

Cuando no se especifica el parámetro ComputerName, Get-HotFix se ejecuta en el equipo local.

El parámetro ComputerName no depende de la comunicación remota de Windows PowerShell. Si el equipo no está configurado para ejecutar comandos remotos, use el parámetro ComputerName.

Tipo:String[]
Alias:CN, __Server, IPAddress
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Credential

Especifica una cuenta de usuario que tiene permiso para acceder al equipo y ejecutar comandos. El valor predeterminado es el usuario actual.

Escriba un nombre de usuario, como User01 o Domain01\User01, o escriba un objeto de PSCredential generado por el cmdlet Get-Credential. Si escribe un nombre de usuario, se le pedirá que escriba la contraseña.

Las credenciales se almacenan en un objeto de PSCredential de y la contraseña se almacena como SecureString.

Nota

Para obtener más información sobre Protección de datos de secureString, consulte ¿Cómo es secureString?.

Tipo:PSCredential
Posición:Named
Valor predeterminado:Current user
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Description

Get-HotFix usa el parámetro Description para especificar los tipos de revisión. Se permiten caracteres comodín.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-Id

Filtra los resultados del Get-HotFix para identificadores de revisión específicos. No se aceptan caracteres comodín.

Tipo:String[]
Alias:HFID
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Puede canalizar una cadena que contenga un nombre de equipo a este cmdlet.

Salidas

ManagementObject

Este cmdlet devuelve objetos que representan las revisiones del equipo.

Notas

Este cmdlet solo está disponible en plataformas Windows.

La Win32_QuickFixEngineeringclase WMI representa una pequeña actualización de todo el sistema, comúnmente denominada actualización de ingeniería de corrección rápida (QFE), aplicada al sistema operativo actual. Esta clase devuelve solo las actualizaciones proporcionadas por el mantenimiento basado en componentes (CBS). Estas actualizaciones no aparecen en el Registro. Las actualizaciones proporcionadas por Microsoft Windows Installer (MSI) o el sitio de windows Update no devuelven Win32_QuickFixEngineering. Para obtener más información, vea Win32_QuickFixEngineering clase.

El Get-HotFix salida puede variar en diferentes sistemas operativos.