Get-CMSoftwareUpdate

ソフトウェア更新プログラムを取得します。

構文

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 つ以上のソフトウェア更新プログラムを取得します。

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

注意

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

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

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

Get-CMSoftwareUpdate -IsContentProvisioned $True

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

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

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

パラメーター

-ArticleId

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-BulletinId

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-Category

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

Type:IResultObject[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-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

-Fast

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

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

Type:SwitchParameter
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

-Id

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

Type:Int32
Aliases:CIId, CI_ID
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

-IsSupersed

このパラメーターを設定 $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

-Name

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

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

  • *: 複数の文字
  • ?: 1 文字
Type:String
Aliases:LocalizedDisplayName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-OnlyExpired

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Severity

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

Type:CustomSeverityType
Accepted values:None, Low, Moderate, Important, Critical
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UpdateGroup

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

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-UpdateGroupId

ソフトウェア更新グループの ID の配列を指定します。 この値は、ソフトウェア CI_ID グループ の構成アイテム ID または構成アイテム ID です。 たとえば、「 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

-Vendor

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject[]

IResultObject

メモ

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