SMS_Advertisement サーバー WMI クラス

SMS_Advertisement Windows Management Instrumentation (WMI) クラスは、Configuration Manager の SMS プロバイダー サーバー クラスであり、クライアントで実行できるソフトウェア パッケージ プログラムを案内するために使用される提供情報を表します。

次の構文は、マネージ オブジェクト形式 (MOF) コードから簡素化されたもので、継承されたプロパティがすべて含まれます。

構文

Class SMS_Advertisement : SMS_BaseClass
{
      UInt32 ActionInProgress;
      UInt32 AdvertFlags;
      String AdvertisementID;
      String AdvertisementName;
      SMS_ScheduleToken AssignedSchedule[];
      Boolean AssignedScheduleEnabled;
      Boolean AssignedScheduleIsGMT;
      UInt32 AssignmentID;
      String CollectionID;
      String Comment;
      UInt32 DeviceFlags;
      DateTime ExpirationTime;
      Boolean ExpirationTimeEnabled;
      Boolean ExpirationTimeIsGMT;
      String HierarchyPath;
      Boolean IncludeSubCollection;
      UInt8 ISVData[];
      UInt32 ISVDataSize;
      String ISVString;
      UInt32 MandatoryCountdown;
      UInt32 OfferType;
      String PackageID;
      DateTime PresentTime;
      Boolean PresentTimeEnabled;
      Boolean PresentTimeIsGMT;
      UInt32 Priority;
      String ProgramName;
      UInt32 RemoteClientFlags;
      String SourceSite;
      UInt32 TimeFlags;
};

メソッド

次の表に、 SMS_Advertisement クラスのメソッドを示します。

プロパティ

ActionInProgress

データ型: UInt32

アクセスの種類: 読み取り専用

修飾子: [読み取り、列挙]

Configuration Manager によってパッケージに対して実行されている現在のアクション。 使用可能な値は次のとおりです。

AdvertFlags

データ型: UInt32

アクセスの種類: 読み取り/書き込み

修飾子: [bits]

ユーザーに提供情報をアナウンスする方法を示すフラグ。 使用可能な値を以下に示します。 既定値は 0 です。

これらのフラグは、アドバタイズされるプログラムの ProgramFlags プロパティで指定されているフラグと調整する必要があります。 たとえば、ONUSERLOGOFF を設定する場合は、プログラムの NOUSERLOGGEDIN フラグを設定する必要があります。 フラグ設定が一致しない場合、プログラムはアドバタイズされません。 詳細については、「 SMS_Program サーバー WMI クラス」を参照してください。

IMMEDIATE、ONUSERLOGON、または ONUSERLOGOFF を設定するか、 AssignedSchedule 値を指定すると、アドバタイズされるプログラムが必須になります。 クライアントが提供情報を受け取ると、必須のプログラムが自動的に実行されます。 クライアントはインストールを拒否したり延期したりすることはできません。

IMMEDIATE、ONUSERLOGON、または ONUSERLOGOFF ビットが設定されている場合、またはプログラムに AssignedSchedule 値がある場合にのみ、NO_DISPLAY ビットと ONSLOWNET ビットを設定します。

割り当てとは無関係にプログラムを実行させない場合は、NO_DISPLAYを設定します。 このフラグを設定しない場合、提供情報は提供情報の一覧に表示され、割り当てとは無関係に実行できます。 プログラムは引き続き必須です。

コンピューターがモデムを使用して接続する場合など、低速のネットワーク接続で割り当てが必要な場合は、ONSLOWNET を設定します。

AdvertisementID

データ型: String

アクセスの種類: 読み取り/書き込み

修飾子: [key, ResID(801), ResDLL("SMS_RSTT.dll")]

提供情報を識別する一意の自動生成キー。 既定値は "" です。

AdvertisementName

データ型: String

アクセスの種類: 読み取り/書き込み

修飾子: [Not_null]

提供情報の一意でわかりやすい名前。

AssignedSchedule データ型: SMS_ScheduleToken 配列

アクセスの種類: 読み取り/書き込み

Qualifiers: [max(15), lazy]

SMS_ScheduleToken 提供情報がクライアントで必須になる時刻を示すサーバー WMI クラス オブジェクト。

AssignedScheduleEnabled

データ型: Boolean

アクセスの種類: 読み取り/書き込み

修飾子: [lazy]

true AssignedSchedule プロパティで定義されているスケジュールがアクティブな場合。 既定値は false です。

AssignedScheduleIsGMT

データ型: Boolean

アクセスの種類: 読み取り/書き込み

修飾子: [lazy]

true AssignedSchedule プロパティで定義されているスケジュールが世界計量法 (UMT) の場合。 既定値は false です。

AssignmentID

データ型: UInt32

アクセスの種類: 読み取り専用

修飾子: [読み取り]

提供情報に関連付けられている割り当ての ID。

CollectionID

データ型: String

アクセスの種類: 読み取り/書き込み

修飾子: [Not_null]

提供情報の対象の既存のコレクション。

Comment

データ型: String

アクセスの種類: 読み取り/書き込み

修飾子: なし

広告に関する簡単な説明またはメモ。 既定値は "" です。

DeviceFlags

データ型: UInt32

アクセスの種類: 読み取り/書き込み

修飾子: なし

デバイスを説明するフラグ。 使用可能な値を以下に示します。 既定値は 0 です。

ExpirationTime

データ型: DateTime

アクセスの種類: 読み取り/書き込み

修飾子: なし

クライアントが提供情報を使用できなくなった日時。 既定値は 19900101000000.000000+**** です。

ExpirationTimeEnabled

データ型: Boolean

アクセスの種類: 読み取り/書き込み

修飾子: [lazy]

true ExpirationTime プロパティで示される時刻に提供情報の有効期限が切れた場合。 既定値は false です。

ExpirationTimeIsGMT

データ型: Boolean

アクセスの種類: 読み取り/書き込み

修飾子: [lazy]

true ExpirationTime プロパティで定義された時間が UMT の場合。 既定値は false です。

HierarchyPath

データ型: String

アクセスの種類: 読み取り/書き込み

修飾子: なし

予約済み。

IncludeSubCollection

データ型: Boolean

アクセスの種類: 読み取り/書き込み

修飾子: なし

true (既定) 指定されたコレクションのサブコレクションに提供情報が公開される場合は。

ISVData

データ型: Uint8 配列

アクセスの種類: 読み取り/書き込み

修飾子: [large, lazy]

単一の ISV が SMS_Program インスタンスに関連するデータを格納できるようにする情報。 このデータには制限や定義された形式はありません。 ただし、ISV の所有権が確立された後は、プロパティを上書きしないことが重要です。 したがって、呼び出し元アプリケーションは、最初にこのプロパティの既存のデータを読み取る必要があります。 データがアプリケーションに属していない場合は、変更しないでください。 このプロパティを使用している ISV またはアプリケーション所有者は、所有権を簡単に確立できるように、データに識別子を含める必要があります。

ISVDataSize

データ型: UInt32

アクセスの種類: 読み取り/書き込み

修飾子: [lazy]

ISVData プロパティによって表されるデータのサイズ。 既定値は 0 です。

ISVString

データ型: String

アクセスの種類: 読み取り/書き込み

修飾子: なし

パートナー拡張機能の文字列。

MandatoryCountdown

データ型: UInt32

アクセスの種類: 読み取り/書き込み

修飾子: なし

オペレーティング システムの展開ユーザー通知の必須スケジュールのカウントダウンを表示する期間 (分単位)。 既定値は 0 です。

OfferType

データ型: UInt32

アクセスの種類: 読み取り/書き込み

修飾子: [列挙型]

提供情報がユーザーをターゲットにしていることを示す提供情報の種類。

PackageID

データ型: String

アクセスの種類: 読み取り/書き込み

修飾子: [Not_null]

提供情報に関連付けられている既存のパッケージの ID。 値は大文字にする必要があります。

PresentTime

データ型: DateTime

アクセスの種類: 読み取り/書き込み

修飾子: なし

広告がクライアントに提供される日時。 既定値は 19900101000000.000000+**** です。

PresentTimeEnabled

データ型: Boolean

アクセスの種類: 読み取り/書き込み

修飾子: [lazy]

true(既定) 現在の時刻が Configuration Manager によって適用される場合。

PresentTimeIsGMT

データ型: Boolean

アクセスの種類: 読み取り/書き込み

修飾子: [lazy]

true PresentTime プロパティで定義された時間が UMT の場合。 既定値は false です。

Priority

データ型: UInt32

アクセスの種類: 読み取り/書き込み

修飾子: [列挙型]

提供情報を子サイトにレプリケートするために使用される優先度。 使用可能な値を以下に示します。 既定値は NORMAL (2) です。

ProgramName

データ型: String

アクセスの種類: 読み取り/書き込み

修飾子: [Not_null]

指定されたパッケージ (PackageID) 内のプログラムが公開されます。

RemoteClientFlags

データ型: UInt32

アクセスの種類: 読み取り/書き込み

修飾子: [bits]

クライアントが配布ポイントにローカルまたはリモートで接続されている場合にプログラムがどのように実行されるかを指定するフラグ。 使用可能な値を以下に示します。 既定値は 48 です。

SourceSite

データ型: String

アクセスの種類: 読み取り専用

修飾子: [読み取り]

広告の発生元サイトの 3 文字のサイト コード。

TimeFlags

データ型: UInt32

アクセスの種類: 読み取り専用

修飾子: [読み取り、ビット]

内部使用のため予約済みです。 時間関連のプロパティの情報を重複させるフラグ。 使用可能な値を以下に示します。 たとえば、 PresentTimeEnabled が true に等しい場合、ENABLE_PRESENT が設定されます。

注釈

このクラスのクラス修飾子は次のとおりです。

• セキュリティで保護

  「プロパティ」セクションに含まれるクラス修飾子とプロパティ修飾子の両方の詳細については、「Configuration Manager のクラスとプロパティ修飾子」を参照してください。

  その他のキー プロパティはありませんが、プロパティ AdvertisementName、 CollectionID、 PackageID、および ProgramName は NOT_NULL として修飾され、値を指定する必要があります。 クラス インスタンスの作成後にアプリケーションでこれらのプロパティを更新することはできません。 これらの値を変更するには、アプリケーションでインスタンスを削除し、正しい値を持つ新しいインスタンスを作成する必要があります。

要件

ランタイム要件

詳細については、「Configuration Manager サーバー ランタイム要件」を参照してください。

開発要件

詳細については、「Configuration Manager サーバー開発の要件」を参照してください。