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>]

説明

このコマンドレットを使用して、1 つ以上のソフトウェア更新プログラムを取得します。

詳細については、コア ドキュメントの 「ソフトウェア更新プログラム管理ドキュメント 」を参照してください。

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例

例 1: ダウンロードしたソフトウェア更新プログラムを取得する

このコマンドは、サイトがダウンロードしたすべてのソフトウェア更新プログラムを取得します。

Get-CMSoftwareUpdate -IsContentProvisioned $True

例 2: 更新プログラム グループ別にソフトウェア更新プログラムを取得する

このコマンドは、まず TestSUgroup10 という名前のソフトウェア更新グループ オブジェクトを取得します。 その後、パイプライン演算子を使用してオブジェクトを Get-CMSoftwareUpdate に渡します。 その結果、ソフトウェア更新プログラム グループのすべてのソフトウェア更新プログラムの一覧が表示されます。

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

パラメーター

-ArticleId

ソフトウェア更新プログラムの アーティクル ID を 指定します。 たとえば、「 4571687 」のように入力します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	True

-BulletinId

ソフトウェア更新プログラムの セキュリティ情報 ID を 指定します。 たとえば、「 MS18-952 」のように入力します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	True

-Category

ソフトウェア更新プログラムのカテゴリを指定します。 カテゴリ オブジェクトを取得するには、 Get-CMSoftwareUpdateCategory コマンドレットを 使用します。

型:	IResultObject[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-CategoryName

ソフトウェア更新プログラムのカテゴリ名の配列を指定します。

型:	String[]
Aliases:	CategoryNames
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DatePostedMax

ソフトウェア更新プログラムがリリースされた最新の日付を指定します。

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DatePostedMin

ソフトウェア更新プログラムがリリースされた最も早い日付を指定します。

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DateRevisedMax

ソフトウェア更新プログラムが変更された最新の日付を指定します。

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DateRevisedMin

ソフトウェア更新プログラムが変更された最も早い日付を指定します。

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EulaExist

使用許諾契約を持つすべての更新プログラムの結果をフィルター処理するには、このパラメーターを $true に設定します。

型:	Boolean
Aliases:	EulaExists
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Fast

このパラメーターを追加して、遅延プロパティを自動的に更新しないようにします。 遅延プロパティには、取得するのが比較的非効率的な値が含まれています。 これらのプロパティを取得すると、追加のネットワーク トラフィックが発生し、コマンドレットのパフォーマンスが低下する可能性があります。

このパラメーターを使用しない場合、コマンドレットに警告が表示されます。 この警告を無効にするには、 $CMPSSuppressFastNotUsedCheck = $trueを設定します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Id

ソフトウェア更新プログラムの ID を指定します。 この値は、143404などのCI_IDです。

型:	Int32
Aliases:	CIId, CI_ID
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IncludeUpgrade

このパラメーターを追加して、アップグレード カテゴリにソフトウェア更新プログラムを含めます。

型:	SwitchParameter
Aliases:	IncludeUpgrades
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IsContentProvisioned

このパラメーターを $true に設定して、サイトがコンテンツをダウンロードしたすべての更新プログラムの結果をフィルター処理します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IsDeployed

展開されているすべての更新プログラムの結果をフィルター処理するには、このパラメーターを $true に設定します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IsExpired

有効期限が切れているすべての更新プログラムの結果をフィルター処理するには、このパラメーターを $true に設定します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IsLatest

このパラメーターを $true に設定して、最新バージョンのソフトウェア更新プログラムの結果をフィルター処理します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IsOfflineServiceable

オフラインでサービス可能なすべての更新プログラムの結果をフィルター処理するには、このパラメーターを $true に設定します。 DISM コマンド ライン ツールを使用して、これらの更新プログラムを OS イメージに挿入できます。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IsSuperseded

置き換えられるすべての更新プログラムの結果をフィルター処理するには、このパラメーターを $true に設定します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IsUserDefined

このパラメーターを $true に設定して、ユーザー定義のすべての更新プログラムの結果をフィルター処理します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

ソフトウェア更新プログラムの名前を指定します。 このパラメーターは、ローカライズされた表示名属性と比較します。

ワイルドカード文字を使用できます。

• *: 複数の文字
• ?: 1 文字

型:	String
Aliases:	LocalizedDisplayName
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	True

-OnlyExpired

期限切れのソフトウェア更新プログラムのみを検索するには、このパラメーターを追加します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Severity

ソフトウェア更新プログラムの重大度を指定します。

型:	CustomSeverityType
指定可能な値:	None, Low, Moderate, Important, Critical
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UpdateGroup

ソフトウェア更新プログラム グループ オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMSoftwareUpdateGroup コマンドレットを使用します。

型:	IResultObject
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-UpdateGroupId

ソフトウェア更新グループの ID の配列を指定します。 この値は、ソフトウェア更新グループの CI_ID または 構成項目 ID です 。 たとえば、「 107078 」のように入力します。

型:	String[]
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UpdateGroupName

ソフトウェア更新グループの名前の配列を指定します。

型:	String[]
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Vendor

バージョン 2010 以降に適用されます。 ソフトウェア更新プログラムベンダーの名前を指定します。 ほとんどのソフトウェア更新プログラムのベンダーは "Microsoft"。 サード パーティ製のソフトウェア更新プログラムを構成する場合は、この値を使用して、他の更新プログラム ベンダーをフィルター処理します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject[]

IResultObject

メモ

この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_SoftwareUpdate」を参照してください。

関連リンク

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