SMS_Advertisement sunucusu WMI sınıfı

SMS_Advertisement Windows Yönetim Araçları (WMI) sınıfı, Configuration Manager'de istemcilerde çalıştırılan yazılım paketi programlarını duyurmak için kullanılan bir reklamı temsil eden bir SMS Sağlayıcısı sunucu sınıfıdır.

Aşağıdaki söz dizimi Yönetilen Nesne Biçimi (MOF) kodundan basitleştirilmiştir ve devralınan tüm özellikleri içerir.

Sözdizimi

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

Yöntemler

Aşağıdaki tabloda sınıfındaki yöntemler listelemektedir SMS_Advertisement .

Yöntem	Açıklama
Sınıf SMS_Advertisement GetAdvertisements Yöntemi	Kaynağa hedeflenen tanıtım kimliklerini alır.
SMS_Advertisement Sınıfında GetNextID Yöntemi	Oluşturulan sonraki tanıtım için kullanılacak kimlik numarasını alır.
Sınıf SMS_Advertisement RiskyDeploymentStatusMessage Yöntemi	Riskli bir koleksiyona kullanıcı dağıtımı hakkında uyarı durumu iletisi gönderir.
SMS_Advertisement Sınıfında SetNextID Yöntemi	Oluşturulan sonraki tanıtım için kullanılacak kimlik numarasını ayarlar.
SMS_Advertisement Sınıfında SetSourceSite Yöntemi	Tanıtım için kaynak site kodunu ayarlar.
Sınıf SMS_Advertisement'nde Unlock Yöntemi	Kaynak siteyi geçerli siteye ayarlar ve reklamın kilidini açar. Uyarı: Bu yöntem kullanım dışıdır.

Özellikler

ActionInProgress

Veri türü: UInt32

Erişim türü: Salt okunur

Niteleyiciler: [okuma, numaralandırma]

Configuration Manager tarafından paket üzerinde gerçekleştirilen geçerli eylem. Olası değerler şunlardır:

Değer	Açıklama
0	HİÇBİRİ
1	GÜNCELLEŞTİRME
2	Ekle

AdvertFlags

Veri türü: UInt32

Erişim türü: Okuma/Yazma

Niteleyiciler: [bits]

Reklamın kullanıcıya nasıl duyurulması gerektiğini gösteren bayraklar. Olası değerler aşağıda listelenmiştir. Varsayılan değer: 0.

Onaltılık (Bit)	Açıklama
0x00000020 (5)	HEMEN. Reklamı kullanıcıya hemen duyurun.
0x00000100 (8)	ONSYSTEMSTARTUP. Reklamı sistem başlangıcında kullanıcıya duyurun.
0x00000200 (9)	ONUSERLOGON. Oturum açmada kullanıcıya reklamı duyurun.
0x00000400 (10)	ONUSERLOGOFF. Oturumu kapatarak kullanıcıya reklamı duyurun.
0x00001000 (12)	OPTIONALPREDOWNLOAD. Seçilen mimari ve dil istemcininkiyle eşleşiyorsa paket içeriği önceden indirilir
0x00008000 (15)	WINDOWS_CE. Reklam, bir cihaz istemcisi içindir.
0x00010000 (16)	ENABLE_PEER_CACHING. Bu bilgiler, Sp1 veya sonraki Configuration Manager System Center 2012 ve System Center 2012 R2 Configuration Manager veya üzeri için geçerlidir.
0x00020000 (17)	DONOT_FALLBACK. Korumasız dağıtım noktalarına geri dönmeyin.
0x00040000 (18)	ENABLE_TS_FROM_CD_AND_PXE. Görev dizisi çıkarılabilir medya ve önyükleme öncesi yürütme ortamı (PXE) hizmet noktası tarafından kullanılabilir.
0x00080000 (19)	APTSINTRANETONLY.
0x00100000 (20)	OVERRIDE_SERVICE_WINDOWS. Kullanıcıya tanıtım duyurusunda bakım pencerelerini geçersiz kılın.
0x00200000 (21)	REBOOT_OUTSIDE_OF_SERVICE_WINDOWS. Bakım pencerelerinin dışında yeniden başlatın.
0x00400000 (22)	WAKE_ON_LAN_ENABLED. Lan'da Uyandırma etkinken kullanıcıya reklamı duyurun.
0x00800000 (23)	SHOW_PROGRESS. Görev dizisinin ilerleme durumunu gösteren tanıtımı kullanıcıya duyurun.
0x02000000 (25)	NO_DISPLAY. Kullanıcı, atamadan bağımsız olarak programları çalıştırmamalıdır.
0x04000000 (26)	ONSLOWNET. Yavaş bir ağ bağlantısı üzerinden atamalar zorunlu hale getirin.
0x10000000 (28)	TARGETTOWINPE. Bu dağıtımı yalnızca WinPE'ye hedefleyin.
0x20000000 (29)	HIDDENINWINPE. Bu dağıtımı yalnızca WinPE olarak hedefleyin, ancak WinPE'de gizleyin. Yalnızca SMSTSPreferredAdvertID TS değişkeni tarafından kullanılabilir.

Bu bayraklar, tanıtılan programın özelliğinde ProgramFlags belirtilen bayraklarla eşgüdümlü olmalıdır. Örneğin, ONUSERLOGOFF ayarlarsanız, programdaki NOUSERLOGGEDIN bayrağı ayarlanmalıdır. Bayrak ayarları eşleşmiyorsa, program tanıtılmaz. Daha fazla bilgi için bkz. SMS_Program Sunucusu WMI Sınıfı.

IMMEDIATE, ONUSERLOGON veya ONUSERLOGOFF ayarını yapmak veya bir AssignedSchedule değer sağlamak, tanıtılan programı zorunlu kılar. Zorunlu bir program, istemci reklamı aldıktan sonra otomatik olarak çalıştırılır. İstemci yüklemeyi reddedemez veya erteleyemez.

NO_DISPLAY ve ONSLOWNET bitlerini yalnızca IMMEDIATE, ONUSERLOGON veya ONUSERLOGOFF biti ayarlandığında veya programın bir AssignedSchedule değeri olduğunda ayarlayın.

Kullanıcının programları atamadan bağımsız olarak çalıştırmasını istemediğinizde NO_DISPLAY ayarlayın. Bu bayrağı ayarlamazsanız, tanıtım reklamlar listesinde gösterilir ve atamadan bağımsız olarak çalıştırılabilir. Program yine de zorunlu olabilir.

Atamalar yavaş bir ağ bağlantısı üzerinden zorunlu olduğunda (örneğin, bir bilgisayar modem kullanarak bağlandığında) ONSLOWNET'i ayarlayın.

AdvertisementID

Veri türü: String

Erişim türü: Okuma/Yazma

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

Reklamı tanımlayan, otomatik olarak oluşturulan benzersiz anahtar. Varsayılan değer ""dir.

AdvertisementName

Veri türü: String

Erişim türü: Okuma/Yazma

Niteleyiciler: [Not_null]

Reklam için benzersiz kullanıcı dostu ad.

AssignedSchedule
Veri türü: SMS_ScheduleToken Dizi

Erişim türü: Okuma/Yazma

Niteleyiciler: [max(15), lazy]

SMS_ScheduleToken Sunucusu WMI Sınıfı nesneleri, istemcilerde reklamın ne zaman zorunlu hale geldiğini belirtir.

AssignedScheduleEnabled

Veri türü: Boolean

Erişim türü: Okuma/Yazma

Niteleyiciler: [tembel]

true özelliğinde AssignedSchedule tanımlanan zamanlama etkinse. Varsayılan değer şeklindedir false.

AssignedScheduleIsGMT

Veri türü: Boolean

Erişim türü: Okuma/Yazma

Niteleyiciler: [tembel]

true özelliğinde AssignedSchedule tanımlanan zamanlama Evrensel Ölçüm Süresi'nde (UMT) ise. Varsayılan değer şeklindedir false.

AssignmentID

Veri türü: UInt32

Erişim türü: Salt okunur

Niteleyiciler: [read]

Reklamla ilişkilendirilmiş ödevin kimliği.

CollectionID

Veri türü: String

Erişim türü: Okuma/Yazma

Niteleyiciler: [Not_null]

Reklamın hedeflendiği mevcut koleksiyon.

Comment

Veri türü: String

Erişim türü: Okuma/Yazma

Niteleyiciler: Yok

Reklamla ilgili basit açıklama veya not. Varsayılan değer ""dir.

DeviceFlags

Veri türü: UInt32

Erişim türü: Okuma/Yazma

Niteleyiciler: Yok

Cihazı açıklayan bayraklar. Olası değerler aşağıda listelenmiştir. Varsayılan değer: 0.

Onaltılık (Bit)	Açıklama
0x01000000 (24)	Her zaman istemciye program atayın.
0x02000000 (25)	Yalnızca cihaz şu anda yüksek bant genişliğine sahip bir bağlantıya bağlıysa atayın (varsayılan olarak 60 KB/sn'nin üzerinde).
0x04000000 (26)	Yalnızca cihaz yerleşikse, yani ActiveSync kullanan bir masaüstüne bağlıysa atayın.

ExpirationTime

Veri türü: DateTime

Erişim türü: Okuma/Yazma

Niteleyiciler: Yok

Reklamın istemciler tarafından artık kullanılamayışı tarih ve saat. Varsayılan değer 19900101000000.000000+***'dir.

ExpirationTimeEnabled

Veri türü: Boolean

Erişim türü: Okuma/Yazma

Niteleyiciler: [tembel]

true reklamın süresi özellik tarafından ExpirationTime belirtilen zamanda dolarsa. Varsayılan değer şeklindedir false.

ExpirationTimeIsGMT

Veri türü: Boolean

Erişim türü: Okuma/Yazma

Niteleyiciler: [tembel]

true özelliğinde ExpirationTime tanımlanan süre UMT içindeyse. Varsayılan değer şeklindedir false.

HierarchyPath

Veri türü: String

Erişim türü: Okuma/Yazma

Niteleyiciler: Yok

Saklı -dır.

IncludeSubCollection

Veri türü: Boolean

Erişim türü: Okuma/Yazma

Niteleyiciler: Yok

true (varsayılan) tanıtım belirtilen koleksiyonun alt koleksiyonlarına tanıtılıyorsa.

ISVData

Veri türü: Uint8 Dizi

Erişim türü: Okuma/Yazma

Niteleyiciler: [büyük, tembel]

Tek bir ISV'nin bir SMS_Program örnekle ilgili verileri depolamasına olanak tanıyan bilgiler. Bu veriler için herhangi bir kısıtlama veya tanımlı biçim yoktur. Ancak, ISV sahipliği oluşturulduktan sonra özelliğin üzerine yazılmaması önemlidir. Bu nedenle, çağıran uygulamanın önce bu özellikteki mevcut verileri okuması gerekir. Veriler uygulamaya ait değilse değiştirilmemelidir. Bu özelliği kullanan herhangi bir ISV veya uygulama sahibi, sahipliğin kolayca kurulabilmesi için verilere bir tanımlayıcı içermelidir.

ISVDataSize

Veri türü: UInt32

Erişim türü: Okuma/Yazma

Niteleyiciler: [tembel]

özelliği tarafından ISVData temsil edilen verilerin boyutu. Varsayılan değer: 0.

ISVString

Veri türü: String

Erişim türü: Okuma/Yazma

Niteleyiciler: yok

İş ortağı genişletilebilirliği dizesi.

MandatoryCountdown

Veri türü: UInt32

Erişim türü: Okuma/Yazma

Niteleyiciler: Yok

İşletim sistemi dağıtımı kullanıcı bildirimi zorunlu zamanlama geri sayımını göstermek için dakika cinsinden süre. Varsayılan değer: 0.

OfferType

Veri türü: UInt32

Erişim türü: Okuma/Yazma

Niteleyiciler: [numaralandırma]

Reklamın kullanıcılara hedeflendiğini gösteren tanıtım türü.

Değer	Açıklama
0	Gerekli
2	Kullanılabilir

PackageID

Veri türü: String

Erişim türü: Okuma/Yazma

Niteleyiciler: [Not_null]

Reklamla ilişkilendirilmiş mevcut bir paketin kimliği. Değer büyük harfle olmalıdır.

PresentTime

Veri türü: DateTime

Erişim türü: Okuma/Yazma

Niteleyiciler: Yok

Reklamın istemcilerin kullanımına sunulduğu tarih ve saat. Varsayılan değer 19900101000000.000000+***'dir.

PresentTimeEnabled

Veri türü: Boolean

Erişim türü: Okuma/Yazma

Niteleyiciler: [tembel]

true(varsayılan) geçerli saat Configuration Manager tarafından zorlanırsa.

PresentTimeIsGMT

Veri türü: Boolean

Erişim türü: Okuma/Yazma

Niteleyiciler: [tembel]

true özelliğinde PresentTime tanımlanan süre UMT içindeyse. Varsayılan değer şeklindedir false.

Priority

Veri türü: UInt32

Erişim türü: Okuma/Yazma

Niteleyiciler: [numaralandırma]

Reklamı alt sitelere çoğaltmada kullanılan öncelik. Olası değerler aşağıda listelenmiştir. Varsayılan değer NORMAL (2) değeridir.

Değer	Açıklama
1	YÜKSEK
2	NORMAL
3	Düşük

ProgramName

Veri türü: String

Erişim türü: Okuma/Yazma

Niteleyiciler: [Not_null]

Tanıtılacak belirtilen paket (PackageID) içindeki bir program.

RemoteClientFlags

Veri türü: UInt32

Erişim türü: Okuma/Yazma

Niteleyiciler: [bits]

İstemci yerel olarak veya uzaktan bir dağıtım noktasına bağlandığında programın nasıl çalışacağını belirten bayraklar. Olası değerler aşağıda listelenmiştir. Varsayılan değer 48'dir.

Onaltılık (Bit)	Açıklama
0x00000001 (0)	BATTERY_POWER. Pil gücünü kullanarak programı çalıştırın. Bu değer şu anda kullanılmamış.
0x00000002 (1)	RUN_FROM_CD. Programı CD'den çalıştırın. Bu değer şu anda kullanılmamış.
0x00000004 (2)	DOWNLOAD_FROM_CD. Programı CD'den indirin. Bu değer şu anda kullanılmamış.
0x00000008 (3)	RUN_FROM_LOCAL_DISPPOINT. Programı yerel dağıtım noktasından çalıştırın.
0x00000010 (4)	DOWNLOAD_FROM_LOCAL_DISPPOINT. Programı yerel dağıtım noktasından indirin.
0x00000020 (5)	DONT_RUN_NO_LOCAL_DISPPOINT. Yerel dağıtım noktası yoksa programı çalıştırmayın.
0x00000040 (6)	DOWNLOAD_FROM_REMOTE_DISPPOINT. Programı uzak dağıtım noktasından indirin.
0x00000080 (7)	RUN_FROM_REMOTE_DISPPOINT. Programı uzak dağıtım noktasından çalıştırın.
0x00000100 (8)	DOWNLOAD_ON_DEMAND_FROM_LOCAL_DP. Programı yerel dağıtım noktasından isteğe bağlı olarak indirin. Bu yalnızca görev dizileri için geçerlidir.
0x00000200 (9)	DOWNLOAD_ON_DEMAND_FROM_REMOTE_DP. Programı uzaktan dağıtım noktasından isteğe bağlı olarak indirin. Bu yalnızca görev dizileri için geçerlidir.
x00000400 (10)	BALLOON_REMINDERS_REQUIRED. Balon anımsatıcıları gereklidir.
0x00000800 (11)	RERUN_ALWAYS. Programı her zaman yeniden çalıştırın.
0x00001000 (12)	RERUN_NEVER. Programı asla yeniden çalıştırma.
0x00002000 (13)	RERUN_IF_FAILED. Yürütme daha önce başarısız olduysa programı yeniden çalıştırın.
0x00004000 (14)	RERUN_IF_SUCCEEDED. Yürütme daha önce başarılı olduysa programı yeniden çalıştırın.
0x00008000 (15)	PERSIST_ON_WRITE_FILTER_DEVICES Bu bilgiler, Sp1 veya sonraki Configuration Manager System Center 2012 ve System Center 2012 R2 Configuration Manager veya üzeri için geçerlidir.
0x00020000 (17)	T_FALLBACK Bu bilgiler, Sp1 veya sonraki Configuration Manager System Center 2012 ve System Center 2012 R2 Configuration Manager veya üzeri için geçerlidir.
0x00040000 (18)	DP_ALLOW_METERED_NETWORK Bu bilgiler, Sp1 veya sonraki Configuration Manager System Center 2012 ve System Center 2012 R2 Configuration Manager veya üzeri için geçerlidir.

SourceSite

Veri türü: String

Erişim türü: Salt okunur

Niteleyiciler: [read]

Reklamın kaynaklandığı sitenin üç harfli site kodu.

TimeFlags

Veri türü: UInt32

Erişim türü: Salt okunur

Niteleyiciler: [okuma, bitler]

dahili kullanım için ayrılmıştır. Zamanla ilgili özelliklerdeki bilgileri çoğaltan bayraklar. Olası değerler aşağıda listelenmiştir. Örneğin, eşit olduğunda PresentTimeEnabledtrueENABLE_PRESENT ayarlanır.

Onaltılık (Bit)	Açıklama
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

Açıklamalar

Bu sınıf için sınıf niteleyicileri şunlardır:

• Güvenli

  Özellikler bölümünde yer alan hem sınıf niteleyicileri hem de özellik niteleyicileri hakkında daha fazla bilgi için bkz. sınıf ve özellik niteleyicileri Configuration Manager.

  Başka anahtar özelliği olmasa da, , CollectionID, PackageIDve ProgramName özellikleri AdvertisementNameNOT_NULL olarak nitelenir ve değerler sağlanmalıdır. Bir sınıf örneği oluşturulduktan sonra uygulamanız bu özellikleri güncelleştiremez. Bu değerleri değiştirmek için uygulamanın örneği silip doğru değerlerle yeni bir örnek oluşturması gerekir.

Gereksinimler

Çalışma zamanı gereksinimleri

Daha fazla bilgi için bkz. Configuration Manager Sunucu Çalışma Zamanı Gereksinimleri.

Geliştirme gereksinimleri

Daha fazla bilgi için bkz. sunucu geliştirme gereksinimleri Configuration Manager.