WMI-klasse SMS_Advertisement-server
De SMS_Advertisement WMI-klasse (Windows Management Instrumentation) is een sms-providerserverklasse, in Configuration Manager, die een advertentie vertegenwoordigt die wordt gebruikt om softwarepakketprogramma's aan te kondigen die beschikbaar zijn voor uitvoering op clients.
De volgende syntaxis is vereenvoudigd van 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 de methoden in de SMS_Advertisement klasse.
| Methode | Beschrijving |
|---|---|
| Methode GetAdvertisements in klasse SMS_Advertisement | Hiermee haalt u de advertentie-id's op die zijn gericht op de resource. |
| Methode GetNextID in klasse SMS_Advertisement | Hiermee wordt het id-nummer opgehaald dat wordt gebruikt voor de volgende advertentie die wordt gemaakt. |
| Methode RiskyDeploymentStatusMessage in klasse SMS_Advertisement | Hiermee wordt een waarschuwingsstatusbericht verzonden over een gebruikersimplementatie naar een riskante verzameling. |
| Methode SetNextID in klasse SMS_Advertisement | Hiermee stelt u het id-nummer in dat wordt gebruikt voor de volgende advertentie die wordt gemaakt. |
| Methode SetSourceSite in klasse SMS_Advertisement | Hiermee stelt u de broncode voor de advertentie in. |
| Methode Ontgrendelen in klasse SMS_Advertisement | Hiermee stelt u de bronsite in op de huidige site, waarbij de advertentie wordt ontgrendeld. Waarschuwing: Deze methode is afgeschaft. |
Eigenschappen
ActionInProgress
Gegevenstype: UInt32
Toegangstype: Alleen-lezen
Kwalificatie: [lezen, opsomming]
Huidige actie die wordt uitgevoerd op het pakket door Configuration Manager. Mogelijke waarden zijn:
| Waarde | Beschrijving |
|---|---|
| 0 | GEEN |
| 1 | UPDATE |
| 2 | Toevoegen |
AdvertFlags
Gegevenstype: UInt32
Toegangstype: Lezen/schrijven
Kwalificatie: [bits]
Vlaggen die aangeven hoe de advertentie aan de gebruiker moet worden aangekondigd. Mogelijke waarden worden hieronder vermeld. De standaardwaarde is 0.
| Hexadecimaal (bit) | Beschrijving |
|---|---|
| 0x00000020 (5) | ONMIDDELLIJKE. Kondig de advertentie onmiddellijk aan de gebruiker aan. |
| 0x00000100 (8) | ONSYSTEMSTARTUP. Kondig de advertentie aan de gebruiker aan bij het opstarten van het systeem. |
| 0x00000200 (9) | ONUSERLOGON. Kondig de advertentie aan bij de gebruiker bij het aanmelden. |
| 0x00000400 (10) | ONUSERLOGOFF. Kondig de advertentie aan de gebruiker aan bij het afmelden. |
| 0x00001000 (12) | OPTIONEELPREDOWNLOADEN. Als de geselecteerde architectuur en taal overeenkomen met die van de client, wordt de pakketinhoud van tevoren gedownload |
| 0x00008000 (15) | WINDOWS_CE. De advertentie is voor een apparaatclient. |
| 0x00010000 (16) | ENABLE_PEER_CACHING. Deze informatie is van toepassing op System Center 2012 Configuration Manager SP1 of hoger en System Center 2012 R2 Configuration Manager of hoger. |
| 0x00020000 (17) | DONOT_FALLBACK. Niet terugvallen op niet-beveiligde distributiepunten. |
| 0x00040000 (18) | ENABLE_TS_FROM_CD_AND_PXE. De takenreeks is beschikbaar voor verwisselbare media en het PXE-servicepunt (Pre-Boot Execution Environment). |
| 0x00080000 (19) | APTSINTRANETONLY. |
| 0x00100000 (20) | OVERRIDE_SERVICE_WINDOWS. Overschrijf onderhoudsvensters bij het aankondigen van de advertentie aan de gebruiker. |
| 0x00200000 (21) | REBOOT_OUTSIDE_OF_SERVICE_WINDOWS. Start opnieuw op buiten onderhoudsvensters. |
| 0x00400000 (22) | WAKE_ON_LAN_ENABLED. Kondig de advertentie aan de gebruiker aan met Wake On LAN ingeschakeld. |
| 0x00800000 (23) | SHOW_PROGRESS. Kondig de advertentie aan de gebruiker aan waarin de voortgang van de takenreeks wordt weergegeven. |
| 0x02000000 (25) | NO_DISPLAY. De gebruiker mag geen programma's onafhankelijk van de toewijzing uitvoeren. |
| 0x04000000 (26) | ONSLOWNET. Toewijzingen zijn verplicht via een trage netwerkverbinding. |
| 0x10000000 (28) | TARGETTOWINPE. Richt deze implementatie alleen op WinPE. |
| 0x20000000 (29) | HIDDENINWINPE. Richt deze implementatie alleen op WinPE, maar verberg deze in WinPE. Deze kan alleen worden gebruikt door TS-variabele SMSTSPreferredAdvertID. |
Deze vlaggen moeten worden gecoördineerd met de vlaggen die zijn opgegeven in de ProgramFlags eigenschap van het geadverteerde programma. Als u bijvoorbeeld ONUSERLOGOFF instelt, moet de vlag NOUSERLOGGEDIN in het programma worden ingesteld. Als de vlaginstellingen niet overeenkomen, wordt het programma niet geadverteerd. Zie WMI-klasse SMS_Program server voor meer informatie.
Als u IMMEDIATE, ONUSERLOGON of ONUSERLOGOFF instelt of een AssignedSchedule waarde opgeeft, wordt het geadverteerde programma verplicht. Een verplicht programma wordt automatisch uitgevoerd nadat de client 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 wanneer u niet wilt dat de gebruiker programma's onafhankelijk van de toewijzing uitvoert. Als u deze vlag niet instelt, wordt de advertentie weergegeven in de lijst met advertenties en kan deze onafhankelijk van de toewijzing 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 via een modem.
AdvertisementID
Gegevenstype: String
Toegangstype: Lezen/schrijven
Kwalificatie: [sleutel, 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
Kwalificatie: [Not_null]
Unieke gebruiksvriendelijke naam voor de advertentie.
AssignedSchedule
Gegevenstype: SMS_ScheduleToken Matrix
Toegangstype: Lezen/schrijven
Kwalificatie: [max(15), lui]
SMS_ScheduleToken WMI-klasseobjecten van de server die het tijdstip aangeven waarop de advertentie verplicht wordt op de clients.
AssignedScheduleEnabled
Gegevenstype: Boolean
Toegangstype: Lezen/schrijven
Kwalificatie: [lui]
true als de planning die is gedefinieerd in de AssignedSchedule eigenschap actief is. De standaardwaarde is false.
AssignedScheduleIsGMT
Gegevenstype: Boolean
Toegangstype: Lezen/schrijven
Kwalificatie: [lui]
true als het schema dat is gedefinieerd in de AssignedSchedule eigenschap Universal Metric Time (UMT). De standaardwaarde is false.
AssignmentID
Gegevenstype: UInt32
Toegangstype: Alleen-lezen
Kwalificatie: [lezen]
Id van de toewijzing die is gekoppeld aan de advertentie.
CollectionID
Gegevenstype: String
Toegangstype: Lezen/schrijven
Kwalificatie: [Not_null]
Bestaande verzameling waarop de advertentie is gericht.
Comment
Gegevenstype: String
Toegangstype: Lezen/schrijven
Kwalificatie: Geen
Eenvoudige beschrijving of opmerking over de advertentie. De standaardwaarde is ''.
DeviceFlags
Gegevenstype: UInt32
Toegangstype: Lezen/schrijven
Kwalificatie: Geen
Vlaggen die het apparaat beschrijven. Mogelijke waarden worden hieronder vermeld. De standaardwaarde is 0.
| Hexadecimaal (bit) | Beschrijving |
|---|---|
| 0x01000000 (24) | Wijs altijd een programma toe aan de client. |
| 0x02000000 (25) | Wijs alleen toe als het apparaat momenteel is verbonden met een verbinding met hoge bandbreedte (standaard hoger dan 60 KBps). |
| 0x04000000 (26) | Wijs alleen toe als het apparaat is gekoppeld aan een bureaublad dat Gebruikmaakt van ActiveSync. |
ExpirationTime
Gegevenstype: DateTime
Toegangstype: Lezen/schrijven
Kwalificatie: Geen
Datum en tijd waarop de advertentie niet meer beschikbaar is voor klanten. De standaardwaarde is 1990010100000.000000+****.
ExpirationTimeEnabled
Gegevenstype: Boolean
Toegangstype: Lezen/schrijven
Kwalificatie: [lui]
true als de advertentie verloopt op het tijdstip dat door de ExpirationTime eigenschap wordt aangegeven. De standaardwaarde is false.
ExpirationTimeIsGMT
Gegevenstype: Boolean
Toegangstype: Lezen/schrijven
Kwalificatie: [lui]
true als de tijd die in de ExpirationTime eigenschap is gedefinieerd, in UMT is. De standaardwaarde is false.
HierarchyPath
Gegevenstype: String
Toegangstype: Lezen/schrijven
Kwalificatie: Geen
Gereserveerd.
IncludeSubCollection
Gegevenstype: Boolean
Toegangstype: Lezen/schrijven
Kwalificatie: Geen
true (standaard) als de advertentie wordt aangekondigd aan de subverzamelingen van de opgegeven verzameling.
ISVData
Gegevenstype: Uint8 Matrix
Toegangstype: Lezen/schrijven
Kwalificatie: [groot, lui]
Informatie waarmee één ISV gegevens met betrekking tot een SMS_Program exemplaar kan opslaan. Er zijn geen beperkingen of gedefinieerde indelingen voor deze gegevens. Het is echter belangrijk om de eigenschap niet te overschrijven nadat het ISV-eigendom is vastgesteld. Daarom moet de aanroepende toepassing eerst de bestaande gegevens in deze eigenschap lezen. Als de gegevens niet bij de toepassing horen, mogen ze niet worden gewijzigd. Elke ISV of toepassingseigenaar die deze eigenschap gebruikt, moet een id in de gegevens opnemen, zodat het eigendom eenvoudig kan worden vastgesteld.
ISVDataSize
Gegevenstype: UInt32
Toegangstype: Lezen/schrijven
Kwalificatie: [lui]
De grootte van de gegevens die worden vertegenwoordigd door de ISVData eigenschap. De standaardwaarde is 0.
ISVString
Gegevenstype: String
Toegangstype: Lezen/schrijven
Kwalificatie: geen
Tekenreeks voor uitbreidbaarheid van partners.
MandatoryCountdown
Gegevenstype: UInt32
Toegangstype: Lezen/schrijven
Kwalificatie: Geen
Duur, in minuten, voor het weergeven van verplichte aftelling van gebruikersmelding voor besturingssysteemimplementatie. De standaardwaarde is 0.
OfferType
Gegevenstype: UInt32
Toegangstype: Lezen/schrijven
Kwalificatie: [opsomming]
Advertentietype dat aangeeft dat de advertentie is gericht op gebruikers.
| Waarde | Beschrijving |
|---|---|
| 0 | Vereist |
| 2 | Beschikbaar |
PackageID
Gegevenstype: String
Toegangstype: Lezen/schrijven
Kwalificatie: [Not_null]
Id voor een bestaand pakket dat is gekoppeld aan de advertentie. De waarde moet in hoofdletters staan.
PresentTime
Gegevenstype: DateTime
Toegangstype: Lezen/schrijven
Kwalificatie: Geen
Datum en tijd waarop de advertentie beschikbaar wordt gesteld aan klanten. De standaardwaarde is 1990010100000.000000+****.
PresentTimeEnabled
Gegevenstype: Boolean
Toegangstype: Lezen/schrijven
Kwalificatie: [lui]
true(standaard) als de huidige tijd wordt afgedwongen door Configuration Manager.
PresentTimeIsGMT
Gegevenstype: Boolean
Toegangstype: Lezen/schrijven
Kwalificatie: [lui]
true als de tijd die in de PresentTime eigenschap is gedefinieerd, in UMT is. De standaardwaarde is false.
Priority
Gegevenstype: UInt32
Toegangstype: Lezen/schrijven
Kwalificatie: [opsomming]
De prioriteit die wordt gebruikt bij het repliceren van de advertentie naar onderliggende sites. Mogelijke waarden worden hieronder vermeld. De standaardwaarde is NORMAL (2).
| Waarde | Beschrijving |
|---|---|
| 1 | HOGE |
| 2 | NORMALE |
| 3 | Lage |
ProgramName
Gegevenstype: String
Toegangstype: Lezen/schrijven
Kwalificatie: [Not_null]
Een programma binnen het opgegeven pakket (PackageID) dat moet worden geadverteerd.
RemoteClientFlags
Gegevenstype: UInt32
Toegangstype: Lezen/schrijven
Kwalificatie: [bits]
Vlaggen die aangeven hoe het programma moet worden uitgevoerd wanneer de client lokaal of extern is verbonden met een distributiepunt. Mogelijke waarden worden hieronder vermeld. De standaardwaarde is 48.
| Hexadecimaal (bit) | Beschrijving |
|---|---|
| 0x00000001 (0) | BATTERY_POWER. Voer het programma uit met behulp van batterijvoeding. Deze waarde is momenteel ongebruikt. |
| 0x00000002 (1) | RUN_FROM_CD. Voer het programma uit vanaf cd. Deze waarde is momenteel ongebruikt. |
| 0x00000004 (2) | DOWNLOAD_FROM_CD. Download het programma van CD. Deze waarde is momenteel ongebruikt. |
| 0x00000008 (3) | RUN_FROM_LOCAL_DISPPOINT. Voer het programma uit vanaf het lokale distributiepunt. |
| 0x00000010 (4) | DOWNLOAD_FROM_LOCAL_DISPPOINT. Download het programma vanaf het lokale distributiepunt. |
| 0x00000020 (5) | DONT_RUN_NO_LOCAL_DISPPOINT. Voer het programma niet uit als er geen lokaal distributiepunt is. |
| 0x00000040 (6) | DOWNLOAD_FROM_REMOTE_DISPPOINT. Download het programma vanaf het externe distributiepunt. |
| 0x00000080 (7) | RUN_FROM_REMOTE_DISPPOINT. Voer het programma uit vanaf het externe distributiepunt. |
| 0x00000100 (8) | DOWNLOAD_ON_DEMAND_FROM_LOCAL_DP. Download het programma op aanvraag van het lokale distributiepunt. Dit is alleen van toepassing op takenreeksen. |
| 0x00000200 (9) | DOWNLOAD_ON_DEMAND_FROM_REMOTE_DP. Download het programma op aanvraag vanaf het externe distributiepunt. Dit is alleen van toepassing op takenreeksen. |
| x00000400 (10) | BALLOON_REMINDERS_REQUIRED. Ballonherinneringen zijn vereist. |
| 0x00000800 (11) | RERUN_ALWAYS. Voer het programma altijd opnieuw uit. |
| 0x00001000 (12) | RERUN_NEVER. Voer het programma nooit opnieuw uit. |
| 0x00002000 (13) | RERUN_IF_FAILED. Voer het programma opnieuw uit als de uitvoering eerder is mislukt. |
| 0x00004000 (14) | RERUN_IF_SUCCEEDED. Voer het programma opnieuw uit als de uitvoering eerder is geslaagd. |
| 0x00008000 (15) | PERSIST_ON_WRITE_FILTER_DEVICES Deze informatie is van toepassing op System Center 2012 Configuration Manager SP1 of hoger en System Center 2012 R2 Configuration Manager of hoger. |
| 0x00020000 (17) | DON'T_FALLBACK Deze informatie is van toepassing op System Center 2012 Configuration Manager SP1 of hoger en System Center 2012 R2 Configuration Manager of hoger. |
| 0x00040000 (18) | DP_ALLOW_METERED_NETWORK Deze informatie is van toepassing op System Center 2012 Configuration Manager SP1 of hoger en System Center 2012 R2 Configuration Manager of hoger. |
SourceSite
Gegevenstype: String
Toegangstype: Alleen-lezen
Kwalificatie: [lezen]
Drieletterige sitecode van de site waar de advertentie vandaan komt.
TimeFlags
Gegevenstype: UInt32
Toegangstype: Alleen-lezen
Kwalificatie: [lezen, bits]
Gereserveerd voor intern gebruik. Hiermee worden de gegevens in de tijdgerelateerde eigenschappen gedupliceerd. Mogelijke waarden worden hieronder vermeld. ENABLE_PRESENT wordt bijvoorbeeld ingesteld als PresentTimeEnabled gelijk is aan true.
| Hexadecimaal (bit) | Beschrijving |
|---|---|
| 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 |
Opmerkingen
Klaskwalificaties voor deze klasse zijn onder andere:
Beveiligd
Zie Configuration Manager Class en Property Qualifiers voor meer informatie over zowel de klassekwalificaties als de eigenschappen die zijn opgenomen in de sectie Eigenschappen.
Hoewel er geen andere sleuteleigenschappen zijn, worden de eigenschappen
AdvertisementName,CollectionID,PackageIDenProgramNamegekwalificeerd 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 maken met de juiste waarden.
Vereisten
Runtimevereisten
Zie runtimevereisten voor Configuration Manager server voor meer informatie.
Ontwikkelingsvereisten
Zie vereisten voor Configuration Manager serverontwikkeling voor meer informatie.