{"content":"<div></div>","rawMetadata":{"metadata":{"_op_canonicalUrlPrefix":"https://learn.microsoft.com/zh-tw/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":"2026/8/3","updated_at_date_time":"2026-08-03T08:01:35.4938552Z"},"_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/zh-tw/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":"zh-tw","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-03 08:01 AM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/get-cmsoftwareupdate","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Get-CMSoftwareUpdate","schemaType":"PowershellCmdlet","summary":"<p>取得軟體更新。</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>取得軟體更新。</p>\n","uid":"ConfigurationManager.Get-CMSoftwareUpdate"}},"description":"<p>使用此 Cmdlet 取得一或多個軟體更新。</p>\n<p>如需詳細資訊，請參閱核心檔中的 <a href=\"/mem/configmgr/sum/\">軟體更新管理檔</a> 。</p>\n<div class=\"NOTE\">\n<p>注意事項</p>\n<p>從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 <code>PS XYZ:\\&gt;</code>。 如需詳細資訊，請 <a href=\"/powershell/sccm/overview\">參閱開始使用</a>。</p>\n</div>\n","examples":[{"code":"Get-CMSoftwareUpdate -IsContentProvisioned $True","description":"","summary":"<p>此命令會取得網站已下載的所有軟體更新。</p>\n","title":"範例 1：取得下載的軟體更新"},{"code":"Get-CMSoftwareUpdateGroup -Name \"TestSUgroup10\" | Get-CMSoftwareUpdate","description":"","summary":"<p>此命令會先取得名為 <strong>TestSUgroup10</strong> 的軟體更新群組物件。 然後，它會使用管線運算符將對象傳遞至 <strong>Get-CMSoftwareUpdate</strong>。 結果是軟體更新群組的所有軟體更新清單。</p>\n","title":"範例 2：依更新群組取得軟體更新"}],"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>如需這個傳回物件及其屬性的詳細資訊，請 <a href=\"/mem/configmgr/develop/reference/sum/sms_softwareupdate-server-wmi-class\">參閱SMS_SoftwareUpdate伺服器 WMI 類別</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>指定軟體更新的 <strong>發行項識別</strong> 碼。 例如，<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>指定軟體更新的 <strong>布告欄標識</strong> 碼。 例如，<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>指定軟體更新的類別。 若要取得類別物件，請使用 <a href=\"get-cmsoftwareupdatecategory\">Get-CMSoftwareUpdateCategory</a> Cmdlet。</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>指定軟體更新的類別名稱陣列。</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>指定軟體更新發行的最新日期。</p>\n","name":"DatePostedMax","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">DateTime</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>指定軟體更新發行最早的日期。</p>\n","name":"DatePostedMin","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">DateTime</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>指定軟體更新修訂的最新日期。</p>\n","name":"DateRevisedMax","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">DateTime</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>指定修改軟體更新的最早日期。</p>\n","name":"DateRevisedMin","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">DateTime</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>此參數會將通配符視為常值字元值。 您無法將其與 <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>將此參數設定為 <code>$true</code> ，以篩選具有許可協定之所有更新的結果。</p>\n","name":"EulaExist","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>新增此參數，不自動重新整理延遲屬性。 延遲屬性包含相對沒有效率的擷取值。 取得這些屬性可能會導致額外的網路流量，並降低 Cmdlet 效能。</p>\n<p>如果您未使用此參數，Cmdlet 會顯示警告。 若要停用此警告，請設定 <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>此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 <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>指定軟體更新的識別碼。 這個值是 <strong>CI_ID</strong>，例如 <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>新增此參數，以在升級類別中包含軟體更新。</p>\n","name":"IncludeUpgrade","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>將此參數設定為 <code>$true</code> ，以篩選網站已下載內容之所有更新的結果。</p>\n","name":"IsContentProvisioned","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>將此參數設定為 <code>$true</code> ，以篩選已部署之所有更新的結果。</p>\n","name":"IsDeployed","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>將此參數設定為 <code>$true</code> ，以篩選所有已過期更新的結果。</p>\n","name":"IsExpired","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>將此參數設定為 <code>$true</code> ，以篩選最新版軟體更新的結果。</p>\n","name":"IsLatest","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>將此參數設定為 <code>$true</code> ，以篩選所有可離線服務更新的結果。 您可以使用 DISM 命令列工具，將這些更新插入 OS 映射中。</p>\n","name":"IsOfflineServiceable","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>將此參數設定為 <code>$true</code> ，以篩選所有已取代更新的結果。</p>\n","name":"IsSuperseded","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>將此參數設定為 <code>$true</code> ，以篩選用戶定義之所有更新的結果。</p>\n","name":"IsUserDefined","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"acceptWildcardCharacters":true,"aliases":"LocalizedDisplayName","defaultValue":"None","description":"<p>指定軟體更新的名稱。 此參數會與本地化的顯示名稱屬性進行比較。</p>\n<p>您可以使用通配符：</p>\n<ul>\n<li>\n              <code>*</code>：多個字元</li>\n<li>\n              <code>?</code>：單一字元</li>\n</ul>\n","name":"Name","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>新增此參數，只搜尋過期的軟體更新。</p>\n","name":"OnlyExpired","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>指定軟體更新的嚴重性。</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>指定軟體更新群組物件。 若要取得此物件，請使用 <a href=\"get-cmsoftwareupdategroup\">Get-CMSoftwareUpdateGroup</a> Cmdlet。</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>指定軟體更新群組的識別碼陣列。 此值為軟體更新群組 <strong>的CI_ID</strong> 或設定 <strong>專案標識</strong> 碼。 例如，<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>指定軟體更新群組的名稱陣列。</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>適用於 2010 版和更新版本。 指定軟體更新廠商的名稱。 大部分軟體更新的廠商都是 <code>&quot;Microsoft&quot;</code>。 如果您設定第三方軟體更新，請使用此值來篩選其他更新廠商。</p>\n","name":"Vendor","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"}],"schema":"PowershellCmdlet","summary":"<p>取得軟體更新。</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":"zh-tw","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>取得軟體更新。</p>\n","uid":"ConfigurationManager.Get-CMSoftwareUpdate"}],"canonical_url":"https://learn.microsoft.com/zh-tw/powershell/module/configurationmanager/get-cmsoftwareupdate?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/zh-tw/powershell/module/configurationmanager/get-cmsoftwareupdate?view=sccm-ps"},"pageMetadata":"<meta name=\"description\" content=\"<p>使用此 Cmdlet 取得一或多個軟體更新。</p>\n<p>如需詳細資訊，請參閱核心檔中的 <a href=&quot;/mem/configmgr/sum/&quot;>軟體更新管理檔</a> 。</p>\n<div class=&quot;NOTE&quot;>\n<p>注意事項</p>\n<p>從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 <code>PS XYZ:\\&amp;gt;</code>。 如需詳細資訊，請 <a href=&quot;/powershell/sccm/overview&quot;>參閱開始使用</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=\"zh-tw\" />\r\n<meta name=\"ms.translationtype\" content=\"MT\" />\r\n<meta name=\"name\" content=\"Get-CMSoftwareUpdate\" />\r\n<meta name=\"notes\" content=\"<p>如需這個傳回物件及其屬性的詳細資訊，請 <a href=&quot;/mem/configmgr/develop/reference/sum/sms_softwareupdate-server-wmi-class&quot;>參閱SMS_SoftwareUpdate伺服器 WMI 類別</a>。</p>\n\" />\r\n<meta name=\"schema\" content=\"PowershellCmdlet\" />\r\n<meta name=\"summary\" content=\"<p>取得軟體更新。</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/"}