WMI-klass för SMS_Program Server

WMI-klassen SMS_Program (Windows Management Instrumentation) är en SMS-providerserverklass i Configuration Manager som representerar ett program eller kommando som ska köras när programvara distribueras till en klientdator.

Följande syntax är förenklad från MOF-kod (Managed Object Format) och innehåller alla ärvda egenskaper.

Syntax

Class SMS_Program : SMS_BaseClass
{
     UInt32 ActionInProgress;
     String ApplicationHierarchy;
     String CommandLine;
     String Comment;
     String DependentProgram;
     String Description;
     UInt32 DeviceFlags;
     String DiskSpaceReq;
     String DriveLetter;
     UInt32 Duration;
     UInt8 ExtendedData[];
     UInt32 ExtendedDataSize;
     UInt8 Icon[];
     UInt32 IconSize;
     UInt8 ISVData[];
     UInt32 ISVDataSize;
     String ISVString;
     String MSIFilePath
     String MSIProductID
     String PackageID;
     String PackageName
     UInt32 PackageType
     String PackageVersion
     UInt32 ProgramFlags;
     String ProgramName;
     String RemovalKey;
     String Requirements;
     UInt32 SecuredTypeID
     SMS_OS_Details SupportedOperatingSystems[];
     UInt32   TransformReadiness=0;
     Datetime TransformAnalysisDate;
     String   TransformDtID;
     String WorkingDirectory;
};

Metoder

Klassen SMS_Program definierar inte några metoder.

Egenskaper

ActionInProgress Datatyp: UInt32

Åtkomsttyp: Skrivskyddad

Kvalificerare: [läs, uppräkning]

Den aktuella åtgärden som utförs på paketet som är associerat med programmet av Configuration Manager. Möjliga värden är:

Värde Beskrivning
0 INGEN
1 UPPDATERING
2 LÄGG TILL
3 TA BORT

Använd den här egenskapen i en WHERE-sats för att filtrera bort program som har markerats för borttagning men som ännu inte har tagits bort. Mer information finns i avsnittet Kommentarer senare i det här avsnittet.

ApplicationHierarchy Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: Inga

Programhierarkin för programmet. Standardvärdet är "".

CommandLine Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: Inga

Den kommandorad som körs när programmet startas. Standardvärdet är "".

Comment Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: Inga

Kommentar som beskriver programmet i konsolen Configuration Manager. Standardvärdet är "".

DependentProgram Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: Inga

En formaterad textsträng som definierar det program som bör köras innan det här programmet körs. Formatet definieras som <PackageID;>;<Programnamn>. Om programmet finns i samma paket kan det anropande programmet helt enkelt ange ;;<Programnamn>. Standardvärdet är "".

Beroendet upprätthålls bara den första gången programmet körs. När programmet har körts ignoreras beroendet. Du kan till exempel inte skapa ett återkommande schemalagt jobb som beroendet upprätthålls för varje programkörning.

Description Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: Inga

Används inte.

DeviceFlags Datatyp: UInt32

Åtkomsttyp: Läsa/skriva

Kvalificerare: Inga

Flaggor som beskriver enheten som är associerad med programmet. Möjliga värden är:

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.

DiskSpaceReq Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: Inga

Ungefärligt diskutrymme som programmet kräver. Formatet är "<storlek><KB|MB|GB".> Standardvärdet är "".

Den här informationen används i Configuration Manager-konsolen och annonseringen för att ge aviseringar om diskutrymmeskrav för programmet. Användaren kan sedan välja att acceptera annonseringen eller utföra en diskhanteringsuppgift först.

DriveLetter Datatyp: String

Åtkomsttyp: Läsa/skriva

Avgränsare: [SizeLimit("1"), Range("a-z")]

Enhetsbeteckning (ett tecken i intervallet a-z) som programmet mappar till och körs från. Standardvärdet är "".

Duration Datatyp: UInt32

Åtkomsttyp: Läsa/skriva

Kvalificerare: Inga

Den ungefärliga varaktigheten i minuter för programkörning på klientdatorn. Ange det här värdet som ett heltal större än eller lika med 0 (standard) eller som okänt (rekommenderas inte). Om egenskapen är inställd på Okänd anger Configuration Manager den maximala tillåtna körningstiden till 720 minuter (12 timmar). Mer information finns i avsnittet Kommentarer senare i det här avsnittet.

Obs!

På klientdatorer visas det angivna värdet för publicerade program i Run Advertised Programs kontrollpanelen.

ExtendedData Datatyp: UInt8 Matris

Åtkomsttyp: Läsa/skriva

Kvalificerare: [stor, lat]

XML-blob för avbildningsdistribution.

ExtendedDataSize Datatyp: UInt32

Åtkomsttyp: Läsa/skriva

Kvalificerare: [lat]

Den utökade datastorleken i byte. Standardvärdet är 0.

Icon Datatyp: UInt8 Matris

Åtkomsttyp: Läsa/skriva

Kvalificerare: [stor]

Ikoninformation associerad med programikonen, som visas i konsolen Configuration Manager.

IconSize Datatyp: UInt32

Åtkomsttyp: Läsa/skriva

Kvalificerare: [lat]

Programikonens storlek i byte. Ställ in den här egenskapen på 0 för att ta bort ikonen.

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 ett SMS_Program objekt.

Det finns inga begränsningar eller definierade format för ISV-data. Det är dock viktigt att inte skriva över egenskapen när ISV-ägarskapet har fastställts. Programmet bör läsa befintliga data i den här egenskapen först. Om data inte tillhör programmet bör de inte ändras. Du bör inkludera en identifierare i programmets data så att ägarskap enkelt kan fastställas.

ISVDataSize Datatyp: UInt32

Åtkomsttyp: Läsa/skriva

Kvalificerare: [lat]

Storleken, i byte, på de data som lagras i ISVData. Standardvärdet är 0.

ISVString Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: inga

Sträng för partnerutökningsbarhet.

MSIFilePath Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: Inga

Sökvägen till Windows Installer-paketet som programmet är associerat med. Standardvärdet är "".

MSIProductID Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: Inga

Produkt-ID för Windows Installer-paketet som programmet är associerat med. Standardvärdet är "".

PackageID Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: [tangent, Not_null]

ID för ett befintligt paket som programmet ska associeras med. Mer information finns i avsnittet Kommentarer senare i det här avsnittet.

PackageName Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: [Ingen]

Namnet på paketet som programmet tillhör.

PackageType Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: [Ingen]

Typen av paket som programmet tillhör.

Värde Beskrivning
0 Vanligt paket för programvarudistribution.
3 Drivrutinspaket.
4 Paket för aktivitetssekvens.
5 Paket med programvaruuppdatering.
6 Paket med enhetsinställningar.
257 Bild paketet.
258 Startavbildningspaket.
259 Installationspaket för operativsystem.

PackageVersion Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: [Ingen]

Den version av paketet som programmet tillhör.

ProgramFlags Datatyp: UInt32

Åtkomsttyp: Läsa/skriva

Kvalificerare: [bitar]

Flaggor som identifierar programmets installationsegenskaper. Möjliga värden anges nedan. Standardvärdena är EVERYUSER, USEUNCPATH, USERCONTEXT och UNATTENDED.

Obs!

När du använder SMS_Program programmässigt kontrollerar du att inga motstridiga värden är markerade. Till exempel ska NOUSERLOGGEDIN och USERCONTEXT inte användas tillsammans.

Möjliga värden är:

Hexadecimal (bit) Beskrivning
0x00000001 (0) AUTHORIZED_DYNAMIC_INSTALL. Programmet är godkänt för dynamisk installation.
0x00000002 (1) USECUSTOMPROGRESSMSG. Uppgiftssekvensen visar ett meddelande om användargränssnittet för anpassad förlopp.
0x00000010 (4) DEFAULT_PROGRAM. Det här är ett standardprogram
0x00000020 (5) DISABLEMOMALERTONRUNNING. Inaktiverar MOM-aviseringar medan programmet körs.
0x00000040 (6) MOMALERTONFAIL. Genererar MOM-avisering om programmet misslyckas.
0x00000080 (7) RUN_DEPENDANT_ALWAYS. Om inställningen är inställd ska programmets direkt beroende alltid köras.
0x00000100 (8) WINDOWS_CE. Anger ett enhetsprogram. Om inställningen är aktiverad erbjuds inte programmet för skrivbordsklienter.
0x00000200 (9) Det här värdet används inte.
0x00000400 (10) NEDRÄKNING. Dialogrutan för nedräkning visas inte.
0x00000800 (11) FORCERERUN. Det här värdet används inte.
0x00001000 (12) INAKTIVERAD. Programmet är inaktiverat.
0x00002000 (13) OBEVAKAD. Ingen användarinteraktion krävs för programmet.
0x00004000 (14) USERCONTEXT. Programmet kan endast köras när en användare är inloggad.
0x00008000 (15) ADMINISTRATÖRSRÄTTIGHETER. Programmet måste köras med lokalt administratörskonto.
0x00010000 (16) ALLA. Programmet måste köras av alla användare som det är giltigt för. Gäller endast för obligatoriska jobb.
0x00020000 (17) NOUSERLOGGEDIN. Programmet körs bara när ingen användare är inloggad.
0x00040000 (18) OKTOQUIT. Programmet startar om datorn.
0x00080000 (19) OKTOREBOOT. Configuration Manager startar om datorn när programmet har körts klart.
0x00100000 (20) USEUNCPATH. Använd en UNC-sökväg (ingen enhetsbeteckning) för att komma åt distributionsplatsen.
0x00200000 (21) PERSISTCONNECTION. Bevarar anslutningen till enheten som anges i egenskapen DriveLetter. Bitflaggan USEUNCPATH får inte vara inställd.
0x00400000 (22) RUNMINIMERED. Kör programmet som ett minimerat fönster.
0x00800000 (23) RUNMAXIMIZED. Kör programmet som ett maximerat fönster.
x01000000 (24) HIDEWINDOW. Dölj programfönstret.
0x02000000 (25) OKTOLOGOFF. Logga ut användare när programmet har slutförts.
0x04000000 (26) RUNACCOUNT. Det här värdet används inte.
0x08000000 (27) ANY_PLATFORM. Åsidosätt kontroll av plattformsstöd.
0x10000000 (28) STILL_RUNNING. Det här värdet används inte.
0x20000000 (29) SUPPORT_UNINSTALL. Kör avinstallationen från registernyckeln när annonseringen upphör att gälla.
0x40000000 (30) Plattformen stöds inte.
0x80000000 (31) SHOW_IN_ARP. Det här värdet används inte.

ProgramName Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: [tangent, Not_null]

Unikt namn som representerar programmet.

RemovalKey Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: Inga

Registernyckel som identifierar avinstallationsskriptet för programmet. Skriptet måste finnas i registersökvägen HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall . Standardvärdet är "".

Requirements Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: Inga

Beskrivning av eventuella extra krav i programmet. Standardvärdet är "".

SecuredTypeID Datatyp: UInt32

Åtkomsttyp: Läsa/skriva

Kvalificerare: [Ingen]

Skyddad typ av relaterat paket.

SupportedOperatingSystems Datatyp: SMS_OS_Details Matris

Åtkomsttyp: Läsa/skriva

Kvalificerare: [lat]

WMI-klassobjekt för SMS_OS_Details Server som representerar de operativsystem som programmet kan köras på.

Om du inte anger ANY_PLATFORM i egenskapen ProgramFlags måste du ange ett eller flera operativsystem som stöds. SMS_SupportedPlatforms Server WMI-klass definierar listan över plattformar som Configuration Manager stöder.

TransformAnalysisDate Datatyp: DateTime

Åtkomsttyp: Läsa/skriva

Kvalificerare: [Ingen]

Endast för internt bruk.

TransformDtID Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: [Ingen]

Endast för internt bruk.

TransformReadiness Datatyp: UInt32

Åtkomsttyp: Läsa/skriva

Kvalificerare: [Ingen]

Endast för internt bruk.

WorkingDirectory Datatyp: String

Åtkomsttyp: Läsa/skriva

Kvalificerare: Inga

Platsen där programmet körs. Standardvärdet är "".

Arbetskatalogen kan vara en absolut sökväg på klienten eller en sökväg i förhållande till den distributionsplatsmapp som innehåller paketet. Om ingen arbetskatalog anges använder Configuration Manager standarddistributionsplatsmappen.

Anmärkningar

Det finns inga speciella klasskval för denna klass. Mer information om både klasskvalificerarna och egenskapskvalificerarna som ingår i avsnittet Egenskaper finns i Configuration Manager klass- och egenskapskvalificerare.

Ett program är alltid associerat med ett överordnat paket och representerar vanligtvis installationsprogrammet för paketet. Flera program kan associeras med samma paket. Programmet använder egenskapen PackageID för att skapa den här associationen. Programmet kan inte ändra den här egenskapen när objektet SMS_Program har skapats. För att associera programmet med ett annat paket måste programmet ta bort objektet och skapa ett nytt objekt med ett nytt PackageID värde.

När ett program tar bort ett SMS_Program objekt tas det inte bort förrän dess relaterade komponenter, till exempel dess annonser, har tagits bort. I stället ställer Configuration Manager in egenskapen på ActionInProgress DELETE (3) för att markera programmet för borttagning. För att säkerställa att en fråga inte hämtar program som har markerats för borttagning lägger du till detta fall i WHERE-satsen.

Viktigt

Om du använder underhållsperioder för den samling där programmet körs kan en konflikt uppstå om värdet för Duration egenskapen är längre än den schemalagda underhållsperioden. Om den här egenskapen är angiven till Okänd startas programmet under underhållsperioden, men fortsätter att köras tills det slutförs eller slutar fungera när underhållsfönstret stängs.

Vi rekommenderar att du inte anger egenskapen Duration till Okänd eftersom den här egenskapen används i följande två viktiga syften:

  • För att övervaka resultaten av programmet.

  • Bestämmer om programmet ska startas när underhållsperioder har definierats på klientdatorerna.

    Om programmet anger Duration egenskapen men programmets körningstid överskrider den här varaktigheten slutar Configuration Manager att övervaka programmet men avslutar inte programmet. Detta gör att Configuration Manager kan fortsätta med andra funktioner för programvarudistribution, till exempel att köra andra annonserade program. Chefen gör inte:

  • Stoppa programmet.

  • Frigör alla enheter som har mappats för det annonserade programmet.

  • Frigör alla nätverksanslutningar som gjorts för det annonserade programmet.

  • Kostnadsfria operativsystemresurser som används av Configuration Manager när annonserade program körs.

    Mer information finns i Om underhållsfönster.

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.

Se även

SMS_Package Server WMI-klassSå här skapar du ett paketSå här skapar du ett program

  • Last updated on