Compartilhar via

Get-HotFix

Módulo:
Microsoft.PowerShell.Management Module

Obtém os hotfixes instalados em computadores locais ou remotos.

Sintaxe

Default (Default) 

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

Description 

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

Description

O cmdlet Get-Hotfix obtém hotfixes ou atualizações instaladas no computador local ou em computadores remotos especificados. As atualizações podem ser instaladas pelo Windows Update, Microsoft Update, Windows Server Update Services ou instaladas manualmente.

Exemplos

Exemplo 1: Obter todos os hotfixes no computador local

O cmdlet Get-Hotfix obtém todos os hotfixes instalados no computador 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

Exemplo 2: Obter hotfixes de vários computadores filtrados por uma cadeia de caracteres

O comando Get-Hotfix usa parâmetros para instalar hotfixes em computadores remotos. Os resultados são filtrados por uma cadeia de caracteres de descrição especificada.

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

Get-Hotfix filtra a saída com o parâmetro Description e a cadeia de caracteres de segurança que inclui o curinga asterisco (*). O parâmetro ComputerName inclui uma cadeia de caracteres separada por vírgulas de nomes de computador remoto. O parâmetro Credential especifica uma conta de usuário que tem permissão para acessar os computadores remotos e executar comandos.

Exemplo 3: verificar se uma atualização está instalada e gravar nomes de computador em um arquivo

Os comandos neste exemplo verificam se uma atualização específica foi instalada. Se a atualização não estiver instalada, o nome do computador será gravado em um arquivo 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 }}

A variável $A contém nomes de computador obtidos por Get-Content de um arquivo de texto. Os objetos em $A são enviados pelo pipeline para ForEach-Object. Uma instrução usa o cmdlet com o parâmetro de ID de e um número de ID específico para cada nome de computador. Se um computador não tiver a ID de hotfix especificada instalada, o cmdlet Add-Content gravará o nome do computador em um arquivo.

Exemplo 4: Obter o hotfix mais recente no computador local

Este exemplo obtém o hotfix mais recente instalado em um computador.

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

Get-Hotfix envia os objetos pelo pipeline para o cmdlet Sort-Object. Sort-Object classifica objetos por ordem crescente e usa o parâmetro Property para avaliar cada data InstalledOn. A notação de matriz [-1] seleciona o hotfix instalado mais recente.

Parâmetros

-ComputerName

Especifica um computador remoto. Digite o nome NetBIOS, um endereço IP (protocolo IP) ou um FQDN (nome de domínio totalmente qualificado) de um computador remoto.

Quando o parâmetro ComputerName não for especificado, Get-Hotfix será executado no computador local.

O parâmetro ComputerName não depende da comunicação remota do Windows PowerShell. Se o computador não estiver configurado para executar comandos remotos, use o parâmetro ComputerName.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:China, __Servidor, Endereço IP

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Credential

Especifica uma conta de usuário que tem permissão para acessar o computador e executar comandos. Digite um nome de usuário, como User01, Domain01\User01ou insira um objeto PSCredential , gerado pelo cmdlet . Se você digitar um nome de usuário, será solicitado que você solicite uma senha.

Quando o parâmetro credencial não é especificado, usa o usuário atual.

Propriedades do parâmetro

Tipo:PSCredential
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Description

Get-HotFix usa o parâmetro Description para especificar tipos de hotfix. Caracteres curinga são permitidos.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

Description
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Id

Filtra os resultados do Get-HotFix para IDs de hotfix específicas. Curingas não são aceitos.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:HFID

Conjuntos de parâmetros

Default
Cargo:0
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Você pode canalizar um ou mais nomes de computador para Get-HotFix.

Saídas

ManagementObject

Get-HotFix retorna objetos que representam os hotfixes no computador.

Observações

A classe WMI Win32_QuickFixEngineering representa uma pequena atualização em todo o sistema, comumente conhecida como uma atualização de QFE (engenharia de correção rápida), aplicada ao sistema operacional atual. Essa classe retorna apenas as atualizações fornecidas pela CBS (Manutenção Baseada em Componente). Essas atualizações não estão listadas no registro. As atualizações fornecidas pelo Microsoft Windows Installer (MSI) ou pelo site de do Windows Update não são retornadas por Win32_QuickFixEngineering. Para obter mais informações, consulte Win32_QuickFixEngineering classe.

A saída Get-HotFix pode variar em sistemas operacionais diferentes.