{"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":"25/06/2026","updated_at_date_time":"2026-06-25T23:04:58.5770352Z"},"_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","document_id":"789a71c4-f6f0-a2cb-484a-671b460bcfca","document_version_independent_id":"31dd656c-6c1d-e38c-6604-a2baff34b415","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":"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-06-25 11:04 PM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/get-cmsoftwareupdate","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Get-CMSoftwareUpdate","schemaType":"PowershellCmdlet","summary":"<p>Obter 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>Obter uma atualização de software.</p>\n","uid":"ConfigurationManager.Get-CMSoftwareUpdate"}},"description":"<p>Utilize este cmdlet para obter uma ou mais atualizações de software.</p>\n<p>Para obter mais informações, veja <a href=\"/mem/configmgr/sum/\">Documentação de gestão de atualizações de software</a> nos documentos principais.</p>\n<div class=\"NOTE\">\n<p>Observação</p>\n<p>Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo <code>PS XYZ:\\&gt;</code>. Para obter mais informações, veja <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 transferiu.</p>\n","title":"Exemplo 1: Obter atualizações de software transferidas"},{"code":"Get-CMSoftwareUpdateGroup -Name \"TestSUgroup10\" | Get-CMSoftwareUpdate","description":"","summary":"<p>Este comando obtém primeiro o objeto de grupo de atualização de software com o nome <strong>TestSUgroup10</strong>. Em seguida, utiliza o operador de pipeline para transmitir o objeto para <strong>Get-CMSoftwareUpdate</strong>. O resultado é a lista de todas as atualizações de software do grupo de atualizações de software.</p>\n","title":"Exemplo 2: Obter atualizações de software por grupo de atualizações"}],"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 este objeto de retorno e as respetivas propriedades, veja <a href=\"/mem/configmgr/develop/reference/sum/sms_softwareupdate-server-wmi-class\">SMS_SoftwareUpdate classe WMI de 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 o <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 o <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, utilize 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 foi lançada uma atualização de software.</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 foi lançada uma atualização de software.</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 revista.</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 revista.</p>\n","name":"DateRevisedMin","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">DateTime</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Este parâmetro trata os carateres universais como valores de carateres literais. 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 para <code>$true</code> filtrar os resultados de todas as atualizações que têm 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 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.</p>\n<p>Se não utilizar este parâmetro, o cmdlet apresenta um aviso. Para desativar este 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>Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). 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 o ID de uma atualização de software. Este 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 este parâmetro para incluir atualizações de software na categoria de atualização.</p>\n","name":"IncludeUpgrade","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Defina este parâmetro como para <code>$true</code> filtrar os resultados de todas as atualizações para as quais o site transferiu conteúdo.</p>\n","name":"IsContentProvisioned","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 de todas as atualizações implementadas.</p>\n","name":"IsDeployed","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 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 este parâmetro como para <code>$true</code> 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.</p>\n","name":"IsOfflineServiceable","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 de todas as atualizações que são substituídos.</p>\n","name":"IsSuperseded","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Defina este parâmetro como para <code>$true</code> filtrar os resultados de todas as atualizações definidas pelo utilizador.</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. Este parâmetro compara-se com o atributo de nome a apresentar localizado.</p>\n<p>Pode utilizar carateres universais:</p>\n<ul>\n<li>\n              <code>*</code>: Múltiplos carateres</li>\n<li>\n              <code>?</code>: caráter ú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 este parâmetro para procurar 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>Especifique o objeto do grupo de atualização de software. Para obter este objeto, utilize 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. Este valor é o <strong>CI_ID</strong> ou <strong>O ID do Item</strong> de Configuração 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 de atualizações de software. O fornecedor da maioria das atualizações de software é <code>&quot;Microsoft&quot;</code>. Se configurar atualizações de software de terceiros, utilize este valor para filtrar outros fornecedores de atualizações.</p>\n","name":"Vendor","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"}],"schema":"PowershellCmdlet","summary":"<p>Obter 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>Obter 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>Utilize este cmdlet para obter uma ou mais atualizações de software.</p>\n<p>Para obter mais informações, veja <a href=&quot;/mem/configmgr/sum/&quot;>Documentação de gestão de atualizações 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 a partir da unidade do site do Configuration Manager, por exemplo <code>PS XYZ:\\&amp;gt;</code>. Para obter mais informações, veja <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 este objeto de retorno e as respetivas propriedades, veja <a href=&quot;/mem/configmgr/develop/reference/sum/sms_softwareupdate-server-wmi-class&quot;>SMS_SoftwareUpdate classe WMI de servidor</a>.</p>\n\" />\r\n<meta name=\"schema\" content=\"PowershellCmdlet\" />\r\n<meta name=\"summary\" content=\"<p>Obter 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/"}