Get-HotFix
Obtém os hotfixes instalados em computadores locais ou remotos.
Syntax
Get-HotFix
[[-Id] <String[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-HotFix
[-Description <String[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
Esse cmdlet só está disponível na plataforma Windows.
O Get-Hotfix
cmdlet obtém hotfixes ou atualizações instalados no computador local ou em computadores remotos especificados. As atualizações podem ser instaladas por Windows Update, Microsoft Update, Windows Server Update Services ou instaladas manualmente.
Exemplos
Exemplo 1: Obter todos os hotfixes no computador local
O Get-Hotfix
cmdlet 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 Get-Hotfix
comando 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 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 $A
variável 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 if
instrução usa o Get-Hotfix
cmdlet com o parâmetro Id 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 Add-Content
cmdlet 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 Sort-Object
cmdlet . Sort-Object
classifica objetos por ordem crescente e usa o parâmetro Property para avaliar cada data InstalledOn . A notação de [-1]
matriz 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 é especificado, Get-Hotfix
é executado no computador local.
O parâmetro ComputerName não depende Windows PowerShell comunicação remota. Se o computador não estiver configurado para executar comandos remotos, use o parâmetro ComputerName .
Type: | String[] |
Aliases: | CN, __Server, IPAddress |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Credential
Especifica uma conta de usuário que tem permissão para acessar o computador e executar comandos. O padrão é o usuário atual
Digite um nome de usuário, como User01 ou Domain01\User01, ou insira um objeto PSCredential gerado pelo Get-Credential
cmdlet . Se você digitar um nome de usuário, será solicitado que você insira a senha.
As credenciais são armazenadas em um objeto PSCredential e a senha é armazenada como um SecureString.
Observação
Para obter mais informações sobre a proteção de dados SecureString , consulte Quão seguro é SecureString?.
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Get-HotFix
usa o parâmetro Description para especificar tipos de hotfix. Caracteres curinga são permitidos.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Id
Filtra os Get-HotFix
resultados de IDs de hotfix específicas. Curingas não são aceitos.
Type: | String[] |
Aliases: | HFID |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
String
Você pode canalizar um ou mais nomes de computador para Get-HotFix.
Saídas
Get-HotFix
retorna objetos que representam os hotfixes no computador.
Observações
Esse cmdlet só está disponível em plataformas Windows.
A classe WMIWin32_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. Atualizações fornecidos pelo MSI (Microsoft Windows Installer) ou pelo site Windows Update não são retornados por Win32_QuickFixEngineering. Para obter mais informações, consulte classe Win32_QuickFixEngineering.
A Get-HotFix
saída pode variar em sistemas operacionais diferentes.