SMS_Advertisement サーバー WMI クラス

[アーティクル]
04/04/2023

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 示します。

メソッド	説明
クラス SMS_Advertisementの GetAdvertisements メソッド	リソースを対象とするアドバタイズ ID を取得します。
クラス SMS_Advertisementの GetNextID メソッド	次に作成される提供情報に使用される ID 番号を取得します。
クラス SMS_Advertisementの RiskyDeploymentStatusMessage メソッド	ユーザーの展開に関する警告状態メッセージを危険なコレクションに送信します。
クラス SMS_Advertisement の SetNextID メソッド	次に作成される提供情報に使用する ID 番号を設定します。
クラス SMS_Advertisementの SetSourceSite メソッド	提供情報のソースサイトコードを設定します。
クラス SMS_Advertisementの Unlock メソッド	ソースサイトを現在のサイトに設定し、アドバタイズのロックを解除します。警告：このメソッドは非推奨です。

プロパティ

`ActionInProgress`

データ型: UInt32

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

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

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

値	説明
0	なし
1	UPDATE
2	追加

`AdvertFlags`

データ型: UInt32

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

修飾子: [bits]

広告をユーザーに通知する方法を示すフラグ。使用可能な値を次に示します。既定値は 0 です。

16 進数 (ビット)	説明
0x00000020 (5)	即時。広告を直ちにユーザーに通知します。
0x00000100 (8)	ONSYSTEMSTARTUP。システム起動時にユーザーに提供情報をアナウンスします。
0x00000200 (9)	ONUSERLOGON。ログオン時にユーザーに提供情報を通知します。
0x00000400 (10)	ONUSERLOGOFF。ログオフ時にユーザーに提供情報をアナウンスします。
0x00001000 (12)	OPTIONALPREDOWNLOAD。選択したアーキテクチャと言語がクライアントのアーキテクチャと一致する場合、パッケージコンテンツは事前にダウンロードされます
0x00008000 (15)	WINDOWS_CE。アドバタイズはデバイスクライアント用です。
0x00010000 (16)	ENABLE_PEER_CACHING。この情報は、System Center 2012 Configuration Manager SP1 以降、および System Center 2012 R2 Configuration Manager 以降に適用されます。
0x00020000 (17)	DONOT_FALLBACK。保護されていない配布ポイントにフォールバックしないでください。
0x00040000 (18)	ENABLE_TS_FROM_CD_AND_PXE。タスクシーケンスは、リムーバブルメディアとブート前実行環境 (PXE) サービスポイントで使用できます。
0x00080000 (19)	APTシントラNETONLY。
0x00100000 (20)	OVERRIDE_SERVICE_WINDOWS。ユーザーに提供情報を発表する場合は、メンテナンス期間をオーバーライドします。
0x00200000 (21)	REBOOT_OUTSIDE_OF_SERVICE_WINDOWS。メンテナンス期間外に再起動します。
0x00400000 (22)	WAKE_ON_LAN_ENABLED。 Wake On LAN が有効になっているユーザーに広告をアナウンスします。
0x00800000 (23)	SHOW_PROGRESS。タスクシーケンスの進行状況を示す広告をユーザーに読み上げる。
0x02000000 (25)	NO_DISPLAY。ユーザーは、割り当てとは別にプログラムを実行しないでください。
0x04000000 (26)	ONSLOWNET。低速ネットワーク接続では、割り当てが必須です。
0x10000000 (28)	TARGETTOWINPE。このデプロイを WinPE のみにターゲットにします。
0x20000000 (29)	HIDDENINWINPE。このデプロイを WinPE のみにターゲットにしますが、WinPE では非表示にします。 TS 変数 SMSTSPreferredAdvertID でのみ使用できます。

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

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

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

ユーザーが割り当てとは別にプログラムを実行しない場合は、NO_DISPLAYを設定します。このフラグを設定しない場合、アドバタイズはアドバタイズの一覧に表示され、割り当てとは別に実行できます。プログラムは引き続き必須です。

低速ネットワーク接続で割り当てが必須である場合 (たとえば、コンピューターがモデムを使用して接続する場合など) に ONSLOWNET を設定します。

`AdvertisementID`

データ型: String

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

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

アドバタイズを識別する一意の自動生成キー。既定値は "" です。

`AdvertisementName`

データ型: String

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

修飾子: [Not_null]

広告の一意のわかりやすい名前。

AssignedSchedule
データ型: SMS_ScheduleToken 配列

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

修飾子: [max(15), lazy]

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

`AssignedScheduleEnabled`

データ型: Boolean

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

修飾子: [lazy]

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

`AssignedScheduleIsGMT`

データ型: Boolean

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

修飾子: [lazy]

true プロパティで定義されているスケジュールが AssignedSchedule ユニバーサルメトリック時刻 (UMT) の場合。既定値は false です。

`AssignmentID`

データ型: UInt32

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

修飾子: [read]

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

`CollectionID`

データ型: String

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

修飾子: [Not_null]

アドバタイズの対象となる既存のコレクション。

`Comment`

データ型: String

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

修飾子: なし

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

`DeviceFlags`

データ型: UInt32

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

修飾子: なし

デバイスを記述するフラグ。使用可能な値を次に示します。既定値は 0 です。

16 進数 (ビット)	説明
0x01000000 (24)	常にプログラムをクライアントに割り当てます。
0x02000000 (25)	デバイスが現在高帯域幅接続に接続されている場合にのみ割り当てます (既定値は 60 KBps を超えます)。
0x04000000 (26)	デバイスがドッキングされている場合、つまり ActiveSync を使用しているデスクトップに接続されている場合にのみ割り当てます。

`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

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

修飾子: [列挙型]

広告がユーザーを対象としていることを示す広告の種類。

値	説明
0	必須
2	使用可能

`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) です。

値	説明
1	高
2	通常
3	低

`ProgramName`

データ型: String

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

修飾子: [Not_null]

アドバタイズする指定されたパッケージ (PackageID) 内のプログラム。

`RemoteClientFlags`

データ型: UInt32

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

修飾子: [bits]

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

16 進数 (ビット)	説明
0x00000001 (0)	BATTERY_POWER。バッテリー電源を使用してプログラムを実行します。この値は現在使用されていません。
0x00000002 (1)	RUN_FROM_CD。 CD からプログラムを実行します。この値は現在使用されていません。
0x00000004 (2)	DOWNLOAD_FROM_CD。 CD からプログラムをダウンロードします。この値は現在使用されていません。
0x00000008 (3)	RUN_FROM_LOCAL_DISPPOINT。ローカル配布ポイントからプログラムを実行します。
0x00000010 (4)	DOWNLOAD_FROM_LOCAL_DISPPOINT。ローカル配布ポイントからプログラムをダウンロードします。
0x00000020 (5)	DONT_RUN_NO_LOCAL_DISPPOINT。ローカル配布ポイントがない場合は、プログラムを実行しないでください。
0x00000040 (6)	DOWNLOAD_FROM_REMOTE_DISPPOINT。リモート配布ポイントからプログラムをダウンロードします。
0x00000080 (7)	RUN_FROM_REMOTE_DISPPOINT。リモート配布ポイントからプログラムを実行します。
0x00000100 (8)	DOWNLOAD_ON_DEMAND_FROM_LOCAL_DP。ローカル配布ポイントからオンデマンドでプログラムをダウンロードします。これは、タスクシーケンスにのみ適用されます。
0x00000200 (9)	DOWNLOAD_ON_DEMAND_FROM_REMOTE_DP。リモート配布ポイントからオンデマンドでプログラムをダウンロードします。これは、タスクシーケンスにのみ適用されます。
x00000400 (10)	BALLOON_REMINDERS_REQUIRED。バルーンリマインダーが必要です。
0x00000800 (11)	RERUN_ALWAYS。常にプログラムを再実行します。
0x00001000 (12)	RERUN_NEVER。プログラムを再実行しないでください。
0x00002000 (13)	RERUN_IF_FAILED。実行が以前に失敗した場合は、プログラムを再実行します。
0x00004000 (14)	RERUN_IF_SUCCEEDED。実行が以前に成功した場合は、プログラムを再実行します。
0x00008000 (15)	PERSIST_ON_WRITE_FILTER_DEVICES この情報は、System Center 2012 Configuration Manager SP1 以降、および System Center 2012 R2 Configuration Manager 以降に適用されます。
0x00020000 (17)	T_FALLBACKしないこの情報は、System Center 2012 Configuration Manager SP1 以降、および System Center 2012 R2 Configuration Manager 以降に適用されます。
0x00040000 (18)	DP_ALLOW_METERED_NETWORK この情報は、System Center 2012 Configuration Manager SP1 以降、および System Center 2012 R2 Configuration Manager 以降に適用されます。

`SourceSite`

データ型: String

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

修飾子: [read]

広告が発信されるサイトの 3 文字のサイトコード。

`TimeFlags`

データ型: UInt32

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

修飾子: [read, bits]

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

16 進数 (ビット)	説明
0x00000001 (0)	ENABLE_PRESENT
0x00000002 (1)	ENABLE_EXPIRATION
0x00000004 (2)	ENABLE_AVAILABLE
0x00000008 (3)	ENABLE_UNAVAILABLE
0x00000010 (4)	ENABLE_MANDATORY
0x00000020 (5)	GMT_PRESENT
0x00000040 (6)	GMT_EXPIRATION
0x00000080 (7)	GMT_AVAILABLE
0x00000100 (8)	GMT_UNAVAILABLE
0x00000200 (9)	GMT_MANDATORY

注釈

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

セキュリティで保護

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

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

要件

ランタイム要件

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

開発要件

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

次の方法で共有

SMS_Advertisement サーバー WMI クラス

構文

メソッド

プロパティ

ActionInProgress

AdvertFlags

AdvertisementID

AdvertisementName

AssignedScheduleEnabled

AssignedScheduleIsGMT

AssignmentID

CollectionID

Comment

DeviceFlags

ExpirationTime

ExpirationTimeEnabled

ExpirationTimeIsGMT

HierarchyPath

IncludeSubCollection

ISVData

ISVDataSize

ISVString

MandatoryCountdown

OfferType

PackageID

PresentTime

PresentTimeEnabled

PresentTimeIsGMT

Priority

ProgramName

RemoteClientFlags

SourceSite

TimeFlags

注釈

要件

ランタイム要件

開発要件

フィードバック

フィードバック

その他のリソース

`ActionInProgress`

`AdvertFlags`

`AdvertisementID`

`AdvertisementName`

`AssignedScheduleEnabled`

`AssignedScheduleIsGMT`

`AssignmentID`

`CollectionID`

`Comment`

`DeviceFlags`

`ExpirationTime`

`ExpirationTimeEnabled`

`ExpirationTimeIsGMT`

`HierarchyPath`

`IncludeSubCollection`

`ISVData`

`ISVDataSize`

`ISVString`

`MandatoryCountdown`

`OfferType`

`PackageID`

`PresentTime`

`PresentTimeEnabled`

`PresentTimeIsGMT`

`Priority`

`ProgramName`

`RemoteClientFlags`

`SourceSite`

`TimeFlags`