Compartir a través de

Get-HotFix

Módulo:
Microsoft.PowerShell.Management Module

Obtiene las revisiones instaladas en equipos locales o remotos.

Sintaxis

Default (valor predeterminado) 

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

Description 

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

Description

El cmdlet Get-Hotfix obtiene revisiones o actualizaciones que se instalan en el equipo local o en equipos remotos especificados. Windows Update, Microsoft Update, Windows Server Update Services o manualmente pueden instalar las actualizaciones.

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.

PS> 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.

PS> $A = Get-Content -Path ./Servers.txt
PS> $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. 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.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:CN, __Servidor, dirección IP

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Credential

Especifica una cuenta de usuario que tiene permiso para acceder al equipo y ejecutar comandos. Escriba un nombre de usuario, como User01, Domain01\User01o escriba un objeto PSCredential generado por el cmdlet Get-Credential. Si escribe un nombre de usuario, se le pedirá una contraseña.

Cuando no se especifica el parámetro credential , usa el usuario actual.

Propiedades de parámetro

Tipo:PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Description

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

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

Description
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Id

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

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:HFID

Conjuntos de parámetros

Default
Posición:0
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

String

Puede canalizar uno o varios nombres de equipo a Get-HotFix.

Salidas

ManagementObject

Get-HotFix devuelve objetos que representan las revisiones del equipo.

Notas

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 se devuelven mediante Win32_QuickFixEngineering. Para obtener más información, vea Win32_QuickFixEngineering clase.

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