CCM_SoftwareUpdate
WMI クラスは、ソフトウェア更新プログラムを表すConfiguration Managerのクライアント クラスです。
このクラスを列挙すると、適用可能であり、インストールする必要があるすべての更新プログラムが提供されます。 を使用 GetObject
して、 プロパティに基づいて個々の更新プログラムのクエリを UpdateID
実行できます。 各更新オブジェクトには、古い COM インターフェイスと同等のプロパティがあります ICCMTargetedUpdate
。 個々のプロパティの詳細については、「Configuration Manager 2007 ICCMTargetedUpdate インターフェイス」を参照してください。 ここでは、クラスと CCM_SoftwareUpdate
クラスのICCMTargetedUpdate
違いのみを示します。
重要
ソフトウェア更新クライアント側 SDK は、Configuration Managerサイト サーバーからクライアントに展開され、適用可能であり、まだクライアントにインストールされていない更新プログラムのセットのみを返します。
次の構文は、マネージド オブジェクト形式 (MOF) コードから簡略化され、継承されたすべてのプロパティが含まれています。
構文
class CCM_SoftwareUpdate : CCM_SoftwareBase
{
String ArticleID;
String BulletinID;
UInt32 ComplianceState;
UInt32 ContentSize;
Datetime Deadline
String Description;
UInt32 ErrorCode;
UInt32 EvaluationState;
Boolean ExclusiveUpdate;
String FullName;
Boolean IsUpgrade;
UInt32 MaxExecutionTime;
String Name;
Datetime NextUserScheduledTime;
Boolean NotifyUser;
Boolean OverrideServiceWindows;
UInt32 PercentComplete;
String Publisher;
Boolean RebootOutsideServiceWindows;
Datetime RestartDeadline;
Datetime StartTime;
String UpdateID;
String URL;
Boolean UserUIExperience;
};
メソッド
クラスは CCM_SoftwareUpdate
メソッドを定義しません。
プロパティ
ArticleID
データ型: String
アクセスの種類: 読み取り専用
修飾子: [read]
ソフトウェア更新プログラムのサポート情報記事の識別子。 この値の最大長は 64 文字です。
BulletinID
データ型: String
アクセスの種類: 読み取り専用
修飾子: [read]
Microsoftによってリリースされたセキュリティ更新プログラムのセキュリティ情報の識別子。 この値の最大長は 64 文字です。 既定値は None
です。
ComplianceState
データ型: UInt32
アクセスの種類: 読み取り専用
修飾子: [read]
ソフトウェア更新プログラムが見つからないか、インストールする必要があるかどうかを示すソフトウェア更新プログラムのコンプライアンス状態。 状態は ciNotPresent
、更新プログラムが見つからない場合を示します。 次の表は、ソフトウェア更新プログラムの ComplianceState プロパティに使用できるその他の値を示しています。 ソフトウェア更新プログラムの管理では、値 0、1、および 2 のみが使用されます。
値 | 状態 |
---|---|
0 | ciNotPresent |
1 | ciPresent |
2 | ciPresenceUnknown (適用されない場合にも使用) |
3 | ciEvaluationError |
4 | ciNotEvaluated |
5 | ciNotUpdated |
6 | ciNotConfigured |
ContentSize
データ型: UInt32
アクセスの種類: 読み取り専用
修飾子: [read]
ソフトウェア更新プログラムのコンテンツのサイズ。
注:
このプロパティは、ソフトウェア更新プログラムが以前ではなく、Configuration Manager キャッシュにダウンロードされた後にのみ使用できます。
Deadline
データ型: Datetime
アクセスの種類: 読み取り専用
修飾子: [read]
ソフトウェア更新プログラムがインストールされている日付と時刻。
Description
データ型: String
アクセスの種類: 読み取り専用
修飾子: [read]
ソフトウェア更新プログラムの説明。
ErrorCode
データ型: UInt32
アクセスの種類: 読み取り専用
修飾子: [read]
ソフトウェア更新プログラムに関連付けられているエラー コード (存在する場合)。
EvaluationState
データ型: UInt32
アクセスの種類: 読み取り専用
修飾子: [read]
ソフトウェア更新プログラムの評価状態。 クラスの CCM_SoftwareUpdatesManager
InstallUpdates メソッドを呼び出してソフトウェア更新プログラムのインストールをトリガーすると、EvaluationState、PercentComplete、ErrorCode プロパティを使用して更新の進行状況を監視できます。
注:
EvaluationState プロパティは、ソフトウェア更新プログラムのコンプライアンス状態を見つけ出すのではなく、進行状況の評価のみを目的としています。 ソフトウェア更新プログラムが進行中の状態でない場合、 EvaluationState の値は none
、過去の任意の時点で進行状況があったかどうかに応じて、 または available
になります。 これはコンプライアンスの状態とは関係ありません。 また、アクティブ化時にソフトウェア更新プログラムがダウンロードされた場合、 EvaluationState の値は です none
。 この値は、ソフトウェア更新プログラムのインストールが試行された後にのみ変更されます。
次の表は、ソフトウェア更新プログラムの EvaluationState プロパティの値を示しています。
値 | 状態 |
---|---|
0 | ciJobStateNone |
1 | ciJobStateAvailable |
2 | ciJobStateSubmitted |
3 | ciJobStateDetecting |
4 | ciJobStatePreDownload |
5 | ciJobStateDownloading |
6 | ciJobStateWaitInstall |
7 | ciJobStateInstalling |
8 | ciJobStatePendingSoftReboot |
9 | ciJobStatePendingHardReboot |
10 | ciJobStateWaitReboot |
11 | ciJobStateVerifying |
12 | ciJobStateInstallComplete |
13 | ciJobStateError |
14 | ciJobStateWaitServiceWindow |
15 | ciJobStateWaitUserLogon |
16 | ciJobStateWaitUserLogoff |
17 | ciJobStateWaitJobUserLogon |
18 | ciJobStateWaitUserReconnect |
19 | ciJobStatePendingUserLogoff |
20 | ciJobStatePendingUpdate |
21 | ciJobStateWaitingRetry |
22 | ciJobStateWaitPresModeOff |
23 | ciJobStateWaitForOrchestration |
ExclusiveUpdate
データ型: Boolean
アクセスの種類: 読み取り専用
修飾子: [read]
true
ソフトウェア更新プログラムが排他的である場合。それ以外の場合は 。 false
排他更新プログラムを他の更新プログラムと同時にインストールすることはできません。
FullName
データ型: String
アクセスの種類: 読み取り専用
修飾子: [read]
このプロパティは使用されません。
IsUpgrade
データ型: Boolean
アクセスの種類: 読み取り/書き込み
修飾子: なし
ソフトウェア更新プログラムがアップグレードであるかどうかを示します。
MaxExecutionTime
データ型: UInt32
アクセスの種類: 読み取り専用
修飾子: [read]
ソフトウェア更新プログラムの実行に必要な最大時間。
Name
データ型: String
アクセスの種類: 読み取り専用
修飾子: [read]
ソフトウェア更新プログラムの名前。
NextUserScheduledTime
データ型: Datetime
アクセスの種類: 読み取り専用
修飾子: [read]
ユーザーが特定のソフトウェア更新プログラムを非営業時間 (NBH) に延期する日時。 このプロパティは、次に使用する NBH を示します。
NotifyUser
データ型: Boolean
アクセスの種類: 読み取り専用
修飾子: [read]
true
ソフトウェア更新プログラムの通知がユーザーに表示される場合。それ以外の場合は 。 false
注:
が にfalse
NotifyUser
設定されている場合UserUIExperience
は、無視されます。
OverrideServiceWindows
データ型: Boolean
アクセスの種類: 読み取り専用
修飾子: [read]
true
メンテナンス期間外にソフトウェア更新プログラムをインストールできる場合。それ以外の場合は 。 false
PercentComplete
データ型: UInt32
アクセスの種類: 読み取り専用
修飾子: [read]
ソフトウェア更新プログラムのインストール完了の割合。
Publisher
データ型: String
アクセスの種類: 読み取り専用
修飾子: [read]
ソフトウェア更新プログラムの発行元。
RebootOutsideServiceWindows
データ型: Boolean
アクセスの種類: 読み取り専用
修飾子: [read]
true
ソフトウェア更新プログラムがメンテナンス期間外に再起動できる場合。それ以外の場合は 。 false
RestartDeadline
データ型: Datetime
アクセスの種類: 読み取り専用
修飾子: [read]
ソフトウェア更新プログラムのインストール後にコンピューターが再起動された日時。
StartTime
データ型: Datetime
アクセスの種類: 読み取り専用
修飾子: [read]
ユーザーがソフトウェア更新プログラムを利用できるようにする日時。
UpdateID
データ型: String
アクセスの種類: 読み取り専用
修飾子: [read]
ソフトウェア更新プログラムの識別子。
URL
データ型: String
アクセスの種類: 読み取り専用
修飾子: [read]
ソフトウェア更新プログラムの URL。
UserUIExperience
データ型: Boolean
アクセスの種類: 読み取り専用
修飾子: [read]
true
ソフトウェア更新プログラムがソフトウェア センターに表示されている場合。それ以外の場合は 。 false
要件
ランタイム要件
詳細については、「クライアント ランタイム要件のConfiguration Manager」を参照してください。
開発要件
詳細については、「Configuration Managerクライアント開発要件」を参照してください。