Get-HotFix
Obtém os hotfixes aplicados aos computadores local e remotos.
Sintaxe
Get-HotFix [[-Id] <string[]>] [-ComputerName <string[]>] [-Credential <PSCredential>] [<CommonParameters>]
Get-HotFix [-Descrição <string[]>] [-ComputerName <string[]>] [-Credential <PSCredential>] [<CommonParameters>]
Descrição
O cmdlet Get-Hotfix obtém os hotfixes aplicados ao computador local ou a computadores remotos pelo Serviço Baseado em Componente.
Parâmetros
-ComputerName <string[]>
Especifica um computador remoto. O padrão é o computador local.
Digite o nome NetBIOS, um endereço IP ou um nome de domínio totalmente qualificado de um computador remoto.
Este parâmetro não se baseia na comunicação remota do Windows PowerShell. É possível usar o parâmetro ComputerName de Get-Hotfix mesmo que o seu computador não esteja configurado para executar comandos remotos.
Necessário? |
false |
Posição? |
named |
Valor padrão |
Computador local |
Aceitar entrada do pipeline? |
true (ByPropertyName) |
Aceitar caracteres curinga? |
false |
-Credential <PSCredential>
Especifica uma conta de usuário com permissão para executar essa ação. O padrão é o usuário atual.
Digite um nome de usuário, como "User01" ou "Domain01\User01", ou insira um objeto PSCredential, como aquele gerado pelo cmdlet Get-Credential. Uma senha será solicitada após a digitação do nome do usuário.
Necessário? |
false |
Posição? |
named |
Valor padrão |
Usuário atual |
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Descrição <string[]>
Obtém apenas os hotfixes com as descrições especificadas. Os caracteres curinga são permitidos. O padrão são todos os hotfixes no computador.
Necessário? |
false |
Posição? |
named |
Valor padrão |
Todos os hotfixes |
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
true |
-Id <string[]>
Obtém apenas os hotfixes com as IDs de hotfix especificadas. O padrão são todos os hotfixes no computador.
Necessário? |
false |
Posição? |
1 |
Valor padrão |
Todos os hotfixes |
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
Entradas |
Nenhum Não é possível enviar a entrada para Get-HotFix. |
Saídas |
System.Management.ManagementObject#root\CIMV2\Win32_QuickFixEngineering Get-Hotfix retorna objetos que representam os hotfixes no computador. |
Observações
Este cmdlet usa a classe Win32_QuickFixEngineering de WMI, que representa atualizações pequenas em todo o sistema operacional. Iniciando com o Windows Vista, esta classe retorna apenas as atualizações fornecidas pelo CBS (Serviço Baseado em Componente). Ele não inclui atualizações que são fornecidas pelo MSI (Microsoft Windows Installer) ou pelo site do Windows Update. Para obter mais informações, consulte o tópico da classe Win32_QuickFixEngineering no Microsoft .NET Framework SDK em (o site pode estar em inglês).
A saída deste cmdlet pode ser diferente em sistemas operacionais diferentes.
Exemplo 1
C:\PS>get-hotfix
Descrição
-----------
Esse comando obtém todos os hotfixes do computador local.
Exemplo 2
C:\PS>get-hotfix -description Security* -computername Server01, Server02 -cred Server01\admin01
Descrição
-----------
Esse comando obtém todos os hotfixes nos computadores Server01 e Server02 cujas descrições começam com "Security".
Exemplo 3
C:\PS>$a = get-content servers.txt
C:\PS> $a | foreach { if (!(get-hotfix -id KB957095 -computername $_)) { add-content $_ -path Missing-kb953631.txt }}
Descrição
-----------
Os comandos neste exemplo criam um arquivo de texto que lista os nomes dos computadores que não têm uma atualização de segurança.
Os comandos usam o cmdlet Get-Hotfix para obter a atualização de segurança KB957095 em todos os computadores cujos nomes são listados no arquivo Servers.txt.
Se um computador não tiver a atualização, o cmdlet Add-Content gravará o nome do computador no arquivo Missing-KB953631.txt.
Exemplo 4
C:\PS>(get-hotfix | sort installedon)[-1]
Descrição
-----------
Esse comando obtém o hotfix mais recente no computador.
Ele obtém os hotfixes, classifica-os de acordo com o valor da propriedade InstalledOn e usa a notação matricial para selecionar o último item na matriz.