WMI-Serverklasse SMS_Advertisement

Die SMS_Advertisement WMI-Klasse (Windows Management Instrumentation) ist eine SMS-Anbieterserverklasse im Configuration Manager, die eine Ankündigung zum Ankündigen von Softwarepaketprogrammen darstellt, die für die Ausführung auf Clients verfügbar sind.

Die folgende Syntax wurde aus MOF-Code (Managed Object Format) vereinfacht und enthält alle geerbten Eigenschaften.

Syntax

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;
};

Methoden

In der folgenden Tabelle sind die Methoden in der SMS_Advertisement Klasse aufgeführt.

Eigenschaften

ActionInProgress

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Qualifiers: [read, enumeration]

Aktuelle Aktion, die vom Configuration Manager für das Paket ausgeführt wird. Die folgenden Werte sind möglich:

AdvertFlags

Datentyp: UInt32

Zugriffstyp: Lesen/Schreiben

Qualifier: [bits]

Diese Flags geben an, wie die Ankündigung dem Benutzer angekündigt werden soll. Mögliche Werte sind unten aufgeführt. Der Standardwert ist 0.

Diese Flags müssen mit den Flags koordiniert werden, die in der ProgramFlags Eigenschaft des angekündigten Programms angegeben sind. Wenn Sie z. B. ONUSERLOGOFF festlegen, muss das Flag NOUSERLOGGEDIN im Programm gesetzt werden. Wenn die Flag-Einstellungen nicht übereinstimmen, wird das Programm nicht angekündigt. Weitere Informationen finden Sie unter SMS_Program Server WMI Class.

Wenn Sie IMMEDIATE, ONUSERLOGON oder ONUSERLOGOFF festlegen oder einen AssignedSchedule Wert angeben, wird das angekündigte Programm obligatorisch. Ein obligatorisches Programm wird automatisch ausgeführt, nachdem der Client die Ankündigung erhalten hat. Der Client kann die Installation nicht ablehnen oder verschieben.

Legen Sie die NO_DISPLAY- und ONSLOWNET-Bits nur fest, wenn das IMMEDIATE-, ONUSERLOGON- oder ONUSERLOGOFF-Bit festgelegt ist oder das Programm über einen AssignedSchedule Wert verfügt.

Legen Sie NO_DISPLAY fest, wenn Sie nicht möchten, dass der Benutzer Programme unabhängig von der Zuweisung ausführt. Wenn Sie dieses Kennzeichen nicht setzen, wird die Anzeige in der Liste der Anzeigen angezeigt und kann unabhängig von der Zuordnung ausgeführt werden. Das Programm kann weiterhin verpflichtend sein.

Legen Sie ONSLOWNET fest, wenn Zuweisungen über eine langsame Netzwerkverbindung obligatorisch sind, z. B. wenn ein Computer eine Verbindung über ein Modem herstellt.

AdvertisementID

Datentyp: String

Zugriffstyp: Lesen/Schreiben

Qualifiers: [key, ResID(801), ResDLL("SMS_RSTT.dll")]

Eindeutiger, automatisch generierter Schlüssel, der die Ankündigung identifiziert. Der Standardwert ist "".

AdvertisementName

Datentyp: String

Zugriffstyp: Lesen/Schreiben

Qualifikanten: [Not_null]

Eindeutiger, benutzerfreundlicher Name für die Werbung.

AssignedSchedule Datentyp: SMS_ScheduleToken Array

Zugriffstyp: Lesen/Schreiben

Qualifier: [max(15), faul]

SMS_ScheduleToken WMI-Class-Objekte des Servers , die den Zeitpunkt angeben, zu dem die Ankündigung auf den Clients obligatorisch wird.

AssignedScheduleEnabled

Datentyp: Boolean

Zugriffstyp: Lesen/Schreiben

Qualifikanten: [faul]

true wenn der in der AssignedSchedule Eigenschaft definierte Zeitplan aktiv ist. Der Standardwert ist false.

AssignedScheduleIsGMT

Datentyp: Boolean

Zugriffstyp: Lesen/Schreiben

Qualifikanten: [faul]

true wenn der in der AssignedSchedule Eigenschaft definierte Zeitplan in Universal Metric Time (UMT) angegeben ist. Der Standardwert ist false.

AssignmentID

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

ID der Aufgabe, die der Anzeige zugeordnet ist.

CollectionID

Datentyp: String

Zugriffstyp: Lesen/Schreiben

Qualifikanten: [Not_null]

Vorhandene Sammlung, auf die die Werbung abzielt.

Comment

Datentyp: String

Zugriffstyp: Lesen/Schreiben

Qualifikanten: Keine

Einfache Beschreibung oder Notiz zur Anzeige. Der Standardwert ist "".

DeviceFlags

Datentyp: UInt32

Zugriffstyp: Lesen/Schreiben

Qualifikanten: Keine

Flags, die das Gerät beschreiben. Mögliche Werte sind unten aufgeführt. Der Standardwert ist 0.

ExpirationTime

Datentyp: DateTime

Zugriffstyp: Lesen/Schreiben

Qualifikanten: Keine

Datum und Uhrzeit, zu dem die Anzeige für Kunden nicht mehr verfügbar ist. Der Standardwert ist 19900101000000.000000+****.

ExpirationTimeEnabled

Datentyp: Boolean

Zugriffstyp: Lesen/Schreiben

Qualifikanten: [faul]

true wenn die Anzeige zu dem von der ExpirationTime Unterkunft angegebenen Zeitpunkt abläuft. Der Standardwert ist false.

ExpirationTimeIsGMT

Datentyp: Boolean

Zugriffstyp: Lesen/Schreiben

Qualifikanten: [faul]

true wenn die in der ExpirationTime Eigenschaft definierte Zeit in UMT ist. Der Standardwert ist false.

HierarchyPath

Datentyp: String

Zugriffstyp: Lesen/Schreiben

Qualifikanten: Keine

Reserviert.

IncludeSubCollection

Datentyp: Boolean

Zugriffstyp: Lesen/Schreiben

Qualifikanten: Keine

true (Standard), wenn die Ankündigung für die Untersammlungen der angegebenen Sammlung angekündigt wird.

ISVData

Datentyp: Uint8 Array

Zugriffstyp: Lesen/Schreiben

Qualifikanten: [groß, faul]

Informationen, die es einem einzelnen ISV ermöglichen, Daten zu einer SMS_Program Instance zu speichern. Für diese Daten gibt es keine Einschränkungen oder definierten Formate. Es ist jedoch wichtig, die Eigenschaft nicht zu überschreiben, nachdem ihr ISV-Besitz festgestellt wurde. Daher sollte die aufrufende Anwendung zuerst die vorhandenen Daten in dieser Eigenschaft lesen. Wenn die Daten nicht zur Anwendung gehören, sollten sie nicht geändert werden. Jeder ISV oder Anwendungsbesitzer, der diese Eigenschaft verwendet, sollte einen Bezeichner in die Daten einschließen, damit der Besitz einfach festgestellt werden kann.

ISVDataSize

Datentyp: UInt32

Zugriffstyp: Lesen/Schreiben

Qualifikanten: [faul]

Die Größe der Daten, die durch die ISVData Eigenschaft dargestellt werden. Der Standardwert ist 0.

ISVString

Datentyp: String

Zugriffstyp: Lesen/Schreiben

Qualifikanten: keine

Zeichenfolge für die Partnererweiterbarkeit.

MandatoryCountdown

Datentyp: UInt32

Zugriffstyp: Lesen/Schreiben

Qualifikanten: Keine

Dauer in Minuten zur Anzeige der Betriebssystembereitstellung Countdown für die Benutzerbenachrichtigung erforderlich. Der Standardwert ist 0.

OfferType

Datentyp: UInt32

Zugriffstyp: Lesen/Schreiben

Qualifiers: [enumeration]

Ankündigungstyp, der angibt, dass die Ankündigung auf Benutzer ausgerichtet ist.

PackageID

Datentyp: String

Zugriffstyp: Lesen/Schreiben

Qualifikanten: [Not_null]

ID für ein vorhandenes Paket, das der Ankündigung zugeordnet ist. Der Wert muss in Großbuchstaben geschrieben werden.

PresentTime

Datentyp: DateTime

Zugriffstyp: Lesen/Schreiben

Qualifikanten: Keine

Datum und Uhrzeit, zu dem die Anzeige den Kunden zur Verfügung gestellt wird. Der Standardwert ist 19900101000000.000000+****.

PresentTimeEnabled

Datentyp: Boolean

Zugriffstyp: Lesen/Schreiben

Qualifikanten: [faul]

true(Standard) wenn die aktuelle Uhrzeit vom Configuration Manager erzwungen wird.

PresentTimeIsGMT

Datentyp: Boolean

Zugriffstyp: Lesen/Schreiben

Qualifikanten: [faul]

true wenn die in der PresentTime Eigenschaft definierte Zeit in UMT ist. Der Standardwert ist false.

Priority

Datentyp: UInt32

Zugriffstyp: Lesen/Schreiben

Qualifiers: [enumeration]

Die Priorität, die beim Replizieren der Ankündigung auf untergeordnete Websites verwendet wird. Mögliche Werte sind unten aufgeführt. Der Standardwert ist NORMAL (2).

ProgramName

Datentyp: String

Zugriffstyp: Lesen/Schreiben

Qualifikanten: [Not_null]

Ein Programm innerhalb des angegebenen Pakets (PackageID), das angekündigt werden soll.

RemoteClientFlags

Datentyp: UInt32

Zugriffstyp: Lesen/Schreiben

Qualifier: [bits]

Diese Flags geben an, wie das Programm ausgeführt werden soll, wenn der Client lokal oder remote mit einem Verteilungspunkt verbunden ist. Mögliche Werte sind unten aufgeführt. Der Standardwert ist 48.

SourceSite

Datentyp: String

Zugriffstyp: Schreibgeschützt

Qualifikanten: [lesen]

Aus drei Buchstaben bestehender Websitecode der Website, von der die Ankündigung stammt.

TimeFlags

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Qualifier: [lesen, Bits]

Für die interne Verwendung reserviert. Flags, die die Informationen in den zeitbezogenen Eigenschaften duplizieren. Mögliche Werte sind unten aufgeführt. Beispielsweise wird ENABLE_PRESENT festgelegt, wenn PresentTimeEnabled gleich trueist.

Hinweise

Zu den Klassenqualifikationen für diese Klasse gehören:

• Gesichert

  Weitere Informationen zu den Klassen- und Eigenschaftskennzeichnern, die im Abschnitt Eigenschaften enthalten sind, finden Sie unter Klassen- und Eigenschaftsbegrenzungszeichen im Configuration Manager.

  Obwohl keine anderen Schlüsseleigenschaften vorhanden sind, müssen die Eigenschaften AdvertisementName, CollectionID, PackageIDund ProgramName als NOT_NULL qualifiziert werden, und es müssen Werte angegeben werden. Ihre Anwendung kann diese Eigenschaften nicht aktualisieren, nachdem eine Klassen-Instance erstellt wurde. Um diese Werte zu ändern, muss die Anwendung die Instance löschen und eine neue Instance mit den richtigen Werten erstellen.

Anforderungen

Laufzeitanforderungen

Weitere Informationen finden Sie unter Anforderungen an die Configuration Manager Server-Laufzeit.

Entwicklungsanforderungen

Weitere Informationen finden Sie unter Entwicklungsanforderungen für Configuration Manager Server.