Get-CMSoftwareUpdate
Obter uma atualização de software.
Syntax
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
Use este cmdlet para obter uma ou mais atualizações de software.
Para obter mais informações, consulte Documentação de gerenciamento de atualização de software nos documentos principais.
Observação
Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\>
exemplo. Para obter mais informações, consulte getting started.
Exemplos
Exemplo 1: Obter atualizações de software baixadas
Este comando obtém todas as atualizações de software que o site baixou.
Get-CMSoftwareUpdate -IsContentProvisioned $True
Exemplo 2: Obter atualizações de software pelo grupo de atualizações
Este comando obtém primeiro o objeto do grupo de atualização de software chamado TestSUgroup10. Em seguida, ele usa o operador de pipeline para passar o objeto para Get-CMSoftwareUpdate. O resultado é a lista de todas as atualizações de software para o grupo de atualização de software.
Get-CMSoftwareUpdateGroup -Name "TestSUgroup10" | Get-CMSoftwareUpdate
Parâmetros
-ArticleId
Especifique a ID do artigo de uma atualização de software. Por exemplo, 4571687
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-BulletinId
Especifique a ID do Boletim de uma atualização de software. Por exemplo, MS18-952
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Category
Especifique a categoria de uma atualização de software. Para obter um objeto category, use o cmdlet Get-CMSoftwareUpdateCategory.
Type: | IResultObject[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CategoryName
Especifique uma matriz de nomes de categoria para atualizações de software.
Type: | String[] |
Aliases: | CategoryNames |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatePostedMax
Especifique a data mais recente em que uma atualização de software foi lançada.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatePostedMin
Especifique a data mais antiga em que uma atualização de software foi lançada.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DateRevisedMax
Especifique a data mais recente em que uma atualização de software foi revisada.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DateRevisedMin
Especifique a data mais antiga em que uma atualização de software foi revisada.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EulaExist
De definir esse parâmetro $true
para filtrar os resultados de todas as atualizações que tenham um contrato de licença.
Type: | Boolean |
Aliases: | EulaExists |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Fast
Adicione esse parâmetro para não atualizar automaticamente as propriedades desleisadas. Propriedades flexíveis contêm valores relativamente ineficientes para recuperar. Obter essas propriedades pode causar tráfego de rede adicional e diminuir o desempenho do cmdlet.
Se você não usar esse parâmetro, o cmdlet exibirá um aviso. Para desabilitar esse aviso, de definir $CMPSSuppressFastNotUsedCheck = $true
.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Especifica a ID de uma atualização de software. Esse valor é o CI_ID, por exemplo 143404
.
Type: | Int32 |
Aliases: | CIId, CI_ID |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeUpgrade
Adicione esse parâmetro para incluir atualizações de software na categoria de atualização.
Type: | SwitchParameter |
Aliases: | IncludeUpgrades |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsContentProvisioned
De definir esse parâmetro para filtrar os resultados de todas as atualizações para as quais $true
o site baixou conteúdo.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsDeployed
De definir esse parâmetro $true
para filtrar os resultados de todas as atualizações implantadas.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsExpired
De definir esse parâmetro para filtrar os resultados de todas $true
as atualizações expiradas.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsLatest
De definir esse parâmetro $true
para filtrar os resultados da versão mais recente da atualização de software.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsOfflineServiceable
De definir esse parâmetro como para filtrar os resultados de todas $true
as atualizações que são offline-serviceable. Você pode usar a ferramenta de linha de comando DISM para injetar essas atualizações em uma imagem do sistema operacional.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsSuperseded
De definir esse parâmetro como para filtrar os resultados de todas $true
as atualizações que são sobressedida.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsUserDefined
De definir esse parâmetro $true
para filtrar os resultados de todas as atualizações definidas pelo usuário.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifique o nome de uma atualização de software. Esse parâmetro se compara ao atributo de nome de exibição localizado.
Você pode usar caracteres curinga:
*
: Vários caracteres?
: Caractere único
Type: | String |
Aliases: | LocalizedDisplayName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-OnlyExpired
Adicione esse parâmetro para pesquisar apenas atualizações de software expiradas.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Severity
Especifique a gravidade da atualização de software.
Type: | CustomSeverityType |
Accepted values: | None, Low, Moderate, Important, Critical |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateGroup
Especifique o objeto do grupo de atualização de software. Para obter esse objeto, use o cmdlet Get-CMSoftwareUpdateGroup.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UpdateGroupId
Especifique uma matriz de IDs de grupos de atualização de software. Esse valor é o CI_ID ou a ID de Item de Configuração do grupo de atualização de software. Por exemplo, 107078
.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateGroupName
Especifique uma matriz de nomes de grupos de atualização de software.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Vendor
Aplica-se à versão 2010 e posterior. Especifique o nome do fornecedor de atualização de software. O fornecedor para a maioria das atualizações de software é "Microsoft"
. Se você configurar atualizações de software de terceiros, use esse valor para filtrar em outros fornecedores de atualização.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
IResultObject[]
IResultObject
Observações
Para obter mais informações sobre esse objeto de retorno e suas propriedades, consulte SMS_SoftwareUpdate classe WMI do servidor.