SMS_Advertisement serverns WMI-klass
SMS_Advertisement WMI-klassen (Windows Management Instrumentation) är en SMS Provider-serverklass i Configuration Manager som representerar en annons som används för att tillkännage programpaket som är tillgängliga för att köras på klienter.
Följande syntax förenklas 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
I följande tabell visas metoderna i SMS_Advertisement klassen .
| Metod | Beskrivning |
|---|---|
| GetAdvertisements-metod i klass SMS_Advertisement | Hämtar annons-ID:t som är riktade till resursen. |
| GetNextID-metod i klass SMS_Advertisement | Hämtar det ID-nummer som ska användas för nästa annons som skapas. |
| RiskyDeploymentStatusMessage-metod i klass SMS_Advertisement | Skickar ett varningsstatusmeddelande om en användardistribution till en riskfylld samling. |
| SetNextID-metod i klass SMS_Advertisement | Anger det ID-nummer som ska användas för nästa annons som skapas. |
| SetSourceSite-metod i klass SMS_Advertisement | Anger källkoden för annonsen. |
| Unlock-metod i klass SMS_Advertisement | Anger källplatsen till den aktuella webbplatsen och låser upp annonsen. Varning: Den här metoden är inaktuell. |
Egenskaper
ActionInProgress
Datatyp: UInt32
Åtkomsttyp: Skrivskyddad
Kvalificerare: [read, enumeration]
Aktuell åtgärd som utförs på paketet av Configuration Manager. Möjliga värden är:
| Värde | Beskrivning |
|---|---|
| 0 | INGEN |
| 1 | UPPDATERING |
| 2 | Add |
AdvertFlags
Datatyp: UInt32
Åtkomsttyp: Läsa/skriva
Kvalificerare: [bitar]
Flaggor som anger hur annonsen ska tillkännages för användaren. Möjliga värden visas nedan. Standardvärdet är 0.
| Hexadecimalt (bit) | Beskrivning |
|---|---|
| 0x00000020 (5) | OMEDELBAR. Meddela annonsen till användaren omedelbart. |
| 0x00000100 (8) | ONSYSTEMSTARTUP. Meddela annonsen till användaren vid systemstart. |
| 0x00000200 (9) | ONUSERLOGON. Meddela annonsen till användaren vid inloggning. |
| 0x00000400 (10) | ONUSERLOGOFF. Meddela annonsen till användaren vid utloggning. |
| 0x00001000 (12) | OPTIONALPREDOWNLOAD. Om den valda arkitekturen och språket matchar klientens, laddas paketinnehållet ned i förväg |
| 0x00008000 (15) | WINDOWS_CE. Annonsen är för en enhetsklient. |
| 0x00010000 (16) | ENABLE_PEER_CACHING. Den här informationen gäller för 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 medier och PXE-tjänstplatsen (pre-boot execution environment). |
| 0x00080000 (19) | APTSINTRANETONLY. |
| 0x00100000 (20) | OVERRIDE_SERVICE_WINDOWS. Åsidosätt underhållsperioder när du meddelar annonsen till användaren. |
| 0x00200000 (21) | REBOOT_OUTSIDE_OF_SERVICE_WINDOWS. Starta om utanför underhållsperioderna. |
| 0x00400000 (22) | WAKE_ON_LAN_ENABLED. Meddela annonsen till användaren med Wake On LAN aktiverat. |
| 0x00800000 (23) | SHOW_PROGRESS. Meddela annonsen till användaren som visar aktivitetssekvensens förlopp. |
| 0x02000000 (25) | NO_DISPLAY. Användaren bör inte köra program oberoende av tilldelningen. |
| 0x04000000 (26) | ONSLOWNET. Tilldelningar är obligatoriska över en långsam nätverksanslutning. |
| 0x10000000 (28) | TARGETTOWINPE. Rikta endast den här distributionen mot WinPE. |
| 0x20000000 (29) | HIDDENINWINPE. Rikta den här distributionen till Endast WinPE men dölj i WinPE. Den kan endast användas av TS-variabeln SMSTSPreferredAdvertID. |
Dessa flaggor måste samordnas med de flaggor som anges i ProgramFlags egenskapen för det annonserade programmet. Om du till exempel anger ONUSERLOGOFF måste flaggan NOUSERLOGGEDIN i programmet anges. Om flagginställningarna inte matchar annonseras inte programmet. Mer information finns i SMS_Program serverns WMI-klass.
Om du anger IMMEDIATE, ONUSERLOGON eller ONUSERLOGOFF eller anger ett AssignedSchedule värde blir det annonserade programmet obligatoriskt. Ett obligatoriskt program körs automatiskt efter att klienten har tagit emot annonsen. Klienten kan inte avvisa eller skjuta upp installationen.
Ange endast NO_DISPLAY- och ONSLOWNET-bitarna när biten IMMEDIATE, ONUSERLOGON eller ONUSERLOGOFF har angetts eller om 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.
Ange ONSLOWNET när tilldelningar är obligatoriska för 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), lazy]
SMS_ScheduleToken WMI-klassobjekt som anger när annonsen blir obligatorisk för klienterna.
AssignedScheduleEnabled
Datatyp: Boolean
Åtkomsttyp: Läsa/skriva
Kvalificerare: [lazy]
true om schemat som definierats i egenskapen AssignedSchedule är aktivt. Standardvärdet är false.
AssignedScheduleIsGMT
Datatyp: Boolean
Åtkomsttyp: Läsa/skriva
Kvalificerare: [lazy]
true om schemat som definierats i AssignedSchedule egenskapen finns i UMT (Universal Metric Time). Standardvärdet är false.
AssignmentID
Datatyp: UInt32
Åtkomsttyp: Skrivskyddad
Kvalificerare: [read]
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: Ingen
Enkel beskrivning eller anteckning om annonsen. Standardvärdet är "".
DeviceFlags
Datatyp: UInt32
Åtkomsttyp: Läsa/skriva
Kvalificerare: Ingen
Flaggor som beskriver enheten. Möjliga värden visas nedan. Standardvärdet är 0.
| Hexadecimalt (bit) | Beskrivning |
|---|---|
| 0x01000000 (24) | Tilldela alltid programmet till klienten. |
| 0x02000000 (25) | Tilldela endast om enheten för närvarande är ansluten till en anslutning med hög bandbredd (standardvärdet är över 60 KBIT/s). |
| 0x04000000 (26) | Tilldela endast om enheten är dockad, d.v.s. den är ansluten till ett skrivbord som använder ActiveSync. |
ExpirationTime
Datatyp: DateTime
Åtkomsttyp: Läsa/skriva
Kvalificerare: Ingen
Datum och tid då annonsen inte längre är tillgänglig för klienter. Standardvärdet är 19900101000000.000000+*****.
ExpirationTimeEnabled
Datatyp: Boolean
Åtkomsttyp: Läsa/skriva
Kvalificerare: [lazy]
true om annonsen upphör att gälla vid den tidpunkt som anges av ExpirationTime egenskapen. Standardvärdet är false.
ExpirationTimeIsGMT
Datatyp: Boolean
Åtkomsttyp: Läsa/skriva
Kvalificerare: [lazy]
true om den tid som definieras i ExpirationTime egenskapen finns i UMT. Standardvärdet är false.
HierarchyPath
Datatyp: String
Åtkomsttyp: Läsa/skriva
Kvalificerare: Ingen
Reserverade.
IncludeSubCollection
Datatyp: Boolean
Åtkomsttyp: Läsa/skriva
Kvalificerare: Ingen
true (standard) om annonsen annonseras till undersamlingarna för 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 är relaterade 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 fastigheten efter att dess ISV-ägande har upprättats. 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 ägarskapet enkelt kan upprättas.
ISVDataSize
Datatyp: UInt32
Åtkomsttyp: Läsa/skriva
Kvalificerare: [lazy]
Storleken på de data som representeras av ISVData egenskapen. Standardvärdet är 0.
ISVString
Datatyp: String
Åtkomsttyp: Läsa/skriva
Kvalificerare: ingen
Sträng för utökningsbarhet för partner.
MandatoryCountdown
Datatyp: UInt32
Åtkomsttyp: Läsa/skriva
Kvalificerare: Ingen
Varaktighet, i minuter, för att visa operativsystemets distribution användarmeddelande obligatorisk schema nedräkning. Standardvärdet är 0.
OfferType
Datatyp: UInt32
Åtkomsttyp: Läsa/skriva
Kvalificerare: [uppräkning]
Annonstyp som anger att annonsen är riktad till användarna.
| 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 i versaler.
PresentTime
Datatyp: DateTime
Åtkomsttyp: Läsa/skriva
Kvalificerare: Ingen
Datum och tid då annonsen görs tillgänglig för klienter. Standardvärdet är 19900101000000.000000+*****.
PresentTimeEnabled
Datatyp: Boolean
Åtkomsttyp: Läsa/skriva
Kvalificerare: [lazy]
true(standard) om den aktuella tiden framtvingas av Configuration Manager.
PresentTimeIsGMT
Datatyp: Boolean
Åtkomsttyp: Läsa/skriva
Kvalificerare: [lazy]
true om den tid som definieras i PresentTime egenskapen finns i UMT. Standardvärdet är false.
Priority
Datatyp: UInt32
Åtkomsttyp: Läsa/skriva
Kvalificerare: [uppräkning]
Prioriteten som används för att replikera annonsen till underordnade webbplatser. Möjliga värden visas nedan. Standardvärdet är NORMAL (2).
| Värde | Beskrivning |
|---|---|
| 1 | HÖG |
| 2 | NORMAL |
| 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 visas nedan. Standardvärdet är 48.
| Hexadecimalt (bit) | Beskrivning |
|---|---|
| 0x00000001 (0) | BATTERY_POWER. Kör programmet med hjälp av batteridrift. Det här värdet används för närvarande inte. |
| 0x00000002 (1) | RUN_FROM_CD. Kör programmet från CD. Det här värdet används för närvarande inte. |
| 0x00000004 (2) | DOWNLOAD_FROM_CD. Ladda ned programmet från CD. Det här värdet används för närvarande inte. |
| 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. Ballongpåminnelser 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 tidigare lyckades. |
| 0x00008000 (15) | PERSIST_ON_WRITE_FILTER_DEVICES Den här informationen gäller för System Center 2012 Configuration Manager SP1 eller senare och System Center 2012 R2 Configuration Manager eller senare. |
| 0x00020000 (17) | T_FALLBACK Den här informationen gäller för 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 för System Center 2012 Configuration Manager SP1 eller senare och System Center 2012 R2 Configuration Manager eller senare. |
SourceSite
Datatyp: String
Åtkomsttyp: Skrivskyddad
Kvalificerare: [read]
Platskod med tre bokstäver för den plats där annonsen kommer.
TimeFlags
Datatyp: UInt32
Åtkomsttyp: Skrivskyddad
Kvalificerare: [läsa, bitar]
Reserverad för internt bruk. Flaggor som duplicerar informationen i de tidsrelaterade egenskaperna. Möjliga värden visas nedan. Till exempel anges ENABLE_PRESENT när PresentTimeEnabled är lika med true.
| Hexadecimalt (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 omfattar:
Säkrade
Mer information om både klasskvalificerare och egenskapskvalificerare som ingår i avsnittet Egenskaper finns i Configuration Manager klass- och egenskapskvalificerare.
Även om det inte finns några andra nyckelegenskaper måste egenskaperna
AdvertisementName,CollectionID,PackageIDochProgramNamekvalificeras som NOT_NULL och värden anges. Programmet kan inte uppdatera dessa egenskaper 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 Configuration Manager serverkörningskrav.
Utvecklingskrav
Mer information finns i Configuration Manager Server Development Requirements (Utvecklingskrav för Configuration Manager server).