Get-CMSoftwareUpdate
Obter uma atualização de software.
Sintaxe
Get-CMSoftwareUpdate
[-ArticleId <String>]
[-BulletinId <String>]
[-Category <IResultObject[]>]
[-CategoryName <String[]>]
[-DatePostedMax <DateTime>]
[-DatePostedMin <DateTime>]
[-DateRevisedMax <DateTime>]
[-DateRevisedMin <DateTime>]
[-EulaExist <Boolean>]
[-Fast]
[-IncludeUpgrade]
[-IsContentProvisioned <Boolean>]
[-IsDeployed <Boolean>]
[-IsExpired <Boolean>]
[-IsLatest <Boolean>]
[-IsOfflineServiceable <Boolean>]
[-IsSuperseded <Boolean>]
[-IsUserDefined <Boolean>]
[-Name <String>]
[-OnlyExpired]
[-Severity <CustomSeverityType>]
[-Vendor <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Get-CMSoftwareUpdate
[-Fast]
-Id <Int32>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Get-CMSoftwareUpdate
[-Fast]
-UpdateGroup <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Get-CMSoftwareUpdate
[-Fast]
-UpdateGroupId <String[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Get-CMSoftwareUpdate
[-Fast]
-UpdateGroupName <String[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Description
Utilize este cmdlet para obter uma ou mais atualizações de software.
Para obter mais informações, veja Documentação de gestão de atualizações de software nos documentos principais.
Observação
Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.
Exemplos
Exemplo 1: Obter atualizações de software transferidas
Este comando obtém todas as atualizações de software que o site transferiu.
Get-CMSoftwareUpdate -IsContentProvisioned $TrueExemplo 2: Obter atualizações de software por grupo de atualizações
Este comando obtém primeiro o objeto de grupo de atualização de software com o nome TestSUgroup10. Em seguida, utiliza o operador de pipeline para transmitir o objeto para Get-CMSoftwareUpdate. O resultado é a lista de todas as atualizações de software do grupo de atualizações de software.
Get-CMSoftwareUpdateGroup -Name "TestSUgroup10" | Get-CMSoftwareUpdateParâmetros
-ArticleId
Especifique o ID do Artigo de uma atualização de software. Por exemplo, 4571687.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | True |
-BulletinId
Especifique o ID do Boletim de uma atualização de software. Por exemplo, MS18-952.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | True |
-Category
Especifique a categoria de uma atualização de software. Para obter um objeto de categoria, utilize o cmdlet Get-CMSoftwareUpdateCategory .
| Tipo: | IResultObject[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-CategoryName
Especifique uma matriz de nomes de categorias para atualizações de software.
| Tipo: | String[] |
| Aliases: | CategoryNames |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DatePostedMax
Especifique a data mais recente em que foi lançada uma atualização de software.
| Tipo: | DateTime |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DatePostedMin
Especifique a data mais antiga em que foi lançada uma atualização de software.
| Tipo: | DateTime |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DateRevisedMax
Especifique a data mais recente em que uma atualização de software foi revista.
| Tipo: | DateTime |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DateRevisedMin
Especifique a data mais antiga em que uma atualização de software foi revista.
| Tipo: | DateTime |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-EulaExist
Defina este parâmetro como para $true filtrar os resultados de todas as atualizações que têm um contrato de licença.
| Tipo: | Boolean |
| Aliases: | EulaExists |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Fast
Adicione este parâmetro para não atualizar automaticamente as propriedades em diferido. As propriedades em diferido contêm valores relativamente ineficientes a obter. Obter estas propriedades pode causar tráfego de rede adicional e diminuir o desempenho do cmdlet.
Se não utilizar este parâmetro, o cmdlet apresenta um aviso. Para desativar este aviso, defina $CMPSSuppressFastNotUsedCheck = $true.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Id
Especifica o ID de uma atualização de software. Este valor é o CI_ID, por exemplo 143404.
| Tipo: | Int32 |
| Aliases: | CIId, CI_ID |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-IncludeUpgrade
Adicione este parâmetro para incluir atualizações de software na categoria de atualização.
| Tipo: | SwitchParameter |
| Aliases: | IncludeUpgrades |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-IsContentProvisioned
Defina este parâmetro como para $true filtrar os resultados de todas as atualizações para as quais o site transferiu conteúdo.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-IsDeployed
Defina este parâmetro como $true para filtrar os resultados de todas as atualizações implementadas.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-IsExpired
Defina este parâmetro como $true para filtrar os resultados de todas as atualizações que expiraram.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-IsLatest
Defina este parâmetro como $true para filtrar os resultados da versão mais recente da atualização de software.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-IsOfflineServiceable
Defina este parâmetro como para $true filtrar os resultados de todas as atualizações que são passíveis de assistência offline. Pode utilizar a ferramenta de linha de comandos DISM para injetar estas atualizações numa imagem do SO.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-IsSuperseded
Defina este parâmetro como $true para filtrar os resultados de todas as atualizações que são substituídos.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-IsUserDefined
Defina este parâmetro como para $true filtrar os resultados de todas as atualizações definidas pelo utilizador.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Name
Especifique o nome de uma atualização de software. Este parâmetro compara-se com o atributo de nome a apresentar localizado.
Pode utilizar carateres universais:
-
*: Múltiplos carateres -
?: caráter único
| Tipo: | String |
| Aliases: | LocalizedDisplayName |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | True |
-OnlyExpired
Adicione este parâmetro para procurar apenas atualizações de software expiradas.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Severity
Especifique a gravidade da atualização de software.
| Tipo: | CustomSeverityType |
| Valores aceitos: | None, Low, Moderate, Important, Critical |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-UpdateGroup
Especifique o objeto do grupo de atualização de software. Para obter este objeto, utilize o cmdlet Get-CMSoftwareUpdateGroup .
| Tipo: | IResultObject |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-UpdateGroupId
Especifique uma matriz de IDs de grupos de atualização de software. Este valor é o CI_ID ou O ID do Item de Configuração do grupo de atualização de software. Por exemplo, 107078.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-UpdateGroupName
Especifique uma matriz de nomes de grupos de atualização de software.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Vendor
Aplica-se à versão 2010 e posterior. Especifique o nome do fornecedor de atualizações de software. O fornecedor da maioria das atualizações de software é "Microsoft". Se configurar atualizações de software de terceiros, utilize este valor para filtrar outros fornecedores de atualizações.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
IResultObject[]
IResultObject
Observações
Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_SoftwareUpdate classe WMI de servidor.