SMS_PackageBaseclass Windows Management Instrumentation (WMI) クラスは、Configuration Manager では SMS プロバイダーのサーバー クラスであり、サーバー WMI クラス、サーバー WMIクラスSMS_DriverPackage、サーバー WMI クラス、SMS_BootImagePackage SMS_SoftwareUpdatesPackage サーバー WMI クラスなど、すべてのパッケージの抽象基本クラスとして機能します。
構文
Class SMS_PackageBaseclass : SMS_BaseClass
{
UInt32 ActionInProgress;
String AlternateContentProviders;
String Description;
UInt8 ExtendedData[];
UInt32 ExtendedDataSize;
UInt32 ForcedDisconnectDelay;
Boolean ForcedDisconnectEnabled;
UInt32 ForcedDisconnectNumRetries;
UInt8 Icon[];
UInt32 IconSize;
Boolean IgnoreAddressSchedule;
UInt8 ISVData[];
UInt32 ISVDataSize;
String ISVString;
String Language;
DateTime LastRefreshTime;
String LocalizedCategoryInstanceNames[];
String Manufacturer;
String MIFFilename;
String MIFName;
String MIFPublisher;
String MIFVersion;
String Name;
UInt32 NumOfPrograms;
String PackageID;
UInt32 PackageSize;
UInt32 PackageType;
UInt32 PkgFlags;
UInt32 PkgSourceFlag;
String PkgSourcePath;
String PreferredAddressType;
UInt32 Priority;
Boolean RefreshPkgSourceFlag;
SMS_ScheduleToken RefreshSchedule[];
String SecuredScopeNames[];
String SedoObjectVersion;
String ShareName;
UInt32 ShareType;
DateTime SourceDate;
String SourceSite;
UInt32 SourceVersion;
String StoredPkgPath;
UInt32 StoredPkgVersion;
String Version;
};
メソッド
SMS_PackageBaseclass クラスはメソッドを定義しません。
プロパティ
ActionInProgress'
データ型: UInt32
アクセスの種類: 読み取り専用
修飾子: [読み取り]
Configuration Manager によってパッケージに対して実行されている現在のアクション。 使用可能な値は次のとおりです。
| 値 | 説明 |
|---|---|
| 0 | なし |
| 1 | UPDATE |
| 2 | 追加 |
| 3 | DELETE |
AlternateContentProviders
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: [large, lazy]
代替コンテンツ プロバイダー設定を設定するための XML 文字列。 このプロパティは、ソフトウェア更新プログラム パッケージまたはドライバー パッケージには適用されません。
説明
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
パッケージの長い説明。
ExtendedData
データ型: UInt8 配列
アクセスの種類: 読み取り/書き込み
修飾子: [large, lazy]
イメージ配置用の XML BLOB。
ExtendedDataSize
データ型: UInt32
アクセスの種類: 読み取り/書き込み
修飾子: [lazy]
パッケージの拡張データのサイズ。 既定値は 0 です。
ForcedDisconnectDelay
データ型: UInt32
アクセスの種類: 読み取り/書き込み
修飾子: なし
Configuration Manager がユーザーを配布ポイント共有から強制的に切断するまでの待機時間 (分単位)。 既定値は 5 分です。
ForcedDisconnectEnabled
データ型: Boolean
アクセスの種類: 読み取り/書き込み
修飾子: なし
trueパッケージ ソース ファイルの更新、更新、または削除中に共有違反が発生した場合に、Configuration Manager がユーザーを配布ポイント共有から強制的に切断する必要がある場合。 既定値は false です。
注:
このプロパティは慎重に有効にしてください。 ユーザーを強制的に切断すると、クライアントに悪影響を及ぼす可能性があります。
ForcedDisconnectNumRetries
データ型: UInt32
アクセスの種類: 読み取り/書き込み
修飾子: なし
Configuration Manager がユーザーを配布ポイント共有から切断しようとする回数。 既定の再試行回数は 2 です。
アイコン
データ型: UInt8 配列
アクセスの種類: 読み取り/書き込み
Qualifiers: [large]
省略可能。 パッケージに使用するアイコンを含むファイルを表す配列。 このアイコンを使用した場合、このアイコンによって Configuration Manager コンソールの既定のパッケージ アイコンが置き換えられます。
IconSize
データ型: UInt32
アクセスの種類: 読み取り/書き込み
修飾子: [lazy]
アイコンのサイズ (バイト単位)。 既定値は 0 です。 アイコンをクリアするには、このプロパティを 0 に設定します。
IgnoreAddressSchedule
データ型: Boolean
アクセスの種類: 読み取り/書き込み
修飾子: なし
trueConfiguration Manager が PreferredAddressType で指定された送信者のスケジュールを無視する場合。 既定値は false です。
ISVData
データ型: UInt8 配列
アクセスの種類: 読み取り/書き込み
修飾子: [large, lazy]
ISV 拡張性データ。
ISVDataSize
データ型: UInt32
アクセスの種類: 読み取り/書き込み
修飾子: [lazy]
ISVData のサイズ (バイト単位)。 既定値は 0 です。
ISVString
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
パートナー拡張機能の文字列。
言語
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
パッケージの言語。 このプロパティは、本体でパッケージを識別するために Manufacturer、 Name、 Version と共に使用されます。 たとえば、同じパッケージの英語版とドイツ語版があるとします。
LastRefreshTime
データ型: DateTime
アクセスの種類: 読み取り専用
修飾子: [読み取り]
パッケージ ソースが配布ポイントで最後に更新された日時。
LocalizedCategoryInstanceNames
データ型: String 配列
アクセスの種類: 読み取り専用
修飾子: [読み取り]
構成項目が属するカテゴリのローカライズされた名前。
製造元
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
パッケージの製造元 (パブリッシャー)。
MIFFilename
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
パッケージの状態を含む管理情報形式 (MIF) ファイルの名前。
MIFName
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
パッケージのプログラムの状態を含む MIF ファイルの名前。 ファイル名拡張子は .mif である必要があります。 詳細については、後述の「解説」セクションを参照してください。
MIFPublisher
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
パッケージのソフトウェア発行元の名前。
MIFVersion
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
パッケージのバージョン番号。
名前
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
パッケージの名前。 既定の名前は "" です。
NumOfPrograms
データ型: UInt32
アクセスの種類: 読み取り/書き込み
修飾子: なし
パッケージに含まれるプログラムの数。
PackageID
データ型: String
アクセスの種類: [キー]
プログラム、提供情報、および配布ポイントをパッケージに関連付けるために使用される一意の自動生成キー。
PackageSize
データ型: UInt32
アクセスの種類: 読み取り
パッケージのサイズ。
PackageType
データ型: UInt32
アクセスの種類: 読み取り/書き込み
修飾子: なし
パッケージの種類。 使用可能な値は次のとおりです。
| 値 | 説明 |
|---|---|
| 0 | 通常のソフトウェア配布パッケージ |
| 3 | ドライバー パッケージ |
| 4 | タスク シーケンス パッケージ |
| 5 | ソフトウェア更新プログラム パッケージ |
| 6 | デバイス設定パッケージ |
| 7 | 仮想アプリケーション パッケージ |
| 8 | アプリケーション パッケージ |
| 257 | イメージ パッケージ |
| 258 | ブート イメージ パッケージ |
| 259 | OS アップグレード パッケージ |
PkgFlags
データ型: UInt32
アクセスの種類: 読み取り/書き込み
修飾子: [bits]
パッケージの特別なプロパティを指定するフラグ。 使用可能な値は次のとおりです。
| 16 進数 (ビット) | 説明 |
|---|---|
| 0x0100011 (23) | DO_NOT_ENCRYPT_CONTENT_ON_CLOUD。 クラウド上のコンテンツを暗号化しないでください。 この情報は、System Center 2012 Configuration Manager SP1 以降、および System Center 2012 R2 Configuration Manager 以降に適用されます。 |
| 0x01000000 (24) | DO_NOT_DOWNLOAD。 パッケージは配布ポイントの分岐にダウンロードしないでください。これは事前にステージングされます。 |
| 0x02000000 (25) | PERSIST_IN_CACHE。 パッケージをキャッシュに保持します。 |
| 0x04000000 (26) | USE_BINARY_DELTA_REP。 バイナリ デルタ レプリケーションを使用して配布マネージャーによってレプリケートされるパッケージをマークします。 |
| 0x10000000 (28) | NO_PACKAGE。 パッケージには配布ポイントは必要ありません。 |
| 0x20000000 (29) | USE_SPECIAL_MIF。 この値は、Configuration Manager が MIF ファイルの状態の照合に MIFName、MIFPublisher、および MIFVersion を使用するかどうかを決定します。 それ以外の場合、Configuration Manager は、ステータス照合に Name、Manufacturer、および Version を使用します。 詳細については、後述の「解説」セクションを参照してください。 |
| 0x40000000 (30) | DISTRIBUTE_ON_DEMAND。 パッケージは、ブランチ配布ポイントへのオンデマンド配布が許可されています。 |
PkgSourceFlag
データ型: UInt32
アクセスの種類: 読み取り/書き込み
修飾子: なし
パッケージ ソース ファイルを読み取る方法を示すフラグ。 使用可能な値を以下に示します。 既定値は STORAGE_NO_SOURCE (1) です。
| 値 | 説明 |
|---|---|
| 0 | STORAGE_NEEDS_SPECIFYING。 ユーザーがソース ファイル ストレージを指定します。 |
| 1 | STORAGE_NO_SOURCE。 プログラムがソース ファイルを使用しない。 |
| 2 | STORAGE_DIRECT。 圧縮せずにソース ファイルをソースから直接取得します。 このフラグは、ソース ファイルがローカル サーバー上にある場合、または永続ストレージの場所への汎用名前付け規則 (UNC) パスが指定されている場合に使用します。 |
| 3 | STORAGE_COMPRESS。 このフラグは廃止されました。 |
| 4 | STORAGE_LOCAL。 ローカル ソースからソース ファイルを取得します。 |
PkgSourcePath
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
パッケージによって表される更新プログラム コンテンツのファイルの場所。 場所は、完全なローカル パスまたは UNC パスのいずれかです。 この場所に、スクリプトを含め、プログラムを完了するために必要なすべてのファイルとサブディレクトリが含まれていることを確認します。
PreferredAddressType
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
パッケージ ソース ファイルを配布ポイントにコピーするときに使用する優先送信者。 使用可能な値を以下に示します。 値が指定されていない場合、Configuration Manager によって使用する送信者が決定されます。
- ADDR_NONE()
- ADR_LAN(MS_LAN)
- ADDR_MAPI(MS_MAPI)
- ADDR_RAS_ASYNC(MS_ASYNC_RAS)
- ADDR_RAS_ISDN(MS_ISDN_RAS)
- ADDR_RAS_X25(MS_X25_RAS)
- ADDR_RAS_SNA(MS_SNA_RAS)
- ADDR_SNA_BATCH(MS_BATCH_SNA)
- ADDR_SNA_INTER(MS_INTER_SNA)
- ADDR_COURIER(MS_COURIER)
優先度
データ型: UInt32
アクセスの種類: 読み取り/書き込み
修飾子: なし
パッケージの優先順位を送信します。 設定できる値は、SMS_Advertisement サーバー WMI クラスの Priority プロパティに対して定義されています。
RefreshPkgSourceFlag
データ型: Boolean
アクセスの種類: 読み取り/書き込み
修飾子: [lazy]
trueConfiguration Manager がパッケージのソース ファイルを更新する必要がある場合。 既定値は false です。 このプロパティには、読み取られるときに常に false が含まれます。
このプロパティを true に設定すると、 クラス SMS_Package で RefreshPkgSource メソッドを呼び出すのと同じ効果があります。
このプロパティを使用してパッケージ ソース ファイルを更新しないでください。 代わりに、 RefreshPkgSource メソッドを使用します。
RefreshSchedule
データ型: SMS_ScheduleToken 配列
アクセスタイプ: [max(15), lazy]
配布ポイントでパッケージ ソース ファイルをいつ更新するかを定義するSMS_ScheduleTokenConfiguration Managerオブジェクトの埋め込み配列。 更新スケジュールは、 PkgSourceFlag がSTORAGE_DIRECTされている場合にのみ指定できます。
SecuredScopeNames
データ型: String 配列
アクセスの種類: 読み取り専用
修飾子: [読み取り]
パッケージが属するセキュリティ スコープを表します。
SedoObjectVersion
データ型: String
アクセスの種類: 読み取り専用
修飾子: [読み取り]
オブジェクトを更新するときにデータベース内のオブジェクト バージョンと比較するために使用されるオブジェクト バージョン。 オブジェクトのバージョンが一致しない場合、更新は失敗します。
ShareName
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
配布ポイントで使用する共有。 名前にはディレクトリを含めることができます。 ディレクトリが存在しない場合は、Configuration Manager によって作成されます。
ShareType を SHARE_SPECIFIC に設定する場合は、共有名を指定する必要があります。
ShareType
データ型: UInt32
アクセスの種類: 読み取り/書き込み
修飾子: なし
パッケージを共有するときに配布ポイントによって使用される共有の種類。 使用可能な値を以下に示します (既定値は SHARE_COMMON)。 SHARE_SPECIFIC を指定する場合は、 ShareName の値を指定する必要があります。
| 値 | 説明 |
|---|---|
| 1 | SHARE_COMMON |
| 2 | SHARE_SPECIFIC |
SourceDate
データ型: DateTime
アクセスの種類: 読み取り専用
修飾子: [読み取り]
配布ポイントでパッケージ ソース ファイルが最後に更新された日時。
SourceSite
データ型: String
アクセスの種類: 読み取り専用
修飾子: [読み取り]
パッケージが作成されたサイトのサイト コード。
SourceVersion
データ型: UInt32
アクセスの種類: 読み取り専用
修飾子: [読み取り]
サイトで使用できるパッケージのバージョン。 パッケージが更新されたとき、またはソース ファイルが更新されたときにインクリメントされます。
StoredPkgPath
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
Configuration Manager がサイト サーバー上のソース ファイルの圧縮版を格納する場所への完全パス。 このパスは、PkgSourceFlag の値が STORAGE_COMPRESS のときに Configuration Manager によって設定されます。
StoredPkgVersion
データ型: UInt32
アクセスの種類: 読み取り/書き込み
修飾子: なし
保存されているパッケージの圧縮されたソース ファイルのバージョン。 既定値は 0 です。
バージョン
データ型: String
アクセスの種類: 読み取り/書き込み
修飾子: なし
パッケージのバージョン。
注釈
このクラスのクラス修飾子は次のとおりです。
- 要約
「プロパティ」セクションに含まれるクラス修飾子とプロパティ修飾子の両方の詳細については、「Configuration Manager のクラスとプロパティ修飾子」を参照してください。
PkgFlags プロパティのUSE_SPECIAL_MIFフラグを設定した場合、Configuration Manager は %TEMP% ディレクトリまたは %windir% ディレクトリで、MIFFileName プロパティに指定されているインストール状態 MIF ファイルを検索します。 Configuration Manager でファイルが見つからない場合は、それらのディレクトリ内のすべての MIF ファイルが検索されます。 大文字と小文字を区別しない比較では、 MIFName、 MIFPublisher、 MIFVersion の値と MIF ファイルで指定された値が比較されます。 一致するものが見つかった場合、MIF ファイルで指定された状態がプログラムのインストール状態として使用され、プログラムが正常に実行されたかどうかを示します。 一致するものが見つからない場合、またはUSE_SPECIAL_MIFが指定されていない場合、Configuration Manager Configuration Manager はプログラム終了コードを使用してプログラムのインストール状況を設定します。 終了コード 0 は成功と見なされます。 その他の値は、アプリケーション固有のエラー コードと見なされます。
要件
ランタイム要件
詳細については、「Configuration Manager サーバー ランタイム要件」を参照してください。
開発要件
詳細については、「Configuration Manager サーバー開発の要件」を参照してください。