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 つ以上のソフトウェア更新プログラムを取得します。
詳細については、コア ドキュメントの 「ソフトウェア更新プログラム管理ドキュメント 」を参照してください。
注:
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」を参照してください。