Så här skapar du ett program

Artikel
04/04/2023

I följande exempel visas hur du skapar ett program i Configuration Manager med hjälp SMS_Program av klass- och klassegenskaperna.

Viktigt

Annonserade program kan inte köras när underhållsperioderna som har definierats på klientdatorn har angetts under en period som är mindre än programmets inställning för maximal tillåten körningstid. Mer information finns i Programkörningsscenario med underhållsperioder i dokumentationen för Configuration Manager.

Skapa ett program

Konfigurera en anslutning till SMS-providern.
Skapa det nya programobjektet med hjälp SMS_Program av klassen .

Fyll i de nya programegenskaperna.

Tips

När du skapar ett program för en aktivitetssekvens eller ett virtuellt programpaket måste de SMS_Program egenskaperna anges till specifika värden. Följande tabeller beskriver vad dessa inställningar ska konfigureras för.

Aktivitetssekvens

Egenskapsnamn	Egenskapsvärde
ProgramName	*

Virtuellt programpaket

Egenskapsnamn	Egenskapsvärde
Kommandorad	PkgGUID={E742FFD6-D539-42CC-9827-73535FC81E06}:VersionGUID={19366289-8C55-44E2-A5EC-7B385EFB4C30} Observera: GUID-värdena hämtas från det virtuella programmets XML-manifestfil.
ProgramName	[Virtuellt program]

Spara det nya programmet och egenskaperna.

Exempel

Följande exempelmetod skapar ett nytt program och fyller i dess egenskaper för användning i programvarudistribution.

Information om hur du anropar exempelkoden finns i Anropa Configuration Manager kodfragment.


Sub CreateProgram(connection, existingPackageID, newProgramName, newProgramComment, newProgramCommandLine, newMaxRunTime)  

    ' Create the new program object.    Dim newProgram  
    Set newProgram = connection.Get("SMS_Program").SpawnInstance_  

    ' Populate the program properties.  
    newProgram.PackageID = existingPackageID  
    newProgram.ProgramName = newProgramName  
    newProgram.Comment = newProgramComment  
    newProgram.CommandLine = newProgramCommandLine  
    newProgram.Duration = newMaxRunTime  

    ' Save the new program and properties.  
    newProgram.Put_  

    ' Output new program name.  
    wscript.echo "Created program: " & newProgramName  

End Sub

public void CreateProgram(WqlConnectionManager connection,   
                          string existingPackageID,   
                          string newProgramName,   
                          string newProgramComment,   
                          string newProgramCommandLine,  
                          int newMaxRunTime)  
{  
    try  
    {  
        // Create an instance of SMS_Program.  
        IResultObject newProgram = connection.CreateInstance("SMS_Program");  

        // Populate basic program values.  
        newProgram["PackageID"].StringValue = existingPackageID;  
        newProgram["ProgramName"].StringValue = newProgramName;  
        newProgram["Comment"].StringValue = newProgramComment;  
        newProgram["CommandLine"].StringValue = newProgramCommandLine;  
        newProgram["Duration"].IntegerValue = newMaxRunTime;  

        // Save the new program instance and values.  
        newProgram.Put();  

        Console.WriteLine("Created program: " + newProgramName);  
    }  
    catch (SmsException ex)  
    {  
        Console.WriteLine("Failed to create program. Error: " + ex.Message);  
        throw;  
    }  
}

Exempelmetoden har följande parametrar:

Parameter	Typ	Beskrivning
`connection` `swebemServices`	-Hanterade: `WqlConnectionManager` – VBScript: SWbemServices	En giltig anslutning till SMS-providern.
`existingPackageID`	-Hanterade: `String` -Vbscript: `String`	Namnet på paketet som är associerat med programmet.
`newProgramName`	-Hanterade: `String` -Vbscript: `String`	Namnet på det nya programmet.
`newProgramComment`	-Hanterade: `String` -Vbscript: `String`	Kommentar som beskriver programmet i Configuration Manager-konsolen.
`newProgramCommandLine`	-Hanterade: `String` -Vbscript: `String`	Kommandoraden som körs när programmet startas.
`newMaxRunTime`	-Hanterade: `Integer` -Vbscript: `Integer`	Den ungefärliga varaktigheten i minuter för programkörning på klientdatorn. Den här parametern kan ha ett maxvärde på 720 minuter eller 12 timmar.

Kompilera koden

C#-exemplet kräver:

Namnområden

System

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Församlingen

adminui.wqlqueryengine

microsoft.configurationmanagement.managementprovider

mscorlib

Robust programmering

Mer information om felhantering finns i Om Configuration Manager fel.

Se även

Översikt över programvarudistribution

Dela via