Lesen einer Tasksequenz aus einem Tasksequenzpaket

Sie lesen eine Tasksequenz aus einem Tasksequenzpaket in Configuration Manager, indem Sie die SMS_TaskSequencePackage Klasse GetSequence-Methode aufrufen. GetSequence gibt ein SMS_TaskSequence-Objekt zurück, das Sie ändern und dann mithilfe der SetSequence-Methode wieder in das Paket einfügen können. Ein Beispiel für die Verwendung von SetSequence finden Sie unter Erstellen eines Tasksequenzpakets für die Betriebssystembereitstellung.

So lesen Sie eine Tasksequenz aus einem Tasksequenzpaket

1. Richten Sie eine Verbindung mit dem SMS-Anbieter ein. Weitere Informationen finden Sie unter Grundlagen des SMS-Anbieters.

2. Fragen Sie den SMS-Anbieter nach dem SMS_TaskSequencePackage ab, aus dem Sie die Sequenz laden möchten.

3. Rufen Sie die SMS_TaskSequencePackage-KlasseGetSequence-Methode auf, um das SMS_TaskSequence-Objekt abzurufen.

4. Nehmen Sie Änderungen an der Tasksequenz vor, und fügen Sie sie mithilfe von SetSequence wieder in das Paket ein.

Beispiel

Die folgende Beispielmethode gibt das Tasksequenzobjekt (SMS_TaskSequence) aus dem angegebenen Paket zurück.

Informationen zum Aufrufen des Beispielcodes finden Sie unter Aufrufen von Configuration Manager Codeausschnitten.

Function ReadTaskSequence(connection, taskSequencePackage)
    ' Get the parameters object.
    Set packageClass = connection.Get("SMS_TaskSequencePackage")

    Set objInParam = packageClass.Methods_("GetSequence"). _
        inParameters.SpawnInstance_()

    ' Add the input parameters.
     objInParam.Properties_.Item("TaskSequencePackage") =  taskSequencePackage

    ' Get the sequence.
     Set objOutParams = connection.ExecMethod("SMS_TaskSequencePackage", "GetSequence", objInParam)
     Set ReadTaskSequence = objOutParams.TaskSequence
End Function

public IResultObject ReadTaskSequence(
    WqlConnectionManager connection,
    IResultObject taskSequencePackage)
{
    IResultObject taskSequence = null;
    try
    {
        Dictionary<string, object> parameters = new Dictionary<string, object>();
        parameters.Add("TaskSequencePackage", taskSequencePackage);

        IResultObject outParams = connection.ExecuteMethod("SMS_TaskSequencePackage", "GetSequence", parameters);
        taskSequence = outParams.GetSingleItem("TaskSequence");

        return taskSequence;
    }
    catch (Exception e)
    {
        Console.WriteLine("failed to hydrate: " + e.Message);
        throw;
    }
}

Die Beispielmethode verfügt über die folgenden Parameter:

Parameter	Typ	Beschreibung
connection	-Gehandhabt: WqlConnectionManager – VBScript: SWbemServices	– Eine gültige Verbindung mit dem SMS-Anbieter.

Kompilieren des Codes

Für dieses C#-Beispiel ist Folgendes erforderlich:

Namespaces

System

System.Collections.Generic

System.Text

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Robuste Programmierung

Weitere Informationen zur Fehlerbehandlung finden Sie unter Informationen zu Configuration Manager Fehlern.

.NET Framework-Sicherheit

Weitere Informationen zum Schützen Configuration Manager Anwendungen finden Sie unter Configuration Manager rollenbasierte Verwaltung.

Siehe auch

ObjektübersichtHerstellen einer Verbindung mit einem SMS-Anbieter in Configuration Manager mithilfe von verwaltetem CodeHerstellen einer Verbindung mit einem SMS-Anbieter in Configuration Manager mithilfe von WMIHow to Create an Operating System Deployment Task Sequence PackageOverviewHow to Enumerate the Available Operating System Deployment Task Sequence Task Sequence Overview How to Enumerate the Available Operating System Deployment Task Task Sequenzen