Get-CMSoftwareUpdate

模組:

ConfigurationManager

取得軟體更新。

語法

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 的軟體更新群組物件。 然後，它會使用管線運算符將對象傳遞至 Get-CMSoftwareUpdate。 結果是軟體更新群組的所有軟體更新清單。

Get-CMSoftwareUpdateGroup -Name "TestSUgroup10" | Get-CMSoftwareUpdate

參數

-ArticleId

指定軟體更新的 發行項識別 碼。 例如，4571687。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	True

-BulletinId

指定軟體更新的 布告欄標識 碼。 例如，MS18-952。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	True

-Category

指定軟體更新的類別。 若要取得類別物件，請使用 Get-CMSoftwareUpdateCategory Cmdlet。

類型:	IResultObject[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-CategoryName

指定軟體更新的類別名稱陣列。

類型:	String[]
別名:	CategoryNames
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DatePostedMax

指定軟體更新發行的最新日期。

類型:	DateTime
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DatePostedMin

指定軟體更新發行最早的日期。

類型:	DateTime
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DateRevisedMax

指定軟體更新修訂的最新日期。

類型:	DateTime
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DateRevisedMin

指定修改軟體更新的最早日期。

類型:	DateTime
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EulaExist

將此參數設定為 $true ，以篩選具有許可協定之所有更新的結果。

類型:	Boolean
別名:	EulaExists
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Fast

新增此參數，不自動重新整理延遲屬性。 延遲屬性包含相對沒有效率的擷取值。 取得這些屬性可能會導致額外的網路流量，並降低 Cmdlet 效能。

如果您未使用此參數，Cmdlet 會顯示警告。 若要停用此警告，請設定 $CMPSSuppressFastNotUsedCheck = $true。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ForceWildcardHandling

此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Id

指定軟體更新的識別碼。 這個值是 CI_ID，例如 143404。

類型:	Int32
別名:	CIId, CI_ID
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-IncludeUpgrade

新增此參數，以在升級類別中包含軟體更新。

類型:	SwitchParameter
別名:	IncludeUpgrades
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IsContentProvisioned

將此參數設定為 $true ，以篩選網站已下載內容之所有更新的結果。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IsDeployed

將此參數設定為 $true ，以篩選已部署之所有更新的結果。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IsExpired

將此參數設定為 $true ，以篩選所有已過期更新的結果。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IsLatest

將此參數設定為 $true ，以篩選最新版軟體更新的結果。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IsOfflineServiceable

將此參數設定為 $true ，以篩選所有可離線服務更新的結果。 您可以使用 DISM 命令列工具，將這些更新插入 OS 映射中。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IsSuperseded

將此參數設定為 $true ，以篩選所有已取代更新的結果。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IsUserDefined

將此參數設定為 $true ，以篩選用戶定義之所有更新的結果。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Name

指定軟體更新的名稱。 此參數會與本地化的顯示名稱屬性進行比較。

您可以使用通配符：

• *：多個字元
• ?：單一字元

類型:	String
別名:	LocalizedDisplayName
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	True

-OnlyExpired

新增此參數，只搜尋過期的軟體更新。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Severity

指定軟體更新的嚴重性。

類型:	CustomSeverityType
接受的值:	None, Low, Moderate, Important, Critical
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UpdateGroup

指定軟體更新群組物件。 若要取得此物件，請使用 Get-CMSoftwareUpdateGroup Cmdlet。

類型:	IResultObject
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-UpdateGroupId

指定軟體更新群組的識別碼陣列。 此值為軟體更新群組 的CI_ID 或設定 專案標識 碼。 例如，107078。

類型:	String[]
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-UpdateGroupName

指定軟體更新群組的名稱陣列。

類型:	String[]
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Vendor

適用於 2010 版和更新版本。 指定軟體更新廠商的名稱。 大部分軟體更新的廠商都是 "Microsoft"。 如果您設定第三方軟體更新，請使用此值來篩選其他更新廠商。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

IResultObject[]

IResultObject

備註

如需這個傳回物件及其屬性的詳細資訊，請 參閱SMS_SoftwareUpdate伺服器 WMI 類別。

相關連結

• Get-CMSoftwareUpdateGroup
• Save-CMSoftwareUpdate
• Set-CMSoftwareUpdate
• Sync-CMSoftwareUpdate
• Get-CMSoftwareUpdateCategory
• Get-CMSoftwareUpdateGroup
• Get-CMSoftwareUpdateContentInfo