WMI-Serverklasse SMS_Advertisement
Die SMS_Advertisement WMI-Klasse (Windows Management Instrumentation) ist eine SMS-Anbieter-Serverklasse in Configuration Manager, die eine Ankündigung darstellt, mit der Softwarepaketprogramme angekündigt werden, die für die Ausführung auf Clients verfügbar sind.
Die folgende Syntax wird vom 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.
| Methode | Beschreibung |
|---|---|
| GetAdvertisements-Methode in der Klasse SMS_Advertisement | Ruft die Ankündigungs-IDs ab, die auf die Ressource ausgerichtet sind. |
| GetNextID-Methode in class SMS_Advertisement | Ruft die ID-Nummer ab, die für die nächste erstellte Ankündigung verwendet wird. |
| RiskyDeploymentStatusMessage-Methode in der Klasse SMS_Advertisement | Sendet eine Warnung status Meldung zu einer Benutzerbereitstellung an eine riskante Sammlung. |
| SetNextID-Methode in Class SMS_Advertisement | Legt die ID-Nummer fest, die für die nächste erstellte Ankündigung verwendet wird. |
| SetSourceSite-Methode in Class SMS_Advertisement | Legt den Quellcode für die Ankündigung fest. |
| Unlock-Methode in class SMS_Advertisement | Legt die Quellwebsite auf die aktuelle Website fest und entsperrt die Ankündigung. Warnung: Diese Methode ist veraltet. |
Eigenschaften
ActionInProgress
Datentyp: UInt32
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen, Aufzählung]
Aktuelle Aktion, die von Configuration Manager für das Paket ausgeführt wird. Die folgenden Werte sind möglich:
| Wert | Beschreibung |
|---|---|
| 0 | NICHTS |
| 1 | UPDATE |
| 2 | HINZUFÜGEN |
AdvertFlags
Datentyp: UInt32
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [Bits]
Flags, die angeben, wie die Werbung für den Benutzer angekündigt werden soll. Mögliche Werte sind unten aufgeführt. Der Standardwert ist 0.
| Hexadezimal (Bit) | Beschreibung |
|---|---|
| 0x00000020 (5) | SOFORTIG. Kündigen Sie dem Benutzer sofort die Ankündigung an. |
| 0x00000100 (8) | ONSYSTEMSTARTUP. Kündigen Sie dem Benutzer beim Systemstart die Ankündigung an. |
| 0x00000200 (9) | ONUSERLOGON. Kündigen Sie die Ankündigung für den Benutzer bei der Anmeldung an. |
| 0x00000400 (10) | ONUSERLOGOFF. Kündigen Sie die Ankündigung für den Benutzer bei der Abmeldung an. |
| 0x00001000 (12) | OPTIONALVORHERUNTERLADEN. Wenn die ausgewählte Architektur und Sprache mit der des Clients übereinstimmen, wird der Paketinhalt im Voraus heruntergeladen. |
| 0x00008000 (15) | WINDOWS_CE. Die Ankündigung ist für einen Geräteclient. |
| 0x00010000 (16) | ENABLE_PEER_CACHING. Diese Informationen gelten für System Center 2012 Configuration Manager SP1 oder höher und System Center 2012 R2 Configuration Manager oder höher. |
| 0x00020000 (17) | DONOT_FALLBACK. Greifen Sie nicht auf ungeschützte Verteilungspunkte zurück. |
| 0x00040000 (18) | ENABLE_TS_FROM_CD_AND_PXE. Die Tasksequenz ist für Wechselmedien und den PXE-Dienstpunkt (Pre-Boot Execution Environment) verfügbar. |
| 0x00080000 (19) | APTSINTRANETONLY. |
| 0x00100000 (20) | OVERRIDE_SERVICE_WINDOWS. Überschreiben Sie Wartungsfenster, wenn Sie die Ankündigung für den Benutzer ankündigen. |
| 0x00200000 (21) | REBOOT_OUTSIDE_OF_SERVICE_WINDOWS. Neustarten außerhalb von Wartungsfenstern. |
| 0x00400000 (22) | WAKE_ON_LAN_ENABLED. Kündigen Sie dem Benutzer die Ankündigung mit aktiviertem Wake-On-LAN an. |
| 0x00800000 (23) | SHOW_PROGRESS. Kündigen Sie dem Benutzer die Ankündigung an, die den Tasksequenzfortschritt anzeigt. |
| 0x02000000 (25) | NO_DISPLAY. Der Benutzer sollte Programme nicht unabhängig von der Zuweisung ausführen. |
| 0x04000000 (26) | ONSLOWNET. Zuweisungen sind über eine langsame Netzwerkverbindung obligatorisch. |
| 0x10000000 (28) | TARGETTOWINPE. Diese Bereitstellung wird nur auf WinPE ausgerichtet. |
| 0x20000000 (29) | HIDDENINWINPE. Diese Bereitstellung wird nur auf WinPE ausgerichtet, aber in WinPE ausgeblendet. Sie kann nur von der TS-Variablen SMSTSPreferredAdvertID verwendet werden. |
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 festgelegt werden. Wenn die Flageinstellungen nicht übereinstimmen, wird das Programm nicht angekündigt. Weitere Informationen finden Sie unter SMS_Program-Server-WMI-Klasse.
Das Festlegen von IMMEDIATE, ONUSERLOGON oder ONUSERLOGOFF oder das Angeben eines Werts AssignedSchedule macht 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 Bits NO_DISPLAY und ONSLOWNET nur fest, wenn das Bit IMMEDIATE, ONUSERLOGON oder ONUSERLOGOFF festgelegt ist oder das Programm einen AssignedSchedule Wert hat.
Legen Sie NO_DISPLAY fest, wenn sie nicht möchten, dass der Benutzer Programme unabhängig von der Zuweisung ausführen soll. Wenn Sie dieses Flag nicht festlegen, wird die Ankündigung in der Liste der Anzeigen angezeigt und kann unabhängig von der Zuweisung ausgeführt werden. Das Programm kann weiterhin obligatorisch 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: Lese-/Schreibzugriff
Qualifizierer: [key, ResID(801), ResDLL("SMS_RSTT.dll")]
Eindeutiger automatisch generierter Schlüssel, der die Ankündigung identifiziert. Der Standardwert ist "".
AdvertisementName
Datentyp: String
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [Not_null]
Eindeutiger benutzerfreundlicher Name für die Anzeige.
AssignedSchedule
Datentyp: SMS_ScheduleToken Array
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [max(15), lazy]
SMS_ScheduleToken Server-WMI-Klassenobjekte , die den Zeitpunkt angeben, zu dem die Ankündigung auf den Clients obligatorisch wird.
AssignedScheduleEnabled
Datentyp: Boolean
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [lazy]
true , wenn der in der AssignedSchedule -Eigenschaft definierte Zeitplan aktiv ist. Der Standardwert ist false.
AssignedScheduleIsGMT
Datentyp: Boolean
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [lazy]
true , wenn der in der AssignedSchedule -Eigenschaft definierte Zeitplan in Universal Metric Time (UMT) ist. Der Standardwert ist false.
AssignmentID
Datentyp: UInt32
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
ID der Zuweisung, die der Ankündigung zugeordnet ist.
CollectionID
Datentyp: String
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [Not_null]
Vorhandene Sammlung, auf die die Ankündigung ausgerichtet ist.
Comment
Datentyp: String
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: Keine
Einfache Beschreibung oder Hinweis zur Werbung. Der Standardwert ist "".
DeviceFlags
Datentyp: UInt32
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: Keine
Flags, die das Gerät beschreiben. Mögliche Werte sind unten aufgeführt. Der Standardwert ist 0.
| Hexadezimal (Bit) | Beschreibung |
|---|---|
| 0x01000000 (24) | Weisen Sie dem Client immer das Programm zu. |
| 0x02000000 (25) | Weisen Sie das Gerät nur zu, wenn das Gerät derzeit mit einer Verbindung mit hoher Bandbreite verbunden ist (Standard über 60 KBit/s). |
| 0x04000000 (26) | Weisen Sie das Gerät nur zu, wenn das Gerät angedockt ist, d. h., es ist an einen Desktop angefügt, der ActiveSync verwendet. |
ExpirationTime
Datentyp: DateTime
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: Keine
Datum und Uhrzeit, zu dem die Ankündigung für Clients nicht mehr verfügbar ist. Der Standardwert ist 19900101000000.000000+****.
ExpirationTimeEnabled
Datentyp: Boolean
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [lazy]
true , wenn die Ankündigung zu dem von der ExpirationTime -Eigenschaft angegebenen Zeitpunkt abläuft. Der Standardwert ist false.
ExpirationTimeIsGMT
Datentyp: Boolean
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [lazy]
true , wenn die in der ExpirationTime -Eigenschaft definierte Zeit in UMT liegt. Der Standardwert ist false.
HierarchyPath
Datentyp: String
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: Keine
Reserviert.
IncludeSubCollection
Datentyp: Boolean
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: Keine
true (Standard), wenn die Ankündigung für die Untersammlungen der angegebenen Auflistung angekündigt wird.
ISVData
Datentyp: Uint8 Array
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [groß, lazy]
Informationen, die es einem einzelnen ISV ermöglichen, Daten zu einem SMS_Program instance zu speichern. Es gibt keine Einschränkungen oder definierten Formate für diese Daten. Es ist jedoch wichtig, die Eigenschaft nicht zu überschreiben, nachdem ihr ISV-Besitz eingerichtet 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 aufnehmen, damit der Besitz einfach hergestellt werden kann.
ISVDataSize
Datentyp: UInt32
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [lazy]
Die Größe der Daten, die durch die ISVData -Eigenschaft dargestellt werden. Der Standardwert ist 0.
ISVString
Datentyp: String
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: keine
Zeichenfolge für die Partnererweiterbarkeit.
MandatoryCountdown
Datentyp: UInt32
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: Keine
Dauer in Minuten, um den Countdown des obligatorischen Zeitplans für die Benutzerbenachrichtigung für die Betriebssystembereitstellung anzuzeigen. Der Standardwert ist 0.
OfferType
Datentyp: UInt32
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [Enumeration]
Ankündigungstyp, der angibt, dass die Ankündigung an Benutzer gerichtet ist.
| Wert | Beschreibung |
|---|---|
| 0 | Erforderlich |
| 2 | Verfügbar |
PackageID
Datentyp: String
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [Not_null]
ID für ein vorhandenes Paket, das der Ankündigung zugeordnet ist. Der Wert muss in Großbuchstaben enthalten sein.
PresentTime
Datentyp: DateTime
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: Keine
Datum und Uhrzeit, zu dem die Ankündigung für Kunden zur Verfügung gestellt wird. Der Standardwert ist 19900101000000.000000+****.
PresentTimeEnabled
Datentyp: Boolean
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [lazy]
true(Standard), wenn die aktuelle Zeit von Configuration Manager erzwungen wird.
PresentTimeIsGMT
Datentyp: Boolean
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [lazy]
true , wenn die in der PresentTime -Eigenschaft definierte Zeit in UMT liegt. Der Standardwert ist false.
Priority
Datentyp: UInt32
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [Enumeration]
Die Priorität, die beim Replizieren der Ankündigung an untergeordnete Websites verwendet wird. Mögliche Werte sind unten aufgeführt. Der Standardwert ist NORMAL (2).
| Wert | Beschreibung |
|---|---|
| 1 | HOCH |
| 2 | NORMAL |
| 3 | NIEDRIG |
ProgramName
Datentyp: String
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [Not_null]
Ein Programm innerhalb des angegebenen Pakets (PackageID), das angekündigt werden soll.
RemoteClientFlags
Datentyp: UInt32
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: [Bits]
Flags, die angeben, wie das Programm ausgeführt werden soll, wenn der Client entweder lokal oder remote mit einem Verteilungspunkt verbunden ist. Mögliche Werte sind unten aufgeführt. Der Standardwert ist 48.
| Hexadezimal (Bit) | Beschreibung |
|---|---|
| 0x00000001 (0) | BATTERY_POWER. Führen Sie das Programm mit Akkubetrieb aus. Dieser Wert wird derzeit nicht verwendet. |
| 0x00000002 (1) | RUN_FROM_CD. Führen Sie das Programm von CD aus. Dieser Wert wird derzeit nicht verwendet. |
| 0x00000004 (2) | DOWNLOAD_FROM_CD. Laden Sie das Programm von CD herunter. Dieser Wert wird derzeit nicht verwendet. |
| 0x00000008 (3) | RUN_FROM_LOCAL_DISPPOINT. Führen Sie das Programm über den lokalen Verteilungspunkt aus. |
| 0x00000010 (4) | DOWNLOAD_FROM_LOCAL_DISPPOINT. Laden Sie das Programm vom lokalen Verteilungspunkt herunter. |
| 0x00000020 (5) | DONT_RUN_NO_LOCAL_DISPPOINT. Führen Sie das Programm nicht aus, wenn kein lokaler Verteilungspunkt vorhanden ist. |
| 0x00000040 (6) | DOWNLOAD_FROM_REMOTE_DISPPOINT. Laden Sie das Programm vom Remoteverteilungspunkt herunter. |
| 0x00000080 (7) | RUN_FROM_REMOTE_DISPPOINT. Führen Sie das Programm über den Remoteverteilungspunkt aus. |
| 0x00000100 (8) | DOWNLOAD_ON_DEMAND_FROM_LOCAL_DP. Laden Sie das Programm bei Bedarf vom lokalen Verteilungspunkt herunter. Dies gilt nur für Tasksequenzen. |
| 0x00000200 (9) | DOWNLOAD_ON_DEMAND_FROM_REMOTE_DP. Laden Sie das Programm bei Bedarf vom Remoteverteilungspunkt herunter. Dies gilt nur für Tasksequenzen. |
| x00000400 (10) | BALLOON_REMINDERS_REQUIRED. Sprechblasenerinnerungen sind erforderlich. |
| 0x00000800 (11) | RERUN_ALWAYS. Führen Sie das Programm immer erneut aus. |
| 0x00001000 (12) | RERUN_NEVER. Führen Sie das Programm niemals erneut aus. |
| 0x00002000 (13) | RERUN_IF_FAILED. Führen Sie das Programm erneut aus, wenn die Ausführung zuvor fehlgeschlagen ist. |
| 0x00004000 (14) | RERUN_IF_SUCCEEDED. Führen Sie das Programm erneut aus, wenn die Ausführung zuvor erfolgreich war. |
| 0x00008000 (15) | PERSIST_ON_WRITE_FILTER_DEVICES Diese Informationen gelten für System Center 2012 Configuration Manager SP1 oder höher und System Center 2012 R2 Configuration Manager oder höher. |
| 0x00020000 (17) | DON'T_FALLBACK Diese Informationen gelten für System Center 2012 Configuration Manager SP1 oder höher und System Center 2012 R2 Configuration Manager oder höher. |
| 0x00040000 (18) | DP_ALLOW_METERED_NETWORK Diese Informationen gelten für System Center 2012 Configuration Manager SP1 oder höher und System Center 2012 R2 Configuration Manager oder höher. |
SourceSite
Datentyp: String
Zugriffstyp: Schreibgeschützt
Qualifizierer: [lesen]
Aus drei Buchstaben bestehender Standortcode der Website, von der die Werbung stammt.
TimeFlags
Datentyp: UInt32
Zugriffstyp: Schreibgeschützt
Qualifizierer: [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.
| Hexadezimal (Bit) | Beschreibung |
|---|---|
| 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 |
Hinweise
Klassenqualifizierer für diese Klasse sind:
Gesichert
Weitere Informationen sowohl zu den Klassenqualifizierern als auch zu den Eigenschaftenqualifizierern, die im Abschnitt Eigenschaften enthalten sind, finden Sie unter Configuration Manager Klassen- und Eigenschaftsqualifizierer.
Obwohl es keine anderen Schlüsseleigenschaften gibt, werden die Eigenschaften
AdvertisementName,CollectionID,PackageIDundProgramNameals NOT_NULL qualifiziert, und Werte müssen angegeben werden. Ihre Anwendung kann diese Eigenschaften nicht aktualisieren, nachdem eine Klasse 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 Configuration Manager Server Runtime.
Entwicklungsanforderungen
Weitere Informationen finden Sie unter Configuration Manager Serverentwicklungsanforderungen.