Een programma maken

In het volgende voorbeeld ziet u hoe u in Configuration Manager een programma maakt met behulp van de SMS_Program eigenschappen klasse en klasse.

Belangrijk

Een aangekondigd programma wordt niet uitgevoerd wanneer de onderhoudsvensters die zijn gedefinieerd op de clientcomputer worden ingesteld op een periode die korter is dan de instelling voor maximaal toegestane runtime van dat programma. Zie Scenario voor programma-uitvoering met onderhoudsvensters in de documentatie van Configuration Manager voor meer informatie.

Een programma maken

  1. Stel een verbinding in met de sms-provider.

  2. Maak het nieuwe programmaobject met behulp van de SMS_Program klasse.

  3. Vul de nieuwe programma-eigenschappen in.

    Tip

    Wanneer u een programma maakt voor een takenreeks of een virtueel toepassingspakket, moeten de SMS_Program eigenschappen worden ingesteld op specifieke waarden. In de volgende tabellen wordt beschreven waarop deze instellingen moeten worden geconfigureerd.

    Taakreeks

    Naam eigenschap Waarde onroerend goed
    ProgramName *

    Virtueel toepassingspakket

    Naam eigenschap Waarde onroerend goed
    Opdrachtregel PkgGUID={E742FFD6-D539-42CC-9827-73535FC81E06}:VersionGUID={19366289-8C55-44E2-A5EC-7B385EFB4C30}

    Opmerking: De GUID-waarden worden uit het XML-manifestbestand van de virtuele toepassing gehaald.
    ProgramName [Virtuele applicatie]
  4. Sla het nieuwe programma en de nieuwe eigenschappen op.

Voorbeeld

Met de volgende voorbeeldmethode maakt u een nieuw programma en vult u de eigenschappen ervan voor gebruik bij softwaredistributie.

Zie Codefragmenten van Configuration Manager aanroepen voor meer informatie over het aanroepen van de voorbeeldcode.


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;
    }
}

De voorbeeldmethode heeft de volgende parameters:

Parameter Type Beschrijving
connection

swebemServices
- Beheerd: WqlConnectionManager
- VBScript: SWbemServices
Een geldige verbinding met de sms-provider.
existingPackageID - Beheerd: String
- VBScript: String
De naam van het pakket dat aan het programma is gekoppeld.
newProgramName - Beheerd: String
- VBScript: String
De naam voor het nieuwe programma.
newProgramComment - Beheerd: String
- VBScript: String
Opmerking met een beschrijving van het programma in de Configuration Manager-console.
newProgramCommandLine - Beheerd: String
- VBScript: String
De opdrachtregel die wordt uitgevoerd wanneer het programma wordt gestart.
newMaxRunTime - Beheerd: Integer
- VBScript: Integer
De geschatte duur (in minuten) van de uitvoering van het programma op de clientcomputer. Deze parameter kan een maximumwaarde hebben van 720 minuten of 12 uur.

De code compileren

Het C#-voorbeeld vereist:

Naamruimten

Systeem

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

bijeenkomst

adminui.wqlqueryengine

microsoft.configurationmanagement.managementprovider

mscorlib

Robuust programmeren

Zie Info over fouten in Configuration Manager voor meer informatie over foutafhandeling.

Zie ook

Overzicht van softwaredistributie