SMS_Advertisement server WMI-klasse

De SMS_Advertisement WMI-klasse (Windows Management Instrumentation) is een SMS-providerserverklasse, in Configuration Manager, die een aankondiging vertegenwoordigt die wordt gebruikt om softwarepakketprogramma's aan te kondigen die beschikbaar zijn voor uitvoering op clients.

De volgende syntaxis is vereenvoudigd ten opzichte van de MOF-code (Managed Object Format) en bevat alle overgenomen eigenschappen.

Syntaxis

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

De volgende tabel bevat een overzicht van de methoden in de SMS_Advertisement klas.

Eigenschappen

ActionInProgress

Gegevenstype: UInt32

Toegangstype: Alleen-lezen

Kwalificaties: [lezen, opsomming]

Huidige actie die door Configuration Manager op het pakket wordt uitgevoerd. Mogelijke waarden zijn:

AdvertFlags

Gegevenstype: UInt32

Toegangstype: Lezen/schrijven

Kwalificaties: [bits]

Vlaggen die aangeven hoe de advertentie aan de gebruiker moet worden aangekondigd. Mogelijke waarden worden hieronder vermeld. De standaardwaarde is 0.

Deze vlaggen moeten worden gecoördineerd met de vlaggen die zijn opgegeven in de ProgramFlags eigenschap van het aangekondigde programma. Als u bijvoorbeeld ONUSERLOGOFF instelt, moet de vlag NOUSERLOGGEDIN in het programma worden ingesteld. Als de vlaginstellingen niet overeenkomen, wordt het programma niet aangekondigd. Zie SMS_Program Server WMI-klasse voor meer informatie.

Door IMMEDIATE, ONUSERLOGON of ONUSERLOGOFF in te stellen of een AssignedSchedule waarde op te geven, wordt het aangekondigde programma verplicht. Een verplicht programma wordt automatisch uitgevoerd nadat de klant de advertentie heeft ontvangen. De client kan de installatie niet weigeren of uitstellen.

Stel de bits NO_DISPLAY en ONSLOWNET alleen in als de bit IMMEDIATE, ONUSERLOGON of ONUSERLOGOFF is ingesteld of als het programma een AssignedSchedule waarde heeft.

Stel NO_DISPLAY in als u niet wilt dat de gebruiker programma's onafhankelijk van de toewijzing uitvoert. Als u deze vlag niet instelt, wordt de advertentie getoond in de lijst met advertenties en kan deze onafhankelijk van de opdracht worden uitgevoerd. Het programma kan nog steeds verplicht zijn.

Stel ONSLOWNET in wanneer toewijzingen verplicht zijn via een trage netwerkverbinding, bijvoorbeeld wanneer een computer verbinding maakt met een modem.

AdvertisementID

Gegevenstype: String

Toegangstype: Lezen/schrijven

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

Unieke automatisch gegenereerde sleutel waarmee de advertentie wordt geïdentificeerd. De standaardwaarde is "".

AdvertisementName

Gegevenstype: String

Toegangstype: Lezen/schrijven

Kwalificaties: [Not_null]

Unieke gebruiksvriendelijke naam voor de advertentie.

AssignedSchedule Gegevenstype: SMS_ScheduleToken Array

Toegangstype: Lezen/schrijven

Kwalificaties: [max(15), lui]

SMS_ScheduleToken Server WMI-klasseobjecten die het tijdstip aangeven waarop de advertentie verplicht wordt voor de clients.

AssignedScheduleEnabled

Gegevenstype: Boolean

Toegangstype: Lezen/schrijven

Kwalificaties: [lui]

true of het in de AssignedSchedule eigenschap gedefinieerde schema actief is. De standaardwaarde is false.

AssignedScheduleIsGMT

Gegevenstype: Boolean

Toegangstype: Lezen/schrijven

Kwalificaties: [lui]

true als het schema dat in de AssignedSchedule eigenschap is gedefinieerd, de UMT-tijd (Universal Metric Time) is. De standaardwaarde is false.

AssignmentID

Gegevenstype: UInt32

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

Id van de opdracht die aan de advertentie is gekoppeld.

CollectionID

Gegevenstype: String

Toegangstype: Lezen/schrijven

Kwalificaties: [Not_null]

Bestaande collectie waarop de advertentie is gericht.

Comment

Gegevenstype: String

Toegangstype: Lezen/schrijven

Kwalificaties: Geen

Eenvoudige beschrijving of opmerking over de advertentie. De standaardwaarde is "".

DeviceFlags

Gegevenstype: UInt32

Toegangstype: Lezen/schrijven

Kwalificaties: Geen

Vlaggen die het apparaat beschrijven. Mogelijke waarden worden hieronder vermeld. De standaardwaarde is 0.

ExpirationTime

Gegevenstype: DateTime

Toegangstype: Lezen/schrijven

Kwalificaties: Geen

Datum en tijd waarop de advertentie niet meer beschikbaar is voor klanten. De standaardwaarde is 19900101000000.000000+****.

ExpirationTimeEnabled

Gegevenstype: Boolean

Toegangstype: Lezen/schrijven

Kwalificaties: [lui]

true als de advertentie verloopt op het door de ExpirationTime accommodatie aangegeven tijdstip. De standaardwaarde is false.

ExpirationTimeIsGMT

Gegevenstype: Boolean

Toegangstype: Lezen/schrijven

Kwalificaties: [lui]

true als de tijd die is gedefinieerd in de ExpirationTime eigenschap in UMT is. De standaardwaarde is false.

HierarchyPath

Gegevenstype: String

Toegangstype: Lezen/schrijven

Kwalificaties: Geen

Gereserveerd.

IncludeSubCollection

Gegevenstype: Boolean

Toegangstype: Lezen/schrijven

Kwalificaties: Geen

true (standaard) als de advertentie wordt geadverteerd naar de subcollecties van de opgegeven collectie.

ISVData

Gegevenstype: Uint8 Array

Toegangstype: Lezen/schrijven

Kwalificaties: [groot, lui]

Informatie waarmee één ISV gegevens kan opslaan met betrekking tot een SMS_Program exemplaar. Er zijn geen beperkingen of gedefinieerde notaties voor deze gegevens. Het is echter belangrijk om het onroerend goed niet te overschrijven nadat het ISV-eigendom is vastgesteld. Daarom moeten eerst de bestaande gegevens in deze eigenschap worden gelezen. Als de gegevens geen deel uitmaken van de toepassing, mogen deze niet worden gewijzigd. Elke ISV- of toepassingseigenaar die deze eigenschap gebruikt, moet een id in de gegevens opnemen, zodat de eigenaar eenvoudig kan worden vastgesteld.

ISVDataSize

Gegevenstype: UInt32

Toegangstype: Lezen/schrijven

Kwalificaties: [lui]

De grootte van de gegevens die worden vertegenwoordigd door de ISVData eigenschap. De standaardwaarde is 0.

ISVString

Gegevenstype: String

Toegangstype: Lezen/schrijven

Kwalificaties: geen

Tekenreeks voor partneruitbreidbaarheid.

MandatoryCountdown

Gegevenstype: UInt32

Toegangstype: Lezen/schrijven

Kwalificaties: Geen

Duur in minuten, om de melding van de gebruiker van het besturingssysteem weer te geven verplicht aftellen van het schema. De standaardwaarde is 0.

OfferType

Gegevenstype: UInt32

Toegangstype: Lezen/schrijven

Kwalificaties: [opsomming]

Advertentietype dat aangeeft dat de advertentie is gericht op gebruikers.

PackageID

Gegevenstype: String

Toegangstype: Lezen/schrijven

Kwalificaties: [Not_null]

ID voor een bestaand pakket dat is gekoppeld aan de advertentie. De waarde moet in hoofdletters zijn.

PresentTime

Gegevenstype: DateTime

Toegangstype: Lezen/schrijven

Kwalificaties: Geen

Datum en tijd waarop de advertentie beschikbaar wordt gesteld aan klanten. De standaardwaarde is 19900101000000.000000+****.

PresentTimeEnabled

Gegevenstype: Boolean

Toegangstype: Lezen/schrijven

Kwalificaties: [lui]

true(standaard) als de huidige tijd wordt afgedwongen door Configuration Manager.

PresentTimeIsGMT

Gegevenstype: Boolean

Toegangstype: Lezen/schrijven

Kwalificaties: [lui]

true als de tijd die is gedefinieerd in de PresentTime eigenschap in UMT is. De standaardwaarde is false.

Priority

Gegevenstype: UInt32

Toegangstype: Lezen/schrijven

Kwalificaties: [opsomming]

De prioriteit die wordt gebruikt bij het repliceren van de advertentie naar onderliggende sites. Mogelijke waarden worden hieronder vermeld. De standaardwaarde is NORMAAL (2).

ProgramName

Gegevenstype: String

Toegangstype: Lezen/schrijven

Kwalificaties: [Not_null]

Een programma binnen het gespecificeerde pakket (PackageID) dat moet worden aangekondigd.

RemoteClientFlags

Gegevenstype: UInt32

Toegangstype: Lezen/schrijven

Kwalificaties: [bits]

Vlaggen die aangeven hoe het programma moet worden uitgevoerd wanneer de client, lokaal of op afstand, is verbonden met een distributiepunt. Mogelijke waarden worden hieronder vermeld. De standaardwaarde is 48.

SourceSite

Gegevenstype: String

Toegangstype: Alleen-lezen

Kwalificaties: [lees]

De drieletterige sitecode van de site waarvan de advertentie afkomstig is.

TimeFlags

Gegevenstype: UInt32

Toegangstype: Alleen-lezen

Kwalificaties: [lezen, bits]

Gereserveerd voor intern gebruik. Vlaggen die de informatie in de tijdgerelateerde eigenschappen dupliceren. Mogelijke waarden worden hieronder vermeld. Er wordt bijvoorbeeld ENABLE_PRESENT ingesteld wanneer PresentTimeEnabled gelijk is trueaan .

Opmerkingen

Klassekwalificaties voor deze klasse zijn onder meer:

• Beveiligd

  Zie Klasse- en eigenschapskwalificaties in Configuration Manager voor meer informatie over klasse- en eigenschapskwalificaties in het gedeelte Eigenschappen.

  Hoewel er geen andere sleuteleigenschappen zijn, worden de eigenschappen AdvertisementName, CollectionID, PackageID, en ProgramName worden ze gekwalificeerd als NOT_NULL en moeten waarden worden opgegeven. Uw toepassing kan deze eigenschappen niet bijwerken nadat een klasse-exemplaar is gemaakt. Als u deze waarden wilt wijzigen, moet de toepassing het exemplaar verwijderen en een nieuw exemplaar met de juiste waarden maken.

Vereisten

Runtime vereisten

Zie de vereisten voor de runtime van de Configuration Manager-server voor meer informatie.

Vereisten voor ontwikkeling

Zie Vereisten voor de ontwikkeling van Configuration Manager-servers voor meer informatie.