Nastavení proměnné pořadí úkolů nasazení operačního systému

Článek
04/04/2023

V Configuration Manager vytvoříte proměnnou pořadí úkolů nasazení operačního systému vytvořením instance třídy SMS_TaskSequence_SetVariableAction a přidáním do pořadí úkolů. Můžete také vytvořit proměnné pořadí úkolů, když je pořadí úkolů spuštěné na klientovi. Další informace najdete v tématu Použití proměnných pořadí úkolů ve spuštěném Configuration Manager pořadí úkolů.

Proměnná pořadí úkolů je pár název/hodnota, ke kterému můžete přistupovat pomocí kroků pořadí úkolů. Můžete také vytvořit proměnné specifické pro počítač a kolekci. Další informace najdete v tématech Vytvoření proměnné kolekce v Configuration Manager a Vytvoření proměnné počítače v Configuration Manager.

Poznámka

Proměnné, které jsou nastaveny pomocí třídy SMS_TaskSequence_SetVariableAction přepisují proměnné, které jsou nastaveny jinde. Pokud například proměnná kolekce a SMS_TaskSequence_SetVariableAction mají stejný název, bude mít přednost hodnota proměnné SMS_TaskSequence_SetVariableAction.

Nastavení proměnné pořadí úkolů

Nastavte připojení k poskytovateli serveru SMS. Další informace najdete v tématu Základy poskytovatele serveru SMS.
Získejte pořadí úkolů, do které chcete přidat proměnnou pořadí úkolů. Další informace najdete v tématu Postup vytvoření pořadí úloh nasazení operačního systému.
Vytvořte instanci SMS_TaskSequence_SetVariableAction.
Nastavte vlastnosti VariableName a VariableValue pro proměnnou, kterou přidáváte.
Přidejte objekt SMS_TaskSequence_SetVariableAction do pořadí úkolů.

Příklad

Následující ukázková metoda nastaví název a hodnotu proměnné pořadí úkolů.

Informace o volání ukázkového kódu najdete v tématu Volání Configuration Manager fragmentů kódu.

Sub AddTaskSequenceVariable(connection, taskSequence, variableName, variableValue)     

    Dim variable  
    Dim steps  

    Set variable = connection.Get("SMS_TaskSequence_SetVariableAction").SpawnInstance_  

    variable.Name="MyTaskSequenceVariable"  
    variable.Description = "A task sequence variable"  
    variable.Enabled=True  
    variable.ContinueOnError=False  
    variable.VariableName=variableName  
    variable.VariableValue=variableValue  

    steps= Array(taskSequence.Steps)  

    ReDim steps (UBound (taskSequence.Steps)+1)    

    taskSequence.Steps(UBound(steps))=variable  

End Sub

public void AddTaskSequenceVariable(  
    WqlConnectionManager connection,   
    IResultObject taskSequence,   
    string variableName,   
    string variableValue)  
{  
    try  
    {  
        // Create the task sequence variable object.  
        IResultObject variable = connection.CreateEmbeddedObjectInstance("SMS_TaskSequence_SetVariableAction");  

        // Populate the properties.  
        variable["Name"].StringValue = "MyTaskSequenceVariable";  
        variable["ContinueOnError"].BooleanValue = false;  
        variable["Description"].StringValue = "A task sequence variable set with SMS_TaskSequence_SetVariableAction";  
        variable["Enabled"].BooleanValue = true;  
        variable["VariableName"].StringValue = variableName;  
        variable["VariableValue"].StringValue = variableValue;  

        // Add the step to the task sequence.  
        List<IResultObject> array = taskSequence.GetArrayItems("Steps");  

        array.Add(variable);  
        taskSequence.SetArrayItems("Steps", array);  
    }  
    catch (SmsException e)  
    {  
        Console.WriteLine("Failed to set task sequence variable: " + e.Message);  
        throw;  
    }  
}

Tato ukázková metoda má následující parametry:

Parametr	Typ	Popis
`connection`	-Spravované: `WqlConnectionManager` - VBScript: SWbemServices	– Platné připojení k poskytovateli serveru SMS.
`taskSequence`	-Spravované: `WqlConnectionManager` -Vbscript: `SWbemServices`	– Pořadí úkolů, do které se proměnná přidá.
`variableName`	-Spravované: `String` -Vbscript: `String`	Název proměnné.
`variableValue`	-Spravované: `String` -Vbscript: `String`	Hodnota proměnné.

Kompilace kódu

Tento příklad jazyka C# vyžaduje:

Obory názvů

Systému

System.collections.generic

System.text

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Sestavení

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Robustní programování

Další informace o zpracování chyb najdete v tématu Informace o chybách Configuration Manager.

Zabezpečení rozhraní .NET Framework

Další informace o zabezpečení Configuration Manager aplikací najdete v tématu Configuration Manager správa na základě rolí.

Viz taky

Přehled objektů Jak se připojit k poskytovateli serveru SMS v Configuration Manager pomocí spravovaného kódu
Připojení k poskytovateli serveru SMS v Configuration Manager pomocí rozhraní WMI
Přehled pořadí úkolů Použití proměnných pořadí úkolů ve spuštěném Configuration Manager pořadí úkolů
Čtení pořadí úkolů z balíčku pořadí úkolů

Sdílet prostřednictvím