Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
WMI-klassen SMS_Advertisement (Windows Management Instrumentation) är en SMS-providerserverklass i Configuration Manager som representerar en annons som används för att meddela program som är tillgängliga för körning på klienter.
Följande syntax är förenklad från MOF-kod (Managed Object Format) och innehåller alla ärvda egenskaper.
Syntax
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;
};
Metoder
Metoderna i klassen visas i följande SMS_Advertisement tabell.
| Metod | Beskrivning |
|---|---|
| GetAdvertisements-metoden i klass SMS_Advertisement | Hämtar annonserings-ID:t som är riktat till resursen. |
| GetNextID-metoden i klass SMS_Advertisement | Hämtar ID-numret som ska användas för nästa annons som skapas. |
| RiskyDeploymentStatusMessage-metoden i klass SMS_Advertisement | Skickar ett varningsmeddelande om en användardistribution till en riskfylld samling. |
| SetNextID-metoden i klass SMS_Advertisement | Anger det ID-nummer som ska användas för nästa annons som skapas. |
| SetSourceSite-metoden i klass SMS_Advertisement | Anger källkoden för annonsen. |
| Upplåsningsmetod i klass SMS_Advertisement | Anger den aktuella webbplatsen som källwebbplats och låser upp annonsen. Varning: Den här metoden är inaktuell. |
Egenskaper
ActionInProgress
Datatyp: UInt32
Åtkomsttyp: Skrivskyddad
Kvalificerare: [läs, uppräkning]
Den aktuella åtgärden som utförs på paketet av Configuration Manager. Möjliga värden är:
| Värde | Beskrivning |
|---|---|
| 0 | INGEN |
| 1 | UPPDATERING |
| 2 | LÄGG TILL |
AdvertFlags
Datatyp: UInt32
Åtkomsttyp: Läsa/skriva
Kvalificerare: [bitar]
Flaggor som anger hur annonsen ska meddelas användaren. Möjliga värden anges nedan. Standardvärdet är 0.
| Hexadecimal (bit) | Beskrivning |
|---|---|
| 0x00000020 (5) | OMEDELBAR. Meddela användaren om annonsen omedelbart. |
| 0x00000100 (8) | ONSYSTEMSTARTUP. Meddela användaren om meddelandet när systemet startar. |
| 0x00000200 (9) | ONUSERLOGON. Meddela användaren om annonsen vid inloggningen. |
| 0x00000400 (10) | ONUSERLOGOFF. Meddela användaren om annonsen vid utloggning. |
| 0x00001000 (12) | VALFRI FÖRHANDSNEDLADDNING. Om den valda arkitekturen och språket matchar klientens, laddas paketets innehåll ned i förväg |
| 0x00008000 (15) | WINDOWS_CE. Annonsen gäller för en enhetsklient. |
| 0x00010000 (16) | ENABLE_PEER_CACHING. Den här informationen gäller System Center 2012 Configuration Manager SP1 eller senare och System Center 2012 R2 Configuration Manager eller senare. |
| 0x00020000 (17) | DONOT_FALLBACK. Gå inte tillbaka till oskyddade distributionsplatser. |
| 0x00040000 (18) | ENABLE_TS_FROM_CD_AND_PXE. Aktivitetssekvensen är tillgänglig för flyttbara media och PXE-tjänstplatsen (Pre-Boot Execution Environment). |
| 0x00080000 (19) | APTSINTRANETONLY. |
| 0x00100000 (20) | OVERRIDE_SERVICE_WINDOWS. Åsidosätt underhållsperioder när du meddelar användaren om annonsen. |
| 0x00200000 (21) | REBOOT_OUTSIDE_OF_SERVICE_WINDOWS. Starta om utanför underhållsperioderna. |
| 0x00400000 (22) | WAKE_ON_LAN_ENABLED. Meddela reklamen till användaren med Wake On LAN aktiverat. |
| 0x00800000 (23) | SHOW_PROGRESS. Meddela användaren om annonsen som visar aktivitetssekvensens förlopp. |
| 0x02000000 (25) | NO_DISPLAY. Användaren ska inte köra program oberoende av tilldelningen. |
| 0x04000000 (26) | ONSLOWNET. Uppgifter är obligatoriska över en långsam nätverksanslutning. |
| 0x10000000 (28) | TARGETTOWINPE. Rikta den här distributionen endast till WinPE. |
| 0x20000000 (29) | HIDDENINWINPE. Rikta den här distributionen endast till WinPE men dölj i WinPE. Den kan bara användas av TS-variabeln SMSTSPreferredAdvertID. |
Dessa flaggor måste samordnas med de flaggor som anges i ProgramFlags det annonserade programmets egenskap. Om du till exempel anger ONUSERLOGOFF måste flaggan NOUSERLOGGEDIN anges i programmet. Om flagginställningarna inte stämmer överens annonseras inte programmet. Mer information finns i SMS_Program WMI-klass för server.
Om du anger omedelbart, ONUSERLOGON eller ONUSERLOGOFF eller anger ett AssignedSchedule värde blir det annonserade programmet obligatoriskt. Ett obligatoriskt program körs automatiskt efter att kunden har tagit emot annonsen. Klienten kan inte avvisa eller skjuta upp installationen.
Ange endast bitarna NO_DISPLAY och ONSLOWNET när bitarna IMMEDIATE, ONUSERLOGON eller ONUSERLOGOFF har angetts eller programmet har ett AssignedSchedule värde.
Ange NO_DISPLAY när du inte vill att användaren ska köra program oberoende av tilldelningen. Om du inte anger den här flaggan visas annonsen i listan över annonser och kan köras oberoende av tilldelningen. Programmet kan fortfarande vara obligatoriskt.
Ställ in ONSLOWNET när tilldelningar krävs via en långsam nätverksanslutning, till exempel när en dator ansluter med ett modem.
AdvertisementID
Datatyp: String
Åtkomsttyp: Läsa/skriva
Kvalificerare: [key, ResID(801), ResDLL("SMS_RSTT.dll")]
Unik automatiskt genererad nyckel som identifierar annonsen. Standardvärdet är "".
AdvertisementName
Datatyp: String
Åtkomsttyp: Läsa/skriva
Kvalificerare: [Not_null]
Unikt användarvänligt namn för annonsen.
AssignedSchedule Datatyp: SMS_ScheduleToken Matris
Åtkomsttyp: Läsa/skriva
Kvalificerare: [max(15), lat]
SMS_ScheduleToken WMI-klassobjekt för server som anger den tid då annonseringen blir obligatorisk på klienterna.
AssignedScheduleEnabled
Datatyp: Boolean
Åtkomsttyp: Läsa/skriva
Kvalificerare: [lat]
true Om schemat som definieras i egenskapen AssignedSchedule är aktivt. Standardvärdet är false.
AssignedScheduleIsGMT
Datatyp: Boolean
Åtkomsttyp: Läsa/skriva
Kvalificerare: [lat]
true om schemat som definierats i egenskapen AssignedSchedule är i Universal Metric Time (UMT). Standardvärdet är false.
AssignmentID
Datatyp: UInt32
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
ID för tilldelningen som är associerad med annonsen.
CollectionID
Datatyp: String
Åtkomsttyp: Läsa/skriva
Kvalificerare: [Not_null]
Befintlig samling som annonsen är riktad till.
Comment
Datatyp: String
Åtkomsttyp: Läsa/skriva
Kvalificerare: Inga
Enkel beskrivning eller anteckning om annonsen. Standardvärdet är "".
DeviceFlags
Datatyp: UInt32
Åtkomsttyp: Läsa/skriva
Kvalificerare: Inga
Flaggor som beskriver enheten. Möjliga värden anges nedan. Standardvärdet är 0.
| Hexadecimal (bit) | Beskrivning |
|---|---|
| 0x01000000 (24) | Tilldela alltid klienten program. |
| 0x02000000 (25) | Tilldela endast om enheten för närvarande är ansluten till en anslutning med hög bandbredd (standard över 60 kbit/s). |
| 0x04000000 (26) | Tilldela endast om enheten är dockad, det vill säga att den är ansluten till ett skrivbord som använder ActiveSync. |
ExpirationTime
Datatyp: DateTime
Åtkomsttyp: Läsa/skriva
Kvalificerare: Inga
Datum och tid när annonsen inte längre är tillgänglig för klienter. Standardvärdet är 19900101000000.0000000+****.
ExpirationTimeEnabled
Datatyp: Boolean
Åtkomsttyp: Läsa/skriva
Kvalificerare: [lat]
true om annonsen löper ut vid den tidpunkt som anges av ExpirationTime fastigheten. Standardvärdet är false.
ExpirationTimeIsGMT
Datatyp: Boolean
Åtkomsttyp: Läsa/skriva
Kvalificerare: [lat]
true om tiden som definierats ExpirationTime i egenskapen är i UMT. Standardvärdet är false.
HierarchyPath
Datatyp: String
Åtkomsttyp: Läsa/skriva
Kvalificerare: Inga
Reserverad.
IncludeSubCollection
Datatyp: Boolean
Åtkomsttyp: Läsa/skriva
Kvalificerare: Inga
true (standard) om annonsen annonseras till delsamlingarna i den angivna samlingen.
ISVData
Datatyp: Uint8 Matris
Åtkomsttyp: Läsa/skriva
Kvalificerare: [stor, lat]
Information som gör att en enskild ISV kan lagra data som relaterar till en SMS_Program instans. Det finns inga begränsningar eller definierade format för dessa data. Det är dock viktigt att inte skriva över egenskapen efter att dess ISV-ägande har fastställts. Därför bör det anropande programmet läsa befintliga data i den här egenskapen först. Om data inte tillhör programmet bör de inte ändras. Alla ISV- eller programägare som använder den här egenskapen bör inkludera en identifierare i data så att ägarskap enkelt kan fastställas.
ISVDataSize
Datatyp: UInt32
Åtkomsttyp: Läsa/skriva
Kvalificerare: [lat]
Storleken på de data som representeras av egenskapen ISVData . Standardvärdet är 0.
ISVString
Datatyp: String
Åtkomsttyp: Läsa/skriva
Kvalificerare: inga
Sträng för partnerutökningsbarhet.
MandatoryCountdown
Datatyp: UInt32
Åtkomsttyp: Läsa/skriva
Kvalificerare: Inga
Varaktighet i minuter för att visa användarmeddelande för operativsystemdistribution obligatorisk schemanedräkning. Standardvärdet är 0.
OfferType
Datatyp: UInt32
Åtkomsttyp: Läsa/skriva
Kvalificerare: [uppräkning]
Annonstyp som anger att annonsen är riktad till användare.
| Värde | Beskrivning |
|---|---|
| 0 | Obligatoriskt |
| 2 | Tillgänglig |
PackageID
Datatyp: String
Åtkomsttyp: Läsa/skriva
Kvalificerare: [Not_null]
ID för ett befintligt paket som är associerat med annonsen. Värdet måste vara skrivet med versaler.
PresentTime
Datatyp: DateTime
Åtkomsttyp: Läsa/skriva
Kvalificerare: Inga
Datum och tid då annonsen görs tillgänglig för kunder. Standardvärdet är 19900101000000.0000000+****.
PresentTimeEnabled
Datatyp: Boolean
Åtkomsttyp: Läsa/skriva
Kvalificerare: [lat]
true(standard) om den aktuella tiden tillämpas av Configuration Manager.
PresentTimeIsGMT
Datatyp: Boolean
Åtkomsttyp: Läsa/skriva
Kvalificerare: [lat]
true om tiden som definierats PresentTime i egenskapen är i UMT. Standardvärdet är false.
Priority
Datatyp: UInt32
Åtkomsttyp: Läsa/skriva
Kvalificerare: [uppräkning]
Den prioritet som används vid replikering av annonseringen till underordnade webbplatser. Möjliga värden anges nedan. Standardvärdet är NORMAL (2).
| Värde | Beskrivning |
|---|---|
| 1 | HÖG |
| 2 | VANLIGT |
| 3 | LÅG |
ProgramName
Datatyp: String
Åtkomsttyp: Läsa/skriva
Kvalificerare: [Not_null]
Ett program i det angivna paketet (PackageID) som ska annonseras.
RemoteClientFlags
Datatyp: UInt32
Åtkomsttyp: Läsa/skriva
Kvalificerare: [bitar]
Flaggor som anger hur programmet ska köras när klienten ansluts antingen lokalt eller via fjärranslutning till en distributionsplats. Möjliga värden anges nedan. Standardvärdet är 48.
| Hexadecimal (bit) | Beskrivning |
|---|---|
| 0x00000001 (0) | BATTERY_POWER. Kör programmet genom att använda batteriström. Det här värdet används inte för närvarande. |
| 0x00000002 (1) | RUN_FROM_CD. Kör programmet från CD-skivan. Det här värdet används inte för närvarande. |
| 0x00000004 (2) | DOWNLOAD_FROM_CD. Hämta programmet från CD-skivan. Det här värdet används inte för närvarande. |
| 0x00000008 (3) | RUN_FROM_LOCAL_DISPPOINT. Kör programmet från den lokala distributionsplatsen. |
| 0x00000010 (4) | DOWNLOAD_FROM_LOCAL_DISPPOINT. Ladda ned programmet från den lokala distributionsplatsen. |
| 0x00000020 (5) | DONT_RUN_NO_LOCAL_DISPPOINT. Kör inte programmet om det inte finns någon lokal distributionsplats. |
| 0x00000040 (6) | DOWNLOAD_FROM_REMOTE_DISPPOINT. Ladda ned programmet från fjärrdistributionsplatsen. |
| 0x00000080 (7) | RUN_FROM_REMOTE_DISPPOINT. Kör programmet från fjärrdistributionsplatsen. |
| 0x00000100 (8) | DOWNLOAD_ON_DEMAND_FROM_LOCAL_DP. Ladda ned programmet på begäran från den lokala distributionsplatsen. Detta gäller endast för aktivitetssekvenser. |
| 0x00000200 (9) | DOWNLOAD_ON_DEMAND_FROM_REMOTE_DP. Ladda ned programmet på begäran från fjärrdistributionsplatsen. Detta gäller endast för aktivitetssekvenser. |
| x00000400 (10) | BALLOON_REMINDERS_REQUIRED. Påminnelser om pratbubblor krävs. |
| 0x00000800 (11) | RERUN_ALWAYS. Kör alltid programmet igen. |
| 0x00001000 (12) | RERUN_NEVER. Kör aldrig programmet igen. |
| 0x00002000 (13) | RERUN_IF_FAILED. Kör programmet igen om körningen tidigare misslyckades. |
| 0x00004000 (14) | RERUN_IF_SUCCEEDED. Kör programmet igen om körningen har lyckats. |
| 0x00008000 (15) | PERSIST_ON_WRITE_FILTER_DEVICES Den här informationen gäller System Center 2012 Configuration Manager SP1 eller senare och System Center 2012 R2 Configuration Manager eller senare. |
| 0x00020000 (17) | GÖR T_FALLBACK Den här informationen gäller System Center 2012 Configuration Manager SP1 eller senare och System Center 2012 R2 Configuration Manager eller senare. |
| 0x00040000 (18) | DP_ALLOW_METERED_NETWORK Den här informationen gäller System Center 2012 Configuration Manager SP1 eller senare och System Center 2012 R2 Configuration Manager eller senare. |
SourceSite
Datatyp: String
Åtkomsttyp: Skrivskyddad
Kval: [läsa]
Webbplatskod på tre bokstäver för webbplatsen där annonsen kommer ifrån.
TimeFlags
Datatyp: UInt32
Åtkomsttyp: Skrivskyddad
Kvalificerare: [läs, bitar]
Reserverad för internt bruk. Flaggor som duplicerar informationen i de tidsrelaterade egenskaperna. Möjliga värden anges nedan. Till exempel anges ENABLE_PRESENT när PresentTimeEnabled är lika med true.
| Hexadecimal (bit) | Beskrivning |
|---|---|
| 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 |
Anmärkningar
Klasskvalificerare för den här klassen är:
Säkrad
Mer information om både klasskvalificerarna och egenskapskvalificerarna som ingår i avsnittet Egenskaper finns i Configuration Manager klass- och egenskapskvalificerare.
Även om det inte finns några andra nyckelegenskaper kvalificeras egenskaperna
AdvertisementName,CollectionID,PackageID, ochProgramNamekvalificeras som NOT_NULL, och värden måste anges. Programmet kan inte uppdatera de här egenskaperna när en klassinstans har skapats. Om du vill ändra dessa värden måste programmet ta bort instansen och skapa en ny instans med rätt värden.
Krav
Körningskrav
Mer information finns i Körningskrav för Configuration Manager Server.
Utvecklingskrav
Mer information finns i Utvecklingskrav för Configuration Manager Server.