如何设置作系统部署任务序列变量

2025-06-06

在 Configuration Manager 中，通过创建 SMS_TaskSequence_SetVariableAction 类的实例并添加到任务序列来创建作系统部署任务序列变量。还可以在客户端上运行任务序列时创建任务序列变量。有关详细信息，请参阅如何在正在运行Configuration Manager任务序列中使用任务序列变量。

任务序列变量是可以通过任务序列步骤访问的名称/值对。还可以创建特定于计算机和集合的变量。有关详细信息，请参阅如何在 Configuration Manager 中创建集合变量和如何在 Configuration Manager 中创建计算机变量。

注意

使用 SMS_TaskSequence_SetVariableAction 类设置的变量将替代在其他位置设置的变量。例如，如果集合变量和SMS_TaskSequence_SetVariableAction具有相同的名称，则 SMS_TaskSequence_SetVariableAction 变量的值优先。

设置任务序列变量

设置与 SMS 提供程序的连接。有关详细信息，请参阅 SMS 提供程序基础知识。
获取要向其添加任务序列变量的任务序列。有关详细信息，请参阅如何创建作系统部署任务序列。
创建 SMS_TaskSequence_SetVariableAction 实例。
为要添加的变量设置 VariableName 和 VariableValue 属性。
将 SMS_TaskSequence_SetVariableAction 对象添加到任务序列。

示例

以下示例方法设置任务序列变量名称和值。

有关调用示例代码的信息，请参阅调用Configuration Manager代码片段。

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

此示例方法具有以下参数：

参数	类型	说明
`connection`	-管理： `WqlConnectionManager` - VBScript： SWbemServices	- 与 SMS 提供程序的有效连接。
`taskSequence`	-管理： `WqlConnectionManager` - VBScript： `SWbemServices`	- 将变量添加到的任务序列。
`variableName`	-管理： `String` - VBScript： `String`	变量的名称。
`variableValue`	-管理： `String` - VBScript： `String`	变量的值。

编译代码

此 C# 示例需要：

命名空间

System

System.Collections.Generic

System.Text

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

可靠编程

有关错误处理的详细信息，请参阅关于Configuration Manager错误。

.NET Framework 安全性

有关保护Configuration Manager应用程序的详细信息，请参阅Configuration Manager基于角色的管理。

另请参阅

对象概述如何使用托管代码连接到 Configuration Manager 中的 SMS 提供程序如何使用 WMI 任务序列在 Configuration Manager连接到 SMS 提供程序概述如何在正在运行Configuration Manager任务中使用任务序列变量序列如何从任务序列包读取任务序列

通过