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 Get-Hotfix cmdlet usa la clase WMI de Win32_QuickFixEngineering para enumerar las revisiones instaladas en el equipo local o en equipos remotos especificados.

Ejemplos

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

El Get-Hotfix cmdlet 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 Get-Hotfix comando 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 carácter comodín asterisco (*). El parámetro ComputerName incluye una cadena separada por comas de nombres de equipo remoto. 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 $A variable contiene nombres de equipo obtenidos por Get-Content de un archivo de texto. Los objetos de $A se envían a la canalización a ForEach-Object. Una if instrucción usa el Get-Hotfix cmdlet con el parámetro Id 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 Add-Content cmdlet escribe el nombre del 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 Sort-Object cmdlet . Sort-Object ordena los objetos por orden ascendente y usa el parámetro Property para evaluar cada fecha InstalledOn . La notación de [-1] matriz 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 se basa en 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 PSCredential generado por el Get-Credential cmdlet . Si escribe un nombre de usuario, se le pedirá que escriba la contraseña.

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

Nota:

Para obtener más información sobre la protección de datos SecureString , consulte ¿Cómo es secure is 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 los 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 Get-HotFix resultados de 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 clase WMI de Win32_QuickFixEngineering 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, consulte Win32_QuickFixEngineering clase.

La Get-HotFix salida puede variar en distintos sistemas operativos.