Get-CMSoftwareUpdate
取得軟體更新。
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
使用此 Cmdlet 來取得一或多個軟體更新。
如需詳細資訊，請參閱核心檔中的 軟體更新管理檔 。
注意
從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。 如需詳細資訊，請參閱 快速入門。
範例
範例1：取得下載軟體更新
這個命令會取得網站下載的所有軟體更新。
Get-CMSoftwareUpdate -IsContentProvisioned $True範例2：依更新群組取得軟體更新
此命令會先取得名為 TestSUgroup10的軟體更新群組物件。 然後使用管線運算子將物件傳遞至 CMSoftwareUpdate。 結果是軟體更新群組的所有軟體更新清單。
Get-CMSoftwareUpdateGroup -Name "TestSUgroup10" | Get-CMSoftwareUpdate參數
-ArticleId
指定軟體更新的 文章識別碼 。 例如，4571687。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-BulletinId
指定軟體更新的 公告欄識別碼 。 例如，MS18-952。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-CategoryName
指定軟體更新的類別名稱陣列。
| Type: | String[] |
| Aliases: | CategoryNames |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DatePostedMax
指定發行軟體更新的最晚日期。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DatePostedMin
指定發行軟體更新的最早日期。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DateRevisedMax
指定修訂軟體更新的最晚日期。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DateRevisedMin
指定修訂軟體更新的最早日期。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EulaExist
將此參數設定為 $true 以篩選具有授權協定之所有更新的結果。
| Type: | Boolean |
| Aliases: | EulaExists |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
這個參數會處理萬用字元，而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeUpgrade
新增此參數以包含升級類別中的軟體更新。
| Type: | SwitchParameter |
| Aliases: | IncludeUpgrades |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsContentProvisioned
將此參數設定為 $true 以篩選網站下載內容之所有更新的結果。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsDeployed
將此參數設定為 $true 以篩選部署的所有更新的結果。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsExpired
將此參數設定為 $true 以篩選已到期的所有更新的結果。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsLatest
將此參數設定為 $true 以篩選最新版軟體更新的結果。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsOfflineServiceable
將此參數設定為 $true 以篩選離線維護的所有更新的結果。 您可以使用 DISM 命令列工具，將這些更新插入 OS 映射。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsSuperseded
將此參數設定為 $true 以篩選所有取代之更新的結果。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsUserDefined
將此參數設定為 $true ，以篩選使用者定義之所有更新的結果。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnlyExpired
新增此參數僅限搜尋到期的軟體更新。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpdateGroup
指定軟體更新群組物件。 若要取得此物件，請使用 CMSoftwareUpdateGroup Cmdlet。
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UpdateGroupId
指定軟體更新群組的 IDs 陣列。 此值是軟體更新群組的 CI_ID 或 Config 專案識別碼 。 例如，107078。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UpdateGroupName
指定軟體更新群組的名稱陣列。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-供應商
適用于版本2010和更新版本。 指定軟體更新廠商的名稱。 大多數軟體更新為廠商 "Microsoft" 。 如果您設定協力廠商軟體更新，請使用此值來篩選其他的更新廠商。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-名稱
指定軟體更新的名稱。 此參數會與當地語系化顯示名稱屬性進行比較。
您可以使用萬用字元：
*：多個字元?：單一字元
| Type: | String |
| Aliases: | LocalizedDisplayName |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-嚴重性
指定軟體更新的嚴重性。
| Type: | CustomSeverityType |
| Accepted values: | None, Low, Moderate, Important, Critical |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-快速
將此參數新增至不會自動重新整理遲緩屬性。 Lazy 屬性包含的值相對於取得的低效。 取得這些屬性可能會導致額外的網路流量，並降低 Cmdlet 效能。
如果您未使用此參數，Cmdlet 會顯示警告。 若要停用此警告，請設定 $CMPSSuppressFastNotUsedCheck = $true 。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-識別碼
指定軟體更新的識別碼。 例如，此值為 CI_ID 143404 。
| Type: | Int32 |
| Aliases: | CIId, CI_ID |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-類別
指定軟體更新的類別。 若要取得 category 物件，請使用 CMSoftwareUpdateCategory Cmdlet。
| Type: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
輸入
ConfigurationManagement [ManagementProvider]
ConfigurationManagement IResultObject
輸出
IResultObject []
IResultObject
備註
如需此 return 物件及其屬性的詳細資訊，請參閱 SMS_SoftwareUpdate SERVER WMI 類別。