klasa WMI serwera SMS_Advertisement

Klasa SMS_Advertisement Instrumentacja zarządzania windows (WMI) jest klasą serwera dostawcy programu SMS w Configuration Manager, która reprezentuje anons używany do ogłaszania programów pakietów oprogramowania, które są dostępne do uruchamiania na klientach.

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

Składni

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

W poniższej tabeli wymieniono metody w klasie SMS_Advertisement .

Metoda	Opis
GetAdvertisements, metoda w klasie SMS_Advertisement	Pobiera identyfikatory anonsu, które są przeznaczone dla zasobu.
GetNextID, metoda w klasie SMS_Advertisement	Pobiera numer identyfikatora, który będzie używany dla następnego utworzonego anonsu.
RiskyDeploymentStatusMessage, metoda w klasie SMS_Advertisement	Wysyła komunikat o stanie ostrzeżenia o wdrożeniu użytkownika do ryzykownej kolekcji.
SetNextID, metoda w klasie SMS_Advertisement	Ustawia numer identyfikatora, który będzie używany dla następnego utworzonego anonsu.
SetSourceSite, metoda w klasie SMS_Advertisement	Ustawia kod witryny źródłowej dla anonsu.
Unlock Method in Class SMS_Advertisement	Ustawia lokację źródłową na bieżącą witrynę, odblokowując anons. Ostrzeżenie: Ta metoda jest przestarzała.

Właściwości

ActionInProgress

Typ danych: UInt32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt, wyliczenie]

Bieżąca akcja wykonywana na pakiecie przez Configuration Manager. Możliwe wartości to:

Value	Opis
0	BRAK
1	AKTUALIZACJI
2	Dodaj

AdvertFlags

Typ danych: UInt32

Typ dostępu: odczyt/zapis

Kwalifikatory: [bity]

Flagi wskazujące sposób ogłaszania anonsu użytkownikowi. Poniżej wymieniono możliwe wartości. Wartość domyślna to 0.

Szesnastkowa (bitowa)	Opis
0x00000020 (5)	NATYCHMIASTOWE. Natychmiast ogłaszaj reklamę użytkownikowi.
0x00000100 (8)	ONSYSTEMSTARTUP. Ogłaszanie anonsu użytkownikowi podczas uruchamiania systemu.
0x00000200 (9)	ONUSERLOGON. Ogłaszanie anonsu użytkownikowi podczas logowania.
0x00000400 (10)	ONUSERLOGOFF. Ogłaszanie reklamy użytkownikowi przy wylogowaniu.
0x00001000 (12)	OPTIONALPREDOWNLOAD. Jeśli wybrana architektura i język są zgodne z architekturą klienta, zawartość pakietu zostanie pobrana z wyprzedzeniem
0x00008000 (15)	WINDOWS_CE. Anons dotyczy klienta urządzenia.
0x00010000 (16)	ENABLE_PEER_CACHING. Te informacje dotyczą programu System Center 2012 Configuration Manager SP1 lub nowszego oraz programu System Center 2012 R2 Configuration Manager lub nowszego.
0x00020000 (17)	DONOT_FALLBACK. Nie należy wracać do niechronionych punktów dystrybucji.
0x00040000 (18)	ENABLE_TS_FROM_CD_AND_PXE. Sekwencja zadań jest dostępna dla nośników wymiennych i punktu obsługi środowiska wykonywania przed rozruchem (PXE).
0x00080000 (19)	APTSINTRANETONLY.
0x00100000 (20)	OVERRIDE_SERVICE_WINDOWS. Zastąp okna obsługi, ogłaszając anons użytkownikowi.
0x00200000 (21)	REBOOT_OUTSIDE_OF_SERVICE_WINDOWS. Uruchom ponownie poza oknami obsługi.
0x00400000 (22)	WAKE_ON_LAN_ENABLED. Ogłaszanie anonsu użytkownikowi z włączoną funkcją Wake On LAN.
0x00800000 (23)	SHOW_PROGRESS. Ogłaszanie użytkownikowi anonsu przedstawiającego postęp sekwencji zadań.
0x02000000 (25)	NO_DISPLAY. Użytkownik nie powinien uruchamiać programów niezależnie od przypisania.
0x04000000 (26)	ONSLOWNET. Przypisania są obowiązkowe w przypadku powolnego połączenia sieciowego.
0x10000000 (28)	TARGETTOWINPE. Nakieruj to wdrożenie tylko na winpe.
0x20000000 (29)	HIDDENINWINPE. To wdrożenie jest przeznaczone tylko dla środowiska WinPE, ale ukrywa się w winpe. Może być używany tylko przez zmienną TS SMSTSPreferredAdvertID.

Te flagi muszą być skoordynowane z flagami określonymi we ProgramFlags właściwości anonsowanego programu. Jeśli na przykład ustawiono ustawienie ONUSERLOGOFF, należy ustawić flagę NOUSERLOGGEDIN w programie. Jeśli ustawienia flagi nie są zgodne, program nie jest anonsowany. Aby uzyskać więcej informacji, zobacz SMS_Program Server WMI Class (Klasa WMI serwera SMS_Program).

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

Ustaw bity NO_DISPLAY i ONSLOWNET 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 ta flaga nie zostanie ustawiona, anons zostanie wyświetlony na liście anonsów i może być uruchamiany niezależnie od przypisania. Program nadal może być obowiązkowy.

Ustaw onslownet, gdy przypisania są obowiązkowe przez wolne połączenie sieciowe, na przykład gdy komputer łączy się przy użyciu modemu.

AdvertisementID

Typ danych: String

Typ dostępu: odczyt/zapis

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

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

AdvertisementName

Typ danych: String

Typ dostępu: odczyt/zapis

Kwalifikatory: [Not_null]

Unikatowa przyjazna dla użytkownika nazwa anonsu.

AssignedSchedule
Typ danych: SMS_ScheduleToken Tablica

Typ dostępu: odczyt/zapis

Kwalifikatory: [max(15), lazy]

SMS_ScheduleToken obiekty klasy WMI serwera wskazujące czas, kiedy anons staje się obowiązkowy dla klientów.

AssignedScheduleEnabled

Typ danych: Boolean

Typ dostępu: odczyt/zapis

Kwalifikatory: [leniwy]

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

AssignedScheduleIsGMT

Typ danych: Boolean

Typ dostępu: odczyt/zapis

Kwalifikatory: [leniwy]

true jeśli harmonogram zdefiniowany AssignedSchedule we właściwości znajduje się w uniwersalnym czasie metryki (UMT). Wartość domyślna to false.

AssignmentID

Typ danych: UInt32

Typ dostępu: tylko do odczytu

Kwalifikatory: [odczyt]

Identyfikator przypisania skojarzonego z anonsem.

CollectionID

Typ danych: String

Typ dostępu: odczyt/zapis

Kwalifikatory: [Not_null]

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

Comment

Typ danych: String

Typ dostępu: odczyt/zapis

Kwalifikatory: Brak

Prosty opis lub uwaga dotycząca anonsu. Wartość domyślna to "".

DeviceFlags

Typ danych: UInt32

Typ dostępu: odczyt/zapis

Kwalifikatory: Brak

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

Szesnastkowa (bitowa)	Opis
0x01000000 (24)	Zawsze przypisuj program do klienta.
0x02000000 (25)	Przypisz tylko wtedy, gdy urządzenie jest obecnie połączone z połączeniem o wysokiej przepustowości (domyślnie powyżej 60 KB/s).
0x04000000 (26)	Przypisz tylko wtedy, gdy urządzenie jest zadokowane, oznacza to, że jest dołączone do pulpitu używającego narzędzia ActiveSync.

ExpirationTime

Typ danych: DateTime

Typ dostępu: odczyt/zapis

Kwalifikatory: Brak

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

ExpirationTimeEnabled

Typ danych: Boolean

Typ dostępu: odczyt/zapis

Kwalifikatory: [leniwy]

true jeśli anons wygaśnie w czasie wskazanym przez właściwość ExpirationTime . Wartość domyślna to false.

ExpirationTimeIsGMT

Typ danych: Boolean

Typ dostępu: odczyt/zapis

Kwalifikatory: [leniwy]

true jeśli czas zdefiniowany ExpirationTime we właściwości znajduje się w UMT. Wartość domyślna to false.

HierarchyPath

Typ danych: String

Typ dostępu: odczyt/zapis

Kwalifikatory: Brak

Zastrzeżone.

IncludeSubCollection

Typ danych: Boolean

Typ dostępu: odczyt/zapis

Kwalifikatory: Brak

true (wartość domyślna), jeśli anons jest anonsowany do podkolekcji określonej kolekcji.

ISVData

Typ danych: Uint8 Tablica

Typ dostępu: odczyt/zapis

Kwalifikatory: [duży, leniwy]

Informacje, które umożliwiają jednemu niezależnemu dostawcy oprogramowania przechowywanie danych dotyczących SMS_Program wystąpienia. Nie ma żadnych ograniczeń ani zdefiniowanych formatów dla tych danych. Ważne jest jednak, aby nie zastępować właściwości po ustanowieniu jej własności niezależnego dostawcy oprogramowania. W związku z tym 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 isv lub właściciel aplikacji, który korzysta z tej właściwości, powinien zawierać identyfikator w danych, aby można było łatwo ustanowić własność.

ISVDataSize

Typ danych: UInt32

Typ dostępu: odczyt/zapis

Kwalifikatory: [leniwy]

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

ISVString

Typ danych: String

Typ dostępu: odczyt/zapis

Kwalifikatory: brak

Ciąg rozszerzalności partnera.

MandatoryCountdown

Typ danych: UInt32

Typ dostępu: odczyt/zapis

Kwalifikatory: Brak

Czas trwania, w minutach, aby wyświetlić powiadomienie użytkownika wdrożenia systemu operacyjnego obowiązkowe odliczanie harmonogramu. Wartość domyślna to 0.

OfferType

Typ danych: UInt32

Typ dostępu: odczyt/zapis

Kwalifikatory: [wyliczenie]

Typ anonsu wskazujący, że anons jest przeznaczony dla użytkowników.

Value	Opis
0	Wymagany
2	Dostępna

PackageID

Typ danych: String

Typ dostępu: odczyt/zapis

Kwalifikatory: [Not_null]

Identyfikator istniejącego pakietu skojarzonego z anonsem. Wartość musi być w wielkich literach.

PresentTime

Typ danych: DateTime

Typ dostępu: odczyt/zapis

Kwalifikatory: Brak

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

PresentTimeEnabled

Typ danych: Boolean

Typ dostępu: odczyt/zapis

Kwalifikatory: [leniwy]

true(wartość domyślna), jeśli obecny czas jest wymuszany przez Configuration Manager.

PresentTimeIsGMT

Typ danych: Boolean

Typ dostępu: odczyt/zapis

Kwalifikatory: [leniwy]

true jeśli czas zdefiniowany PresentTime we właściwości znajduje się w UMT. Wartość domyślna to false.

Priority

Typ danych: UInt32

Typ dostępu: odczyt/zapis

Kwalifikatory: [wyliczenie]

Priorytet używany podczas replikowania anonsu do lokacji podrzędnych. Poniżej wymieniono możliwe wartości. Wartość domyślna to NORMAL (2).

Value	Opis
1	WYSOKIEJ
2	NORMALNE
3	Niskie

ProgramName

Typ danych: String

Typ dostępu: odczyt/zapis

Kwalifikatory: [Not_null]

Program w ramach określonego pakietu (PackageID) do anonsowania.

RemoteClientFlags

Typ danych: UInt32

Typ dostępu: odczyt/zapis

Kwalifikatory: [bity]

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

Szesnastkowa (bitowa)	Opis
0x00000001 (0)	BATTERY_POWER. Uruchom program przy użyciu zasilania baterii. Ta wartość jest obecnie nieużywana.
0x00000002 (1)	RUN_FROM_CD. Uruchom program z dysku CD. Ta wartość jest obecnie nieużywana.
0x00000004 (2)	DOWNLOAD_FROM_CD. Pobierz program z dysku CD. Ta wartość jest obecnie nieużywana.
0x00000008 (3)	RUN_FROM_LOCAL_DISPPOINT. Uruchom program z lokalnego punktu dystrybucji.
0x00000010 (4)	DOWNLOAD_FROM_LOCAL_DISPPOINT. Pobierz program z lokalnego punktu dystrybucji.
0x00000020 (5)	DONT_RUN_NO_LOCAL_DISPPOINT. Nie uruchamiaj programu, jeśli nie ma lokalnego punktu dystrybucji.
0x00000040 (6)	DOWNLOAD_FROM_REMOTE_DISPPOINT. Pobierz program ze zdalnego punktu dystrybucji.
0x00000080 (7)	RUN_FROM_REMOTE_DISPPOINT. Uruchom program ze zdalnego punktu dystrybucji.
0x00000100 (8)	DOWNLOAD_ON_DEMAND_FROM_LOCAL_DP. Pobierz program na żądanie z lokalnego punktu dystrybucji. Dotyczy to tylko sekwencji zadań.
0x00000200 (9)	DOWNLOAD_ON_DEMAND_FROM_REMOTE_DP. Pobierz program na żądanie ze zdalnego punktu dystrybucji. Dotyczy to tylko sekwencji zadań.
x00000400 (10)	BALLOON_REMINDERS_REQUIRED. Wymagane są przypomnienia o dymku.
0x00000800 (11)	RERUN_ALWAYS. Zawsze uruchamiaj ponownie program.
0x00001000 (12)	RERUN_NEVER. Nigdy nie uruchamiaj ponownie programu.
0x00002000 (13)	RERUN_IF_FAILED. Uruchom ponownie program, jeśli wykonanie wcześniej nie powiodło się.
0x00004000 (14)	RERUN_IF_SUCCEEDED. Uruchom ponownie program, jeśli wykonanie wcześniej zakończyło się pomyślnie.
0x00008000 (15)	PERSIST_ON_WRITE_FILTER_DEVICES Te informacje dotyczą programu System Center 2012 Configuration Manager SP1 lub nowszego oraz programu System Center 2012 R2 Configuration Manager lub nowszego.
0x00020000 (17)	DON'T_FALLBACK Te informacje dotyczą programu System Center 2012 Configuration Manager SP1 lub nowszego oraz programu System Center 2012 R2 Configuration Manager lub nowszego.
0x00040000 (18)	DP_ALLOW_METERED_NETWORK Te informacje dotyczą programu System Center 2012 Configuration Manager SP1 lub nowszego oraz programu System Center 2012 R2 Configuration Manager lub nowszego.

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]

Zarezerwowane do użytku wewnętrznego. Flagi, które duplikują informacje we właściwościach związanych z czasem. Poniżej wymieniono możliwe wartości. Na przykład ENABLE_PRESENT jest ustawiana, gdy PresentTimeEnabled jest równa true.

Szesnastkowa (bitowa)	Opis
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

Uwagi

Kwalifikatory klas dla tej klasy obejmują:

• Zabezpieczone

  Aby uzyskać więcej informacji na temat kwalifikatorów klas i kwalifikatorów właściwości zawartych w sekcji Właściwości, zobacz Configuration Manager Class and Property Qualifiers (Kwalifikatory klasy Configuration Manager i właściwości).

  Chociaż nie ma żadnych innych właściwości klucza, właściwości AdvertisementName, CollectionID, PackageIDi ProgramName są kwalifikowane jako NOT_NULL, a wartości muszą być podane. 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 odpowiednimi wartościami.

Wymagania

Wymagania dotyczące środowiska uruchomieniowego

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

Wymagania dotyczące programowania

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