Klasa WMI serwera SMS_Advertisement

Klasa SMS_Advertisement WMI (Instrumentacja zarządzania Windows) jest klasą serwera dostawcy wiadomości SMS w programie Configuration Manager, która reprezentuje reklamę używaną do anonsowania programów pakietów oprogramowania, które są dostępne do uruchomienia na klientach.

Poniższa składnia jest uproszczona w stosunku do kodu MOF (Managed Object Format) i zawiera wszystkie dziedziczone właściwości.

Składnia

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

Metody

Poniższa tabela zawiera listę metod dostępnych w SMS_Advertisement tej klasie.

Właściwości

ActionInProgress

Typ danych: UInt32

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt, wyliczenie]

Bieżąca akcja wykonywana na pakiecie przez program Configuration Manager. Dopuszczalne wartości:

AdvertFlags

Typ danych: UInt32

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [bity]

Flagi wskazujące, w jaki sposób reklama powinna być ogłaszana użytkownikowi. Poniżej przedstawiono możliwe wartości. Wartość domyślna to 0.

Te flagi muszą być skoordynowane z flagami określonymi we ProgramFlags właściwości anonsowanego programu. Na przykład, jeśli ustawisz opcję ONUSERLOGOFF, flaga NOUSERLOGGEDIN musi być ustawiona w programie. Jeśli ustawienia flagi nie są zgodne, program nie jest ogłaszany. Aby uzyskać więcej informacji, zobacz SMS_Program Klasa WMI serwera.

Ustawienie IMMEDIATE, ONUSERLOGON lub ONUSERLOGOFF albo podanie AssignedSchedule wartości powoduje, że anonsowany program jest obowiązkowy. Obowiązkowy program jest uruchamiany automatycznie po otrzymaniu reklamy przez klienta. Klient nie może odrzucić ani odroczyć instalacji.

Bity NO_DISPLAY i ONSLOWNET są ustawiane tylko wtedy, gdy jest ustawiony bit IMMEDIATE, ONUSERLOGON lub ONUSERLOGOFF lub program ma AssignedSchedule wartość.

Ustaw NO_DISPLAY, gdy nie chcesz, aby użytkownik uruchamiał programy niezależnie od przypisania. Jeśli nie ustawisz tej flagi, reklama będzie wyświetlana na liście ogłoszeń i może być uruchamiana niezależnie od przypisania. Program nadal może być obowiązkowy.

Ustawienie ONSLOWNET należy ustawić w przypadku, gdy przypisania są obowiązkowe w przypadku wolnego połączenia sieciowego, na przykład gdy komputer łączy się za pomocą modemu.

AdvertisementID

Typ danych: String

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [klucz, ResID(801), ResDLL("SMS_RSTT.dll")]

Unikatowy automatycznie wygenerowany klucz, który identyfikuje reklamę. Wartość domyślna to "".

AdvertisementName

Typ danych: String

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [Not_null]

Unikalna, przyjazna dla użytkownika nazwa reklamy.

AssignedSchedule Typ danych: SMS_ScheduleToken Tablica

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [max(15), leniwe]

Obiekty klasy WMI serwera SMS_ScheduleToken wskazujące czas, po którym ogłoszenie staje się obowiązkowe dla klientów.

AssignedScheduleEnabled

Typ danych: Boolean

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [leniwe]

true jeśli harmonogram zdefiniowany we AssignedSchedule właściwości jest aktywny. Wartość domyślna to false.

AssignedScheduleIsGMT

Typ danych: Boolean

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [leniwe]

true jeśli harmonogram zdefiniowany we AssignedSchedule właściwości jest wyrażony w uniwersalnym czasie metrycznym (UMT). Wartość domyślna to false.

AssignmentID

Typ danych: UInt32

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

Identyfikator zadania skojarzonego z ogłoszeniem.

CollectionID

Typ danych: String

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [Not_null]

Istniejąca kolekcja, do której kierowana jest reklama.

Comment

Typ danych: String

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: brak

Prosty opis lub notatka o reklamie. Wartość domyślna to "".

DeviceFlags

Typ danych: UInt32

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: brak

Flagi opisujące urządzenie. Poniżej przedstawiono możliwe wartości. Wartość domyślna to 0.

ExpirationTime

Typ danych: DateTime

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: brak

Data i godzina, kiedy ogłoszenie nie jest już dostępne dla klientów. Wartość domyślna to 19900101000000.000000+****.

ExpirationTimeEnabled

Typ danych: Boolean

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [leniwe]

true jeśli ogłoszenie wygasa w czasie wskazanym przez nieruchomość ExpirationTime . Wartość domyślna to false.

ExpirationTimeIsGMT

Typ danych: Boolean

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [leniwe]

true jeśli czas zdefiniowany we ExpirationTime właściwości jest wyrażony w UMT. Wartość domyślna to false.

HierarchyPath

Typ danych: String

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: brak

Zarezerwowane.

IncludeSubCollection

Typ danych: Boolean

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: brak

true (domyślnie), jeśli ogłoszenie jest ogłaszane w podkolekcjach określonej kolekcji.

ISVData

Typ danych: Uint8 Tablica

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [duży, leniwy]

Informacje umożliwiające pojedynczemu niezależnemu dostawcy oprogramowania przechowywanie danych związanych z SMS_Program wystąpieniem. Dla tych danych nie ma żadnych ograniczeń ani zdefiniowanych formatów. Ważne jest jednak, aby nie nadpisywać właściwości po ustaleniu jej własności ISV. Dlatego aplikacja wywołująca powinna najpierw odczytać istniejące dane w tej właściwości. Jeśli dane nie należą do aplikacji, nie należy ich modyfikować. Każdy niezależny dostawca oprogramowania lub właściciel aplikacji, który używa tej właściwości, powinien umieścić w danych identyfikator umożliwiający łatwe ustalenie własności.

ISVDataSize

Typ danych: UInt32

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [leniwe]

Rozmiar danych reprezentowanych przez ISVData właściwość. Wartość domyślna to 0.

ISVString

Typ danych: String

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: brak

Ciąg dotyczący rozszerzalności partnerów.

MandatoryCountdown

Typ danych: UInt32

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: brak

Czas trwania (w minutach) wyświetlania powiadomienia użytkownika o wdrażaniu systemu operacyjnego Obowiązkowe odliczanie harmonogramu. Wartość domyślna to 0.

OfferType

Typ danych: UInt32

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [wyliczenie]

Typ reklamy wskazujący, że reklama jest kierowana do użytkowników.

PackageID

Typ danych: String

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [Not_null]

Identyfikator istniejącego pakietu skojarzonego z reklamą. Wartość musi być zapisana wielkimi literami.

PresentTime

Typ danych: DateTime

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: brak

Data i godzina udostępnienia reklamy klientom. Wartość domyślna to 19900101000000.000000+****.

PresentTimeEnabled

Typ danych: Boolean

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [leniwe]

true(domyślnie), jeśli czas bieżący jest wymuszany przez program Configuration Manager.

PresentTimeIsGMT

Typ danych: Boolean

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [leniwe]

true jeśli czas zdefiniowany we PresentTime właściwości jest wyrażony w UMT. Wartość domyślna to false.

Priority

Typ danych: UInt32

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [wyliczenie]

Priorytet używany do replikowania reklamy do witryn podrzędnych. Poniżej przedstawiono możliwe wartości. Wartość domyślna to NORMAL (2).

ProgramName

Typ danych: String

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [Not_null]

Program w określonym pakiecie (PackageID), który ma być ogłaszany.

RemoteClientFlags

Typ danych: UInt32

Typ dostępu: Właściwość do odczytu i zapisu

Kwalifikatory: [bity]

Flagi określające sposób działania programu, gdy klient jest połączony lokalnie lub zdalnie z punktem dystrybucji. Poniżej przedstawiono możliwe wartości. Wartość domyślna to 48.

SourceSite

Typ danych: String

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt]

Trzyliterowy kod witryny, z której pochodzi reklama.

TimeFlags

Typ danych: UInt32

Typ dostępu: Tylko do odczytu

Kwalifikatory: [odczyt, bity]

Zarezerwowana do użytku wewnętrznego. Duplikuje informacje we właściwościach związanych z czasem. Poniżej przedstawiono możliwe wartości. Na przykład ENABLE_PRESENT jest ustawiane, gdy PresentTimeEnabled równa się true.

Uwagi

Kwalifikacje do tej klasy obejmują:

• Zabezpieczone

  Aby uzyskać więcej informacji zarówno o kwalifikatorach klas, jak i kwalifikatorach właściwości zawartych w sekcji Właściwości, zobacz Kwalifikatory klasy i właściwości programu Configuration Manager.

  Chociaż nie ma żadnych innych kluczowych właściwości, właściwości AdvertisementName, CollectionID, PackageID, i ProgramName są kwalifikowane jako NOT_NULL i należy podać wartości. Aplikacja nie może zaktualizować tych właściwości po utworzeniu wystąpienia klasy. Aby zmienić te wartości, aplikacja musi usunąć wystąpienie i utworzyć nowe wystąpienie z poprawnymi wartościami.

Wymagania

Wymagania dotyczące środowiska uruchomieniowego

Aby uzyskać więcej informacji, zobacz Wymagania dotyczące środowiska uruchomieniowego serwera programu Configuration Manager.

Wymagania dotyczące rozwoju

Aby uzyskać więcej informacji, zobacz Wymagania dotyczące programowania na serwerze programu Configuration Manager.