适用于: Configuration Manager(current branch)
Configuration Manager 的操作系统部署功能中的任务序列引擎使用许多变量来控制其行为。 使用这些变量:
- 设置步骤条件
- 针对特定步骤更改行为
- 在脚本中用于更复杂的操作
有关所有可用任务序列变量的参考,请参阅 任务序列变量。
变量类型
有几种类型的变量:
内置变量
内置变量提供有关运行任务序列的环境的信息。 它们的值在整个任务序列中可用。 通常,任务序列引擎会在运行任何步骤之前初始化内置变量。
例如,_SMSTSLogPath是一个环境变量,用于指定 Configuration Manager 组件写入日志文件的路径。 任何任务序列步骤都可以访问此环境变量。
任务序列在每个步骤之前都会评估一些变量。 例如, _SMSTSCurrentActionName 列出当前步骤的名称。
操作变量
任务序列操作变量指定单个任务序列步骤使用的配置设置。 默认情况下,该步骤在运行之前会初始化其设置。 这些设置仅在关联的任务序列步骤运行时可用。 任务序列在运行步骤之前将操作变量值添加到环境中。 在步骤运行后,它会从环境中删除该值。
例如,将 “运行命令行 ”步骤添加到任务序列。 此步骤包括“ 开始位置 ”属性。 任务序列存储此属性的默认值作为 WorkingDirectory 变量。 任务序列在运行“ 运行命令行 ”步骤之前初始化此值。 运行此步骤时,从值访问WorkingDirectory“开始位置”属性值。 步骤完成后,任务序列将从环境中删除变量的值 WorkingDirectory 。 如果任务序列包括另一个 “运行命令行 ”步骤,它将初始化一个新 WorkingDirectory 变量。 此时,任务序列会将变量设置为当前步骤的起始值。 有关详细信息,请参阅 WorkingDirectory。
运行步骤时存在操作变量的 默认 值。 如果设置 新 值,则该值可用于任务序列中的多个步骤。 如果替代默认值,新值将保留在环境中。 此新值将覆盖任务序列中其他步骤的默认值。 例如,将“ 设置任务序列变量” 步骤添加为任务序列的第一步。 此步骤将 WorkingDirectory 变量 C:\设置为 。 任务序列中的任何 “运行命令行 ”步骤都使用新的起始目录值。
某些任务序列步骤会将某些操作变量标记为 输出。 在任务序列的后面步骤中读取这些输出变量。
注意
并非所有任务序列步骤都有操作变量。 例如,尽管存在与“ 启用 BitLocker ”操作关联的变量,但没有与 “禁用 BitLocker ”操作关联的变量。
自定义变量
这些变量是 Configuration Manager 不会创建的任何变量。 初始化您自己的变量以用作条件、命令行或脚本。
指定新任务序列变量的名称时,请遵循以下准则:
任务序列变量名称可以包含字母、数字、下划线字符 (
_) 和连字符 (-) 。任务序列变量名称的最小长度为 1 个字符,最大长度为 256 个字符。
用户定义的变量必须以字母 (
A-Z或a-z) 开头。用户定义的变量名称不能以下划线字符开头。 只有只读任务序列变量前面有一个下划线字符。
任务序列变量名称不区分大小写。 例如,
OSDVAR和osdvar是相同的任务序列变量。任务序列变量名称不能以空格开头或结尾。 它们也不能具有嵌入式空格。 任务序列将忽略变量名称开头或结尾的任何空格。
可以创建的任务序列变量数没有设定限制。 但是,变量数受任务序列环境大小的限制。 任务序列环境的总大小限制为 8 KB。 有关详细信息,请参阅 减小任务序列策略的大小。
只读变量
某些变量的值无法更改,因为这些变量为只读。 通常,名称以下划线字符开头 (_) 。 任务序列将它们用于其操作。 只读变量在任务序列环境中可见。
这些变量在脚本或命令行中非常有用。 例如,运行命令行并将输出与其他日志文件一起通过管道输送到日志文件 _SMSTSLogPath 。
注意
只读任务序列变量可以按任务序列中的步骤读取,但无法设置它们。 例如,使用只读变量作为 “运行命令行 ”步骤的命令行的一部分。 不能使用 “设置任务序列变量 ”步骤设置只读变量。
数组变量
任务序列将一些变量存储为数组。 数组中的每个元素都表示单个对象的设置。 当设备有多个要配置的对象时,请使用这些变量。 以下任务序列步骤使用数组变量:
如何设置变量
对于自定义变量或非只读变量,可以使用多种方法来初始化和设置变量的值:
使用与创建变量相同的方法从环境中删除变量。 若要删除变量,请将变量值设置为空字符串。
可以组合方法将任务序列变量设置为同一序列的不同值。 例如,使用任务序列编辑器设置默认值,然后使用脚本设置自定义值。
如果使用不同的方法设置同一变量,则任务序列引擎使用以下顺序:
它首先计算集合变量。
设备特定的变量将替代集合上设置的相同变量。
在任务序列期间使用任何方法设置的变量优先于集合或设备变量。
任务序列变量值的一般限制
任务序列变量值不能超过 4,000 个字符。
不能更改只读任务序列变量。 只读变量的名称以下划线字符开头 (
_) 。任务序列变量值可以区分大小写,具体取决于值的用法。 在大多数情况下,任务序列变量值不区分大小写。 包含密码的变量区分大小写。
设置任务序列变量
使用任务序列中的此步骤将单个变量设置为单个值。
有关详细信息,请参阅 设置任务序列变量。
设置动态变量
在任务序列中使用此步骤设置一个或多个任务序列变量。 在此步骤中定义规则以确定要使用的变量和值。
有关详细信息,请参阅 设置动态变量。
运行 PowerShell 脚本
使用任务序列中的此步骤,使用 PowerShell 脚本设置任务序列变量。
可以从包中指定脚本名称,也可以直接在步骤中输入 PowerShell 脚本。 然后使用 输出 到任务序列变量的 步骤属性将脚本输出保存到自定义任务序列变量。
有关此步骤的详细信息,请参阅 运行 PowerShell 脚本。
注意
还可以使用 PowerShell 脚本通过 TSEnvironment 对象设置一个或多个变量。 有关详细信息,请参阅如何在 Configuration Manager SDK 的正在运行的任务序列中使用变量。
包含“运行 PowerShell 脚本”步骤的示例方案
你的环境的用户来自多个国家/地区,因此你想要查询操作系统语言,以设置为多个特定于语言 的应用操作系统 步骤的条件。
在“应用操作系统”步骤之前,将“运行 PowerShell”脚本的实例添加到任务序列。
使用选项 输入 PowerShell 脚本 来指定以下命令:
(Get-Culture).TwoLetterISOLanguageName有关 cmdlet 的详细信息,请参阅 Get-Culture。 有关双字母 ISO 语言名称的详细信息,请参阅 ISO 639-1 代码列表。
对于 输出到任务序列变量的选项,请指定
CurrentOSLanguage。
在英语映像的 “应用 OS ”步骤中,创建以下条件:
Task Sequence Variable CurrentOSLanguage equals "en"
提示
有关如何在步骤上创建条件的详细信息,请参阅 如何访问变量 - 步骤条件。
保存并部署任务序列。
当“ 运行 PowerShell 脚本 ”步骤在具有英语版本 Windows 的设备上运行时,该命令将返回值 en。 然后,它会将该值保存到自定义变量中。 在同一设备上运行英语映像的 “应用操作系统 ”步骤时,条件计算结果为 true。 如果有多个适用于不同语言的 “应用操作系统 ”步骤实例,则任务序列将动态运行与操作系统语言匹配的步骤。
集合和设备变量
可以为设备和集合定义自定义任务序列变量。 为设备定义的变量称为每设备任务序列变量。 为集合定义的变量称为每个集合任务序列变量。 如果发生冲突,则每个设备的变量优先于每个集合变量。 此行为意味着分配给特定设备的任务序列变量自动比分配给包含设备的集合的变量具有更高的优先级。
例如,设备 XYZ 是集合 ABC 的成员。 您将 MyVariable 分配给值为 1 的集合 ABC。 还将 MyVariable 分配给值为 2 的设备 XYZ。 分配给 XYZ 的变量的优先级高于分配给集合 ABC 的变量。 当具有此变量的任务序列在 XYZ 上运行时,MyVariable 的值为 2。
可以隐藏每个设备和每个集合变量,使其在 Configuration Manager 控制台中不可见。 使用选项不在 Configuration Manager 控制台中显示此值时,变量的值不会显示在控制台中。 任务序列日志文件 (smsts.log) 或任务序列调试程序也不会显示变量值。 运行时,任务序列仍可以使用该变量。 如果不想再隐藏这些变量,请先将其删除。 然后重新定义变量,而不选择隐藏变量的选项。
警告
如果在 “运行命令行 ”步骤的命令行中包含变量,则任务序列日志文件将显示包括变量值的完整命令行。 若要防止日志文件中出现潜在的敏感数据,请将任务序列变量 OSDDoNotLogCommand 设置为 TRUE。
可以在主站点或管理中心站点管理每设备变量。 Configuration Manager 不支持为设备分配超过 1,000 个变量。
重要
对任务序列使用每个集合变量时,请考虑以下行为:
对集合的更改始终在整个层次结构中复制。 对集合变量所做的任何更改不仅适用于当前网站的成员,而且适用于整个层次结构中集合的所有成员。
删除集合时,此操作还会删除为集合配置的任务序列变量。
为设备创建任务序列变量
在 Configuration Manager 控制台中,转到“资产和合规性”工作区,然后选择“设备”节点。
选择目标设备,然后选择 “属性”。
在 “属性” 对话框中,切换到 “变量 ”选项卡。
对于要创建的每个变量,请选择 “新建 ”图标。 指定任务序列变量的 名称 和 值 。 如果要隐藏变量,使其在 Configuration Manager 控制台中不可见,请选择“不在 Configuration Manager 控制台中显示此值”选项。
将所有变量添加到设备属性后,选择“ 确定”。
为集合创建任务序列变量
在 Configuration Manager 控制台中,转到“资产和合规性”工作区,然后选择“设备集合”节点。 选择目标集合,然后选择 “属性”。
在 “属性 ”对话框中,切换到 “集合变量 ”选项卡。
对于要创建的每个变量,请选择 “新建 ”图标。 指定任务序列变量的 名称 和 值 。 如果要隐藏变量,使其在 Configuration Manager 控制台中不可见,请选择“不在 Configuration Manager 控制台中显示此值”选项。
(可选)指定 Configuration Manager 在评估任务序列变量时要使用的优先级。
将所有变量添加到集合属性后,选择“ 确定”。
TSEnvironment COM 对象
若要从脚本中使用变量,请使用 TSEnvironment 对象。
有关详细信息,请参阅如何在 Configuration Manager SDK 的正在运行的任务序列中使用变量。
预启动命令
prestart 命令是在用户选择任务序列之前在 Windows PE 中运行的脚本或可执行文件。 prestart 命令可以查询变量或提示用户输入信息,然后将其保存在环境中。 使用 TSEnvironment COM 对象从 prestart 命令读取和写入变量。
有关详细信息,请参阅 任务序列媒体的预启动命令。
任务序列向导
在“任务序列向导”窗口中选择任务序列后,用于编辑任务序列变量的页面将包括“ 编辑” 按钮。 可以使用可访问的键盘快捷方式来编辑变量。 此更改有助于鼠标不可用的情况。
任务序列媒体向导
为从媒体运行的任务序列指定变量。 使用媒体部署操作系统时,请添加任务序列变量并在创建媒体时指定其值。 变量及其值存储在介质上。
注意
任务序列存储在独立媒体上。 但是,所有其他类型的媒体(如预留媒体)从管理点检索任务序列。
从媒体运行任务序列时,可以在向导的 “自定义 ”页上添加变量。
使用媒体变量代替每个集合或每台计算机的变量。 如果任务序列是从媒体运行,则不会应用每台计算机和每集合变量,并且不会使用。
提示
任务序列将包 ID 和预启动命令行写入运行 Configuration Manager 控制台的计算机上的CreateTSMedia.log文件。 此日志文件包括任何任务序列变量的值。 查看此日志文件以验证任务序列变量的值。
有关详细信息,请参阅 创建任务序列媒体。
如何访问变量
使用上一节中的某个方法指定变量及其值后,在任务序列中使用它。 例如,访问内置任务序列变量的默认值,或使步骤以变量的值为条件。
使用以下方法访问任务序列环境中的变量值:
在步骤中使用
为任务序列步骤中的设置指定变量值。 在任务序列编辑器中,编辑步骤,并将变量名称指定为字段值。 将变量名称用百分号括起来 (%) 。
例如,将变量名称用作“运行命令行”步骤的命令行字段的一部分。 以下命令行将计算机名称写入文本文件。
cmd.exe /c echo %_SMSTSMachineName% > C:\File.txt
步骤条件
使用内置或自定义任务序列变量作为步骤或组的条件的一部分。 任务序列在运行步骤或组之前评估变量值。
要添加评估变量值的条件,请执行以下步骤:
在任务序列编辑器中,选择要向其添加条件的步骤或组。
切换到步骤或组的 “选项 ”选项卡。 单击“ 添加条件”,然后选择“ 任务序列变量”。
在“ 任务序列变量 ”对话框中,指定以下设置:
变量:变量的名称。 例如,
_SMSTSInWinPE。条件:用于评估变量值的条件。 提供以下条件:
- Exists
- 不存在
- 等于
- 不等于
- 大于
- 大于或等于
- 小于
- 小于或等于
- Like (支持 和) 的
*?通配符 - 与 (版本 2103 或更高版本不同)
值:要检查的变量的值。 例如,
false。
上面的三个示例构成了一个常见条件,用于测试任务序列是否从 Windows PE 中的启动映像运行:
任务序列变量
_SMSTSInWinPE equals "false"
请参阅默认任务序列模板的“记录 Files和设置”组中的此条件,以安装现有的操作系统映像。
有关条件的详细信息,请参阅 任务序列编辑器 - 条件。
自定义脚本
在任务序列运行时使用 Microsoft.SMS.TSEnvironment COM 对象读取和写入变量。
以下Windows PowerShell示例查询 _SMSTSLogPath 变量以获取当前日志位置。 该脚本还设置自定义变量。
# Create an object to access the task sequence environment
$tsenv = New-Object -ComObject Microsoft.SMS.TSEnvironment
# Query the environment to get an existing variable
# Set a variable for the task sequence log path
$LogPath = $tsenv.Value("_SMSTSLogPath")
# Or, convert all of the variables currently in the environment to PowerShell variables
$tsenv.GetVariables() | % { Set-Variable -Name "$_" -Value "$($tsenv.Value($_))" }
# Write a message to a log file
Write-Output "Hello world!" | Out-File -FilePath "$LogPath\mylog.log" -Encoding "Default" -Append
# Set a custom variable "startTime" to the current time
$tsenv.Value("startTime") = (Get-Date -Format HH:mm:ss) + ".000+000"
Windows 安装程序答案文件
你提供的 Windows 安装程序应答文件可以嵌入任务序列变量。 使用形式 %varname%,其中 varname 是变量的名称。 “设置 Windows 和 ConfigMgr”步骤将变量名称字符串替换为实际变量值。 这些嵌入的任务序列变量不能用于 unattend.xml 答案文件中的纯数字字段。
有关详细信息,请参阅安装 Windows 和 ConfigMgr。