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 クラス」を参照してください。