{"content":"<div></div>","rawMetadata":{"metadata":{"_op_canonicalUrlPrefix":"https://learn.microsoft.com/pt-br/powershell/","_op_gitContributorInformation":{"author":{"display_name":"Banreet Kaur","id":"92906285","name":"Banreet","profile_url":"https://github.com/Banreet"},"contributors":[{"display_name":"Aaron Czechowski","id":"26784733","name":"aczechowski","profile_url":"https://github.com/aczechowski"},{"display_name":"Dan Mabee","id":"40476441","name":"damabe","profile_url":"https://github.com/damabe"},{"display_name":"sankethka","id":"16908144","name":"sankethka","profile_url":"https://github.com/sankethka"}],"update_at":"21/08/2026","updated_at_date_time":"2026-08-21T08:55:50.7403575Z"},"_path":"module/configurationmanager/get-cmsoftwareupdate.json","_rel":"../../","_tocRel":"../sccm-ps/toc.json","apiPlatform":"powershell","author":"Banreet","breadcrumb_path":"/powershell/sccm/bread/toc.json","canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/get-cmsoftwareupdate?view=sccm-ps","content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell-ref/blob/main/sccm-ps/ConfigurationManager/Get-CMSoftwareUpdate.md","default_moniker":"sccm-ps","depot_name":"MSDN.sccm-powershell","external help file":"AdminUI.PS.dll-Help.xml","feedback_product_url":"https://feedbackportal.microsoft.com/feedback/forum/4669adfc-ee1b-ec11-b6e7-0022481f8472","feedback_system":"Standard","git_commit_id":"60c420a104132d31f3f13309d4f01055d82b10bb","gitcommit":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/60c420a104132d31f3f13309d4f01055d82b10bb/sccm-ps/ConfigurationManager/Get-CMSoftwareUpdate.md","github_contributors":["aczechowski","damabe","sankethka"],"locale":"pt-br","manager":"laurawi","Module Name":"ConfigurationManager","monikers":["sccm-ps"],"ms.author":"dannygu","ms.date":"12/16/2021","ms.service":"microsoft-endpoint-configuration-manager","ms.subservice":"other","ms.topic":"reference","open_to_public_contributors":true,"original_content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/live/sccm-ps/ConfigurationManager/Get-CMSoftwareUpdate.md","original_content_git_url_template":"{repo}/blob/{branch}/sccm-ps/ConfigurationManager/Get-CMSoftwareUpdate.md","PlatyPS schema version":"2.0.0","products":["https://authoring-docs-microsoft.poolparty.biz/devrel/f1499c3b-793f-48c3-a9ce-20285bcc6541"],"site_name":"Docs","title":"Get-CMSoftwareUpdate","titleSuffix":"Configuration Manager","uhfHeaderId":"MSDocsHeader-Powershell","updated_at":"2026-08-21 08:55 AM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/get-cmsoftwareupdate","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Get-CMSoftwareUpdate","schemaType":"PowershellCmdlet","summary":"<p>Obtenha uma atualização de software.</p>\n","uid":"ConfigurationManager.Get-CMSoftwareUpdate"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.Get-CMSoftwareUpdate":{"href":"get-cmsoftwareupdate","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Get-CMSoftwareUpdate","schemaType":"PowershellCmdlet","summary":"<p>Obtenha uma atualização de software.</p>\n","uid":"ConfigurationManager.Get-CMSoftwareUpdate"}},"description":"<p>Use este cmdlet para obter uma ou mais atualizações de software.</p>\n<p>Para obter mais informações, consulte a <a href=\"/mem/configmgr/sum/\">documentação de gerenciamento de atualização de software</a> nos documentos principais.</p>\n<div class=\"NOTE\">\n<p>Observação</p>\n<p>Execute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemplo<code>PS XYZ:\\&gt;</code>. Para obter mais informações, consulte <a href=\"/powershell/sccm/overview\">introdução</a>.</p>\n</div>\n","examples":[{"code":"Get-CMSoftwareUpdate -IsContentProvisioned $True","description":"","summary":"<p>Este comando obtém todas as atualizações de software que o site baixou.</p>\n","title":"Exemplo 1: obter atualizações de software baixadas"},{"code":"Get-CMSoftwareUpdateGroup -Name \"TestSUgroup10\" | Get-CMSoftwareUpdate","description":"","summary":"<p>Primeiro, esse comando obtém o objeto do grupo de atualização de software chamado <strong>TestSUgroup10</strong>. Em seguida, ele usa o operador de pipeline para passar o objeto para <strong>Get-CMSoftwareUpdate</strong>. O resultado é a lista de todas as atualizações de software para o grupo de atualização de software.</p>\n","title":"Exemplo 2: obter atualizações de software por grupo de atualização"}],"inputs":[{"description":"","name":"<p><span class=\"no-loc xref\">Microsoft.ConfigurationManagement.ManagementProvider.IResultObject</span><span>[</span><span>]</span></p>\n"},{"description":"","name":"<span class=\"no-loc xref\">Microsoft.ConfigurationManagement.ManagementProvider.IResultObject</span>\n"}],"links":[{"href":"get-cmsoftwareupdategroup","text":"Get-CMSoftwareUpdateGroup"},{"href":"save-cmsoftwareupdate","text":"Save-CMSoftwareUpdate"},{"href":"set-cmsoftwareupdate","text":"Set-CMSoftwareUpdate"},{"href":"sync-cmsoftwareupdate","text":"Sync-CMSoftwareUpdate"},{"href":"get-cmsoftwareupdatecategory","text":"Get-CMSoftwareUpdateCategory"},{"href":"get-cmsoftwareupdategroup","text":"Get-CMSoftwareUpdateGroup"},{"href":"get-cmsoftwareupdatecontentinfo","text":"Get-CMSoftwareUpdateContentInfo"}],"module":"ConfigurationManager","name":"Get-CMSoftwareUpdate","notes":"<p>Para obter mais informações sobre esse objeto de retorno e suas propriedades, consulte <a href=\"/mem/configmgr/develop/reference/sum/sms_softwareupdate-server-wmi-class\">SMS_SoftwareUpdate classe WMI do servidor</a>.</p>\n","outputs":[{"description":"","name":"<span class=\"no-loc xref\">IResultObject[]</span>\n"},{"description":"","name":"<span class=\"no-loc xref\">IResultObject</span>\n"}],"parameters":[{"acceptWildcardCharacters":true,"aliases":"","defaultValue":"None","description":"<p>Especifique a <strong>ID do Artigo</strong> de uma atualização de software. Por exemplo, <code>4571687</code>.</p>\n","name":"ArticleId","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"acceptWildcardCharacters":true,"aliases":"","defaultValue":"None","description":"<p>Especifique a <strong>ID do boletim</strong> de uma atualização de software. Por exemplo, <code>MS18-952</code>.</p>\n","name":"BulletinId","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique a categoria de uma atualização de software. Para obter um objeto de categoria, use o cmdlet <a href=\"get-cmsoftwareupdatecategory\">Get-CMSoftwareUpdateCategory</a> .</p>\n","name":"Category","parameterValueGroup":"","pipelineInput":true,"position":"Named","type":"<p><span class=\"no-loc xref\">IResultObject</span><span>[</span><span>]</span></p>\n"},{"aliases":"CategoryNames","defaultValue":"None","description":"<p>Especifique uma matriz de nomes de categorias para atualizações de software.</p>\n","name":"CategoryName","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">String</span><span>[</span><span>]</span></p>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique a data mais recente em que uma atualização de software foi lançada.</p>\n","name":"DatePostedMax","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">DateTime</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique a data mais antiga em que uma atualização de software foi lançada.</p>\n","name":"DatePostedMin","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">DateTime</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique a data mais recente em que uma atualização de software foi revisada.</p>\n","name":"DateRevisedMax","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">DateTime</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique a data mais antiga em que uma atualização de software foi revisada.</p>\n","name":"DateRevisedMin","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">DateTime</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Esse parâmetro trata caracteres curinga como valores de caracteres literais. Você não pode combiná-lo com <strong>ForceWildcardHandling</strong>.</p>\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"EulaExists","defaultValue":"None","description":"<p>Defina este parâmetro como <code>$true</code> para filtrar os resultados de todas as atualizações que tenham um contrato de licença.</p>\n","name":"EulaExist","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Adicione esse parâmetro para não atualizar automaticamente as propriedades lentas. As propriedades lentas contêm valores relativamente ineficientes para recuperar. Obter essas propriedades pode causar tráfego de rede adicional e diminuir o desempenho do cmdlet.</p>\n<p>Se você não usar esse parâmetro, o cmdlet exibirá um aviso. Para desabilitar esse aviso, defina <code>$CMPSSuppressFastNotUsedCheck = $true</code>.</p>\n","name":"Fast","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com <strong>DisableWildcardHandling</strong>.</p>\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"CIId, CI_ID","defaultValue":"None","description":"<p>Especifica a ID de uma atualização de software. Esse valor é o <strong>CI_ID</strong>, por exemplo <code>143404</code>.</p>\n","isRequired":true,"name":"Id","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Int32</span>\n"},{"aliases":"IncludeUpgrades","defaultValue":"None","description":"<p>Adicione esse parâmetro para incluir atualizações de software na categoria de upgrade.</p>\n","name":"IncludeUpgrade","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Defina esse parâmetro como <code>$true</code> para filtrar os resultados de todas as atualizações para as quais o site baixou conteúdo.</p>\n","name":"IsContentProvisioned","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Defina esse parâmetro como <code>$true</code> para filtrar os resultados de todas as atualizações implantadas.</p>\n","name":"IsDeployed","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Defina esse parâmetro como <code>$true</code> para filtrar os resultados de todas as atualizações que expiraram.</p>\n","name":"IsExpired","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Defina este parâmetro como <code>$true</code> para filtrar os resultados da versão mais recente da atualização de software.</p>\n","name":"IsLatest","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Defina esse parâmetro como <code>$true</code> para filtrar os resultados de todas as atualizações que podem ser atendidas offline. Você pode usar a ferramenta de linha de comando DISM para injetar essas atualizações em uma imagem do sistema operacional.</p>\n","name":"IsOfflineServiceable","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Defina esse parâmetro como <code>$true</code> para filtrar os resultados de todas as atualizações substituídas.</p>\n","name":"IsSuperseded","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Defina esse parâmetro como <code>$true</code> para filtrar os resultados de todas as atualizações definidas pelo usuário.</p>\n","name":"IsUserDefined","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"acceptWildcardCharacters":true,"aliases":"LocalizedDisplayName","defaultValue":"None","description":"<p>Especifique o nome de uma atualização de software. Esse parâmetro se compara ao atributo de nome de exibição localizado.</p>\n<p>Você pode usar caracteres curinga:</p>\n<ul>\n<li>\n              <code>*</code>: vários caracteres</li>\n<li>\n              <code>?</code>: Caractere único</li>\n</ul>\n","name":"Name","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Adicione esse parâmetro para pesquisar apenas atualizações de software expiradas.</p>\n","name":"OnlyExpired","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique a gravidade da atualização de software.</p>\n","name":"Severity","parameterValueGroup":"None, Low, Moderate, Important, Critical","position":"Named","type":"<span class=\"no-loc xref\">CustomSeverityType</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especificar objeto de grupo de atualização de software. Para obter esse objeto, use o cmdlet <a href=\"get-cmsoftwareupdategroup\">Get-CMSoftwareUpdateGroup</a> .</p>\n","isRequired":true,"name":"UpdateGroup","parameterValueGroup":"","pipelineInput":true,"position":"Named","type":"<span class=\"no-loc xref\">IResultObject</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique uma matriz de IDs de grupos de atualização de software. Esse valor é o <strong>CI_ID</strong> ou a <strong>ID do item de configuração</strong> do grupo de atualização de software. Por exemplo, <code>107078</code>.</p>\n","isRequired":true,"name":"UpdateGroupId","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">String</span><span>[</span><span>]</span></p>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique uma matriz de nomes de grupos de atualização de software.</p>\n","isRequired":true,"name":"UpdateGroupName","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">String</span><span>[</span><span>]</span></p>\n"},{"aliases":"","defaultValue":"None","description":"<p>Aplica-se à versão 2010 e posterior. Especifique o nome do fornecedor da atualização de software. O fornecedor da maioria das atualizações de software é <code>&quot;Microsoft&quot;</code>o . Se você configurar atualizações de software de terceiros, use esse valor para filtrar outros fornecedores de atualização.</p>\n","name":"Vendor","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"}],"schema":"PowershellCmdlet","summary":"<p>Obtenha uma atualização de software.</p>\n","syntaxes":["Get-CMSoftwareUpdate [-ArticleId <String>] [-BulletinId <String>] [-Category <IResultObject[]>]\n [-CategoryName <String[]>] [-DatePostedMax <DateTime>] [-DatePostedMin <DateTime>]\n [-DateRevisedMax <DateTime>] [-DateRevisedMin <DateTime>] [-EulaExist <Boolean>] [-Fast] [-IncludeUpgrade]\n [-IsContentProvisioned <Boolean>] [-IsDeployed <Boolean>] [-IsExpired <Boolean>] [-IsLatest <Boolean>]\n [-IsOfflineServiceable <Boolean>] [-IsSuperseded <Boolean>] [-IsUserDefined <Boolean>] [-Name <String>]\n [-OnlyExpired] [-Severity <CustomSeverityType>] [-Vendor <String>] [-DisableWildcardHandling]\n [-ForceWildcardHandling] [<CommonParameters>]","Get-CMSoftwareUpdate [-Fast] -Id <Int32> [-DisableWildcardHandling] [-ForceWildcardHandling]\n [<CommonParameters>]","Get-CMSoftwareUpdate [-Fast] -UpdateGroup <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling]\n [<CommonParameters>]","Get-CMSoftwareUpdate [-Fast] -UpdateGroupId <String[]> [-DisableWildcardHandling] [-ForceWildcardHandling]\n [<CommonParameters>]","Get-CMSoftwareUpdate [-Fast] -UpdateGroupName <String[]> [-DisableWildcardHandling] [-ForceWildcardHandling]\n [<CommonParameters>]"],"uid":"ConfigurationManager.Get-CMSoftwareUpdate","hideEdit":true,"ms.translationtype":"MT","ms.contentlocale":"pt-br","loc_version":"2024-08-21T21:18:36.7205003Z","loc_source_id":"Github-72476255#live","loc_file_id":"Github-72476255.live.MSDN.sccm-powershell.sccm-ps/ConfigurationManager/Get-CMSoftwareUpdate.md","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/get-cmsoftwareupdate","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Get-CMSoftwareUpdate","schemaType":"PowershellCmdlet","summary":"<p>Obtenha uma atualização de software.</p>\n","uid":"ConfigurationManager.Get-CMSoftwareUpdate"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/get-cmsoftwareupdate?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/get-cmsoftwareupdate?view=sccm-ps"},"pageMetadata":"<meta name=\"description\" content=\"<p>Use este cmdlet para obter uma ou mais atualizações de software.</p>\n<p>Para obter mais informações, consulte a <a href=&quot;/mem/configmgr/sum/&quot;>documentação de gerenciamento de atualização de software</a> nos documentos principais.</p>\n<div class=&quot;NOTE&quot;>\n<p>Observação</p>\n<p>Execute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemplo<code>PS XYZ:\\&amp;gt;</code>. Para obter mais informações, consulte <a href=&quot;/powershell/sccm/overview&quot;>introdução</a>.</p>\n</div>\n\" />\r\n<meta name=\"hideEdit\" content=\"true\" />\r\n<meta name=\"loc_file_id\" content=\"Github-72476255.live.MSDN.sccm-powershell.sccm-ps/ConfigurationManager/Get-CMSoftwareUpdate.md\" />\r\n<meta name=\"loc_source_id\" content=\"Github-72476255#live\" />\r\n<meta name=\"loc_version\" content=\"2024-08-21T21:18:36.7205003Z\" />\r\n<meta name=\"module\" content=\"ConfigurationManager\" />\r\n<meta name=\"ms.contentlocale\" content=\"pt-br\" />\r\n<meta name=\"ms.translationtype\" content=\"MT\" />\r\n<meta name=\"name\" content=\"Get-CMSoftwareUpdate\" />\r\n<meta name=\"notes\" content=\"<p>Para obter mais informações sobre esse objeto de retorno e suas propriedades, consulte <a href=&quot;/mem/configmgr/develop/reference/sum/sms_softwareupdate-server-wmi-class&quot;>SMS_SoftwareUpdate classe WMI do servidor</a>.</p>\n\" />\r\n<meta name=\"schema\" content=\"PowershellCmdlet\" />\r\n<meta name=\"summary\" content=\"<p>Obtenha uma atualização de software.</p>\n\" />\r\n<meta name=\"syntaxes\" content=\"Get-CMSoftwareUpdate [-ArticleId <String>] [-BulletinId <String>] [-Category <IResultObject[]>]\n [-CategoryName <String[]>] [-DatePostedMax <DateTime>] [-DatePostedMin <DateTime>]\n [-DateRevisedMax <DateTime>] [-DateRevisedMin <DateTime>] [-EulaExist <Boolean>] [-Fast] [-IncludeUpgrade]\n [-IsContentProvisioned <Boolean>] [-IsDeployed <Boolean>] [-IsExpired <Boolean>] [-IsLatest <Boolean>]\n [-IsOfflineServiceable <Boolean>] [-IsSuperseded <Boolean>] [-IsUserDefined <Boolean>] [-Name <String>]\n [-OnlyExpired] [-Severity <CustomSeverityType>] [-Vendor <String>] [-DisableWildcardHandling]\n [-ForceWildcardHandling] [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"Get-CMSoftwareUpdate [-Fast] -Id <Int32> [-DisableWildcardHandling] [-ForceWildcardHandling]\n [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"Get-CMSoftwareUpdate [-Fast] -UpdateGroup <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling]\n [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"Get-CMSoftwareUpdate [-Fast] -UpdateGroupId <String[]> [-DisableWildcardHandling] [-ForceWildcardHandling]\n [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"Get-CMSoftwareUpdate [-Fast] -UpdateGroupName <String[]> [-DisableWildcardHandling] [-ForceWildcardHandling]\n [<CommonParameters>]\" />\r\n<meta name=\"uid\" content=\"ConfigurationManager.Get-CMSoftwareUpdate\" />\r\n","themesRelativePathToOutputRoot":"_themes/"}