任务序列变量

适用于: Configuration Manager(current branch)

本文是按字母顺序排列的所有可用变量的参考。 使用浏览器 Find 函数 (通常 按 CTRL + F) 查找特定变量。 变量会指出它是否特定于特定步骤。 有关 任务序列步骤 的文章包括特定于每个步骤的变量列表。

有关详细信息,请参阅 使用任务序列变量

任务序列变量引用

_OSDDetectedWinDir

当 Windows PE 启动时,任务序列会扫描计算机的硬盘驱动器,以查找以前的操作系统安装。 Windows 文件夹位置存储在此变量中。 可以将任务序列配置为从环境中检索此值,并使用它来指定用于新操作系统安装的同一 Windows 文件夹位置。

_OSDDetectedWinDrive

当 Windows PE 启动时,任务序列会扫描计算机的硬盘驱动器,以查找以前的操作系统安装。 安装操作系统的硬盘驱动器位置存储在此变量中。 可以将任务序列配置为从环境中检索此值,并使用它来指定用于新操作系统的相同硬盘驱动器位置。

_OSDMigrateUsmtPackageID

适用于 捕获用户状态 步骤。

(输入)

指定包含 USMT 文件的 Configuration Manager 包的包 ID。 此变量是必需的。

_OSDMigrateUsmtRestorePackageID

适用于 还原用户状态 步骤。

(输入)

指定包含 USMT 文件的 Configuration Manager 包的包 ID。 此变量是必需的。

_SMSTSAdvertID

存储当前正在运行的任务序列部署的唯一 ID。 它使用与 Configuration Manager 软件分发部署 ID 相同的格式。 如果任务序列从独立媒体运行,则此变量未定义。

示例

ABC20001

_SMSTSAppInstallNeedsRetry

启动此 Configuration Manager 2211 HFRU Kb 16643863 及更高版本

适用于 “安装应用程序” 步骤。

如果上一个应用程序安装失败,并且需要重试,则此值设置为 true。

否则,此值设置为 false。

_SMSTSAssetTag

适用于 “设置动态变量” 步骤。

指定计算机的资产标记。

_SMSTSBootImageID

如果当前运行的任务序列引用启动映像包,则此变量存储启动映像包 ID。 如果任务序列未引用启动映像包,则不会设置此变量。

示例

ABC00001

_SMSTSBootUEFI

任务序列在检测到处于 UEFI 模式的计算机时设置此变量。

_SMSTSClientCache

任务序列在本地驱动器上缓存内容时设置此变量。 变量包含缓存的路径。 如果此变量不存在,则没有缓存。

_SMSTSClientGUID

存储 Configuration Manager 客户端 GUID 的值。 如果任务序列从独立媒体运行,则不会设置此变量。

示例

0a1a9a4b-fc56-44f6-b7cd-c3f8ee37c04c

_SMSTSCurrentActionName

指定当前正在运行的任务序列步骤的名称。 在任务序列管理器运行每个单独的步骤之前设置此变量。

示例

run command line

_SMSTSDefaultGateways

适用于 “设置动态变量” 步骤。

指定计算机使用的默认网关。

_SMSTSDownloadOnDemand

如果当前任务序列在按需下载模式下运行,则此变量为 true。 按需下载模式意味着任务序列管理器仅在必须访问内容时才在本地下载内容。

_SMSTSInWinPE

当当前任务序列步骤在 Windows PE 中运行时,此变量为 true。 测试此任务序列变量以确定当前的 OS 环境。

_SMSTSIPAddresses

适用于 “设置动态变量” 步骤。

指定计算机使用的 IP 地址。

_SMSTSLastActionName

存储上次运行的操作的名称。 此变量与 _SMSTSLastActionRetCode相关。 任务序列将这些值记录到 smsts.log 文件中。 对任务序列进行故障排除时,此变量非常有用。 当步骤失败时,自定义脚本可以包含步骤名称以及返回代码。

_SMSTSLastActionRetCode

存储上次运行的操作的返回代码。 此变量可用作确定是否运行下一步的条件。

示例

0

_SMSTSLastActionSucceeded

  • 如果最后一个步骤成功,则此变量为 true

  • 如果最后一个步骤失败,则为 false

  • 如果任务序列跳过了最后一个操作,因为步骤被禁用或关联的条件计算结果为 false,则不会重置此变量。 它仍保留上一个操作的值。

_SMSTSLastContentDownloadLocation

此变量包含任务序列下载或尝试下载内容的最后一个位置。 检查此变量,而不是分析此内容位置的客户端日志。

_SMSTSLaunchMode

指定任务序列通过以下方法之一启动:

  • SMS:Configuration Manager 客户端,例如用户从软件中心启动它时
  • UFD:旧版 USB 媒体
  • UFD+FORMAT:较新的 USB 媒体
  • CD:可启动 CD
  • DVD:可启动的 DVD
  • PXE:使用 PXE 进行网络启动
  • HD:硬盘上的预留媒体

_SMSTSLogPath

存储日志目录的完整路径。 使用此值可以确定任务序列步骤记录其操作的位置。 当硬盘驱动器不可用时,不会设置此值。

_SMSTSMacAddresses

适用于 “设置动态变量” 步骤。

指定计算机使用的 MAC 地址。

_SMSTSMachineName

存储和指定计算机名称。 存储任务序列用于记录所有状态消息的计算机的名称。 若要更改新 OS 中的计算机名称,请使用 OSDComputerName 变量。

_SMSTSMake

适用于 “设置动态变量” 步骤。

指定计算机的构成。

_SMSTSMDataPath

指定 SMSTSLocalDataDrive 变量定义的路径。 此路径指定任务序列在运行时在目标计算机上存储临时缓存文件的位置。 如果在任务序列启动之前定义 SMSTSLocalDataDrive(例如通过设置集合变量),则 Configuration Manager 会在任务序列启动后定义_SMSTSMDataPath变量。

_SMSTSMediaType

指定用于启动安装的媒体类型,其中包括:

  • BootMedia:启动媒体
  • FullMedia:全媒体
  • PXE:PXE
  • OEMMedia:预留媒体

_SMSTSModel

适用于 “设置动态变量” 步骤。

指定计算机的模型。

_SMSTSMP

存储 Configuration Manager 管理点的 URL 或 IP 地址。

_SMSTSMPPort

存储 Configuration Manager 管理点的端口号。

_SMSTSOrgName

存储任务序列在进度对话框中显示的品牌标题名称。

_SMSTSOSUpgradeActionReturnCode

适用于 升级操作系统 步骤。

存储 Windows 安装程序返回以指示成功或失败的退出代码值。 此变量可用于 /Compat 命令行选项。

示例

完成仅兼容扫描后,请根据失败或成功退出代码在后续步骤中执行操作。 成功后,启动升级。 或者在环境中设置一个标记,以便通过硬件清单进行收集。 例如,添加文件或设置注册表项。 使用此标记可创建准备升级或升级前需要执行操作的计算机的集合。

_SMSTSPackageID

存储当前正在运行的任务序列 ID。 此 ID 使用与 Configuration Manager 包 ID 相同的格式。

示例

HJT00001

_SMSTSPackageName

存储当前正在运行的任务序列名称。 Configuration Manager 管理员在创建任务序列时指定此名称。

示例

Deploy Windows 10 task sequence

_SMSTSRunFromDP

true如果当前任务序列在分发点运行模式下运行,请将 设置为 。 此模式意味着任务序列管理器从分发点获取所需的包共享。

_SMSTSSerialNumber

适用于 “设置动态变量” 步骤。

指定计算机的序列号。

_SMSTSSetupRollback

指定 Windows 安装程序是否在就地升级期间执行回滚操作。 变量值可以是 truefalse

_SMSTSSiteCode

存储 Configuration Manager 站点的站点代码。

示例

ABC

_SMSTSTimezone

此变量以以下格式存储时区信息:

Bias,StandardBias,DaylightBias,StandardDate.wYear,wMonth,wDayOfWeek,wDay,wHour,wMinute,wSecond,wMilliseconds,DaylightDate.wYear,wMonth,wDayOfWeek,wDay,wHour,wMinute,wSecond,wMilliseconds,StandardName,DaylightName

示例

对于 时区东部时间 (美国和加拿大)

300,0,-60,0,11,0,1,2,0,0,0,0,3,0,2,2,0,0,0,Eastern Standard Time,Eastern Daylight Time

_SMSTSType

指定当前正在运行的任务序列的类型。 它可以具有下列值之一:

  • 1:泛型任务序列
  • 2:OS 部署任务序列

_SMSTSUseCRL

当任务序列使用 HTTPS 与管理点通信时,此变量指定是否使用证书吊销列表 (CRL) 。

_SMSTSUserStarted

指定用户是否启动了任务序列。 仅当任务序列从软件中心启动时,才会设置此变量。 例如,如果 _SMSTSLaunchMode 设置为 SMS

此变量可以具有以下值:

  • true:指定任务序列由用户从软件中心手动启动。

  • false:指定任务序列由 Configuration Manager 计划程序自动启动。

_SMSTSUseSSL

指定任务序列是否使用 SSL 与 Configuration Manager 管理点通信。 如果为 HTTPS 配置站点系统,则值将设置为 true

_SMSTSUUID

适用于 “设置动态变量” 步骤。

指定计算机的 UUID。

_SMSTSWTG

指定计算机是否作为 Windows To Go 设备运行。

_TS_CRMEMORY

适用于 检查就绪情况 步骤。

一个只读变量,用于指示 最小内存 (MB) 检查返回 true () 1 还是 false (0) 。 如果未启用检查,则此只读变量的值为空。

_TS_CRSPEED

适用于 检查就绪情况 步骤。

一个只读变量,用于指示 最小处理器速度 (MHz) 检查返回 true () 1 还是 false (0) 。 如果未启用检查,则此只读变量的值为空。

_TS_CRDISK

适用于 检查就绪情况 步骤。

一个只读变量,用于指示 最小可用磁盘空间 (MB) 检查返回 true (1) 还是 false (0) 。 如果未启用检查,则此只读变量的值为空。

_TS_CROSTYPE

适用于 检查就绪情况 步骤。

刷新的当前 OS 是检查返回 true () 1 还是 false (0) 的只读变量。 如果未启用检查,则此只读变量的值为空。

_TS_CRARCH

适用于 检查就绪情况 步骤。

一个只读变量,指示 当前 OS 的体系结构 检查是返回 true () 1 还是 false (0) 。 如果未启用检查,则此只读变量的值为空。

_TS_CRMINOSVER

适用于 检查就绪情况 步骤。

一个只读变量,指示 最低操作系统版本 检查是返回 true () 1 还是 false (0) 。 如果未启用检查,则此只读变量的值为空。

_TS_CRMAXOSVER

适用于 检查就绪情况 步骤。

一个只读变量,指示 最大 OS 版本 检查是返回 true () 1 还是 false (0) 。 如果未启用检查,则此只读变量的值为空。

_TS_CRCLIENTMINVER

适用于 检查就绪情况 步骤。

一个只读变量,指示 最低客户端版本 检查是返回 true () 1 还是 false (0) 。 如果未启用检查,则此只读变量的值为空。

_TS_CROSLANGUAGE

适用于 检查就绪情况 步骤。

一个只读变量,指示 当前 OS 检查的语言 是返回 true () 1 还是 false (0) 。 如果未启用检查,则此只读变量的值为空。

_TS_CRACPOWER

适用于 检查就绪情况 步骤。

一个只读变量,指示 交流电源插入 检查是返回 true () 1 还是 false (0) 。 如果未启用检查,则此只读变量的值为空。

_TS_CRNETWORK

适用于 检查就绪情况 步骤。

一个只读变量,指示 已连接的网络适配器 检查是返回 true () 1 还是 false (0) 。 如果未启用检查,则此只读变量的值为空。

_TS_CRUEFI

适用于 检查就绪情况 步骤。

计算机 是否处于 UEFI 模式 的只读变量,检查返回的 BIOS () 0 还是 UEFI (1) 。 如果未启用检查,则此只读变量的值为空。

_TS_CRWIRED

适用于 检查就绪情况 步骤。

对于 网络适配器是否不是无线 检查,只读变量返回 true () 1 或 false (0) 。 如果未启用检查,则此只读变量的值为空。

_TS_CRTPMACTIVATED

从版本 2111 开始

适用于 检查就绪情况 步骤。

一个只读变量,用于指示 TPM 2.0 或更高版本是否被激活 ,检查返回的非活动 (0) 或活动 (1) 。 如果未启用检查,则此只读变量的值为空。

_TS_CRTPMENABLED

从版本 2111 开始

适用于 检查就绪情况 步骤。

对于 是否启用 TPM 2.0 或更高版本 的只读变量,检查返回禁用 () 0 或启用 (1) 。 如果未启用检查,则此只读变量的值为空。

_TSAppInstallStatus

任务序列在“ 安装 应用程序”步骤期间使用应用程序的安装状态设置此变量。 它设置以下值之一:

  • 未定义:尚未运行“安装应用程序”步骤。

  • 错误:由于安装应用程序步骤中的错误,至少有一个应用程序失败。

  • 警告:安装应用程序步骤期间未发生错误。 一个或多个应用程序或所需的依赖项未安装,因为未满足要求。

  • 成功:在安装应用程序步骤期间未检测到错误或警告。

_TSSecureBoot

使用此变量可确定启用 UEFI 的设备上的安全启动状态。 变量可以具有以下值之一:

  • NA:关联的注册表值不存在,这意味着设备不支持安全启动。
  • Enabled:设备已启用安全启动。
  • Disabled:设备已禁用安全启动。

OSDAdapter

适用于 “应用网络设置” 步骤。

(输入)

此任务序列变量是 数组 变量。 数组中的每个元素表示计算机上单个网络适配器的设置。 通过将数组变量名称与从零开始的网络适配器索引和属性名称组合在一起,访问每个适配器的设置。

如果“应用网络设置”步骤配置了多个网络适配器,则会使用变量名称中的索引 1 定义第二个网络适配器的属性。 例如:OSDAdapter1EnableDHCP、OSDAdapter1IPAddressList 和 OSDAdapter1DNSDomain。

使用以下变量名称定义要配置的步骤 的第一个 网络适配器的属性:

OSDAdapter0EnableDHCP

此设置是必需的。 可能的值为 TrueFalse。 例如:

true:为适配器启用动态主机配置协议 (DHCP)

OSDAdapter0IPAddressList

适配器的 IP 地址的逗号分隔列表。 除非 EnableDHCP 设置为 false,否则忽略此属性。 此设置是必需的。

OSDAdapter0SubnetMask

以逗号分隔的子网掩码列表。 除非 EnableDHCP 设置为 false,否则忽略此属性。 此设置是必需的。

OSDAdapter0Gateways

以逗号分隔的 IP 网关地址列表。 除非 EnableDHCP 设置为 false,否则忽略此属性。 此设置是必需的。

OSDAdapter0DNSDomain

域名系统 (适配器的 DNS) 域。

OSDAdapter0DNSServerList

适配器的 DNS 服务器的逗号分隔列表。 此设置是必需的。

OSDAdapter0EnableDNSRegistration

设置为 以 true 在 DNS 中注册适配器的 IP 地址。

OSDAdapter0EnableFullDNSRegistration

设置为 以 true 在 DNS 中注册计算机的完整 DNS 名称下的适配器的 IP 地址。

OSDAdapter0EnableIPProtocolFiltering

设置为 以 true 在适配器上启用 IP 协议筛选。

OSDAdapter0IPProtocolFilterList

允许通过 IP 运行的协议的逗号分隔列表。 如果 EnableIPProtocolFiltering 设置为 false,则忽略此属性。

OSDAdapter0EnableTCPFiltering

设置为 以 true 启用适配器的 TCP 端口筛选。

OSDAdapter0TCPFilterPortList

要授予 TCP 访问权限的端口的逗号分隔列表。 如果 EnableTCPFiltering 设置为 false,则忽略此属性。

OSDAdapter0TcpipNetbiosOptions

基于 TCP/IP 的 NetBIOS 选项。 可能的值如下所示:

  • 0:从 DHCP 服务器使用 NetBIOS 设置
  • 1:通过 TCP/IP 启用 NetBIOS
  • 2:通过 TCP/IP 禁用 NetBIOS

OSDAdapter0MacAddress

用于将设置与物理网络适配器匹配的 MAC 地址。

OSDAdapter0Name

网络连接控制面板程序中出现的网络连接的名称。 名称长度介于 0 到 255 个字符之间。

OSDAdapter0Index

设置数组中网络适配器设置的索引。

示例

  • OSDAdapterCount = 1
  • OSDAdapter0EnableDHCP = FALSE
  • OSDAdapter0IPAddressList = 192.168.0.40
  • OSDAdapter0SubnetMask = 255.255.255.0
  • OSDAdapter0Gateways = 192.168.0.1
  • OSDAdapter0DNSSuffix = contoso.com

OSDAdapterCount

适用于 “应用网络设置” 步骤。

(输入)

指定目标计算机上安装的网络适配器数。 设置 OSDAdapterCount 值时,还要为每个适配器设置所有配置选项。

例如,如果为第一个适配器设置 OSDAdapter0TCPIPNetbiosOptions 值,则必须为该适配器配置所有值。

如果未指定此值,任务序列将忽略所有 OSDAdapter 值。

OSDAppInstallRetries

启动此 Configuration Manager 2211 HFRU Kb 16643863 及更高版本

适用于 “安装应用程序” 步骤。

(输入)

指定任务序列步骤在发生故障时尝试安装应用程序的次数。 必须指定 值,以在应用程序安装失败时触发重试。 仅当任务未选择“失败时安装下一个应用程序”选项时,才会尝试应用程序安装重试。

默认为 0,任务序列默认情况下不会重试应用程序安装。

OSDAppInstallRetryTimeout

启动此 Configuration Manager 2211 HFRU Kb 16643863 及更高版本

适用于 “安装应用程序” 步骤。

(输入)

指定任务序列在失败时重试应用程序安装之前应等待的时间(以毫秒为单位)。 该值默认为 30 秒 (30000 毫秒) 。 例如,为重试延迟 45 秒指定值 45000。

OSDApplyDriverBootCriticalContentUniqueID

适用于 “应用驱动程序包” 步骤。

(输入)

指定要从驱动程序包安装的大容量存储设备驱动程序的内容 ID。 如果未指定此变量,则不会安装任何大容量存储驱动程序。

OSDApplyDriverBootCriticalHardwareComponent

适用于 “应用驱动程序包” 步骤。

(输入)

指定是否安装了大容量存储设备驱动程序,此变量必须为 scsi

如果设置了 OSDApplyDriverBootCriticalContentUniqueID ,则需要此变量。

OSDApplyDriverBootCriticalID

适用于 “应用驱动程序包” 步骤。

(输入)

指定要安装的大容量存储设备驱动程序的启动关键 ID。 此 ID 在设备驱动程序的 txtsetup.oem 文件的 scsi 部分中列出。

如果设置了 OSDApplyDriverBootCriticalContentUniqueID ,则需要此变量。

OSDApplyDriverBootCriticalINFFile

适用于 “应用驱动程序包” 步骤。

(输入)

指定要安装的大容量存储驱动程序的 INF 文件。

如果设置了 OSDApplyDriverBootCriticalContentUniqueID ,则需要此变量。

OSDAutoApplyDriverBestMatch

适用于 “自动应用驱动程序” 步骤。

(输入)

如果驱动程序目录中有多个设备驱动程序与硬件设备兼容,则此变量将确定步骤的操作。

有效值

  • true (默认) :仅安装最佳设备驱动程序

  • false:安装所有兼容的设备驱动程序,Windows 选择要使用的最佳驱动程序

OSDAutoApplyDriverCategoryList

适用于 “自动应用驱动程序” 步骤。

(输入)

驱动程序目录类别唯一 ID 的逗号分隔列表。 “自动应用驱动程序”步骤仅考虑至少一个指定类别中的驱动程序。 此值是可选的,默认情况下不会设置此值。 通过枚举网站上 SMS_CategoryInstance 对象的列表来获取可用的类别 ID。

OSDBitLockerPIN

适用于 启用 BitLocker 步骤。

指定 BitLocker 加密的 PIN。 仅当 BitLocker 模式为 TPM 和 PIN 时,此变量才有效。

OSDBitLockerRebootCount

适用于 禁用 BitLocker 步骤。

使用此变量设置重启次数,之后要恢复保护。

有效值

1 到 的 15整数。

OSDBitLockerRebootCountOverride

适用于 禁用 BitLocker 步骤。

设置此值以替代步骤或 OSDBitLockerRebootCount 变量设置的计数。 虽然其他方法只接受值 1 到 15,但如果将此变量设置为 0,BitLocker 将无限期禁用。 当任务序列设置一个值,但你想要基于每个设备或每个集合设置单独的值时,此变量很有用。

有效值

0 到 的 15整数。

OSDBitLockerRecoveryPassword

适用于 启用 BitLocker 步骤。

(输入)

启用 BitLocker 步骤使用指定的值作为恢复密码,而不是生成随机恢复密码。 该值必须是有效的 BitLocker 恢复密码数字。

OSDBitLockerStartupKey

适用于 启用 BitLocker 步骤。

(输入)

“启用 BitLocker”步骤使用受信任的平台模块 (TPM) 作为启动密钥,而不是为仅 USB 上的密钥管理选项“启动密钥”生成随机启动密钥。 该值必须是有效的 256 位 Base64 编码 BitLocker 启动密钥。

OSDCaptureAccount

适用于 捕获 OS 映像 步骤。

(输入)

指定一个 Windows 帐户名称,该帐户名称有权将捕获的映像存储在网络共享 (OSDCaptureDestination) 。 另请指定 OSDCaptureAccountPassword

有关捕获 OS 映像帐户的详细信息,请参阅 帐户

OSDCaptureAccountPassword

适用于 捕获 OS 映像 步骤。

(输入)

指定 Windows 帐户 (OSDCaptureAccount) 的密码,用于将捕获的映像存储在网络共享 (OSDCaptureDestination) 。

OSDCaptureDestination

适用于 捕获 OS 映像 步骤。

(输入)

指定任务序列保存捕获的 OS 映像的位置。 最大目录名称长度为 255 个字符。 如果网络共享需要身份验证,请指定 OSDCaptureAccountOSDCaptureAccountPassword 变量。

OSDComputerName (输入)

适用于 “应用 Windows 设置” 步骤。

指定目标计算机的名称。

示例

%_SMSTSMachineName% (默认)

OSDComputerName (输出)

适用于 捕获 Windows 设置 步骤。

设置为计算机的 NetBIOS 名称。 仅当 OSDMigrateComputerName 变量设置为 时,才会设置 true值。

OSDConfigFileName

适用于 “应用 OS 映像” 步骤。

(输入)

指定与 OS 部署映像包关联的 OS 部署应答文件的文件名。

OSDDataImageIndex

适用于 “应用数据映像” 步骤。

(输入)

指定应用于目标计算机的图像的索引值。

OSDDiskIndex

适用于 格式化和分区磁盘 步骤。

(输入)

指定要分区的物理磁盘编号。

在版本 2010 及更早版本中,此数字不能大于 99。 在版本 2103 及更高版本中,最大数量为 10,000。 此更改有助于支持存储区域网络 (SAN) 方案。

OSDDNSDomain

适用于 “应用网络设置” 步骤。

(输入)

指定目标计算机使用的主 DNS 服务器。

OSDDNSSuffixSearchOrder

适用于 “应用网络设置” 步骤。

(输入)

指定目标计算机的 DNS 搜索顺序。

OSDDomainName

适用于 “应用网络设置” 步骤。

(输入)

指定目标计算机加入的 Active Directory 域的名称。 指定的值必须是有效的 Active Directory 域服务域名。

OSDDomainOUName

适用于 “应用网络设置” 步骤。

(输入)

指定目标计算机加入的组织单位 (OU) RFC 1779 格式名称。 如果指定,则该值必须包含完整路径。

示例

LDAP://OU=MyOu,DC=MyDom,DC=MyCompany,DC=com

OSDDoNotLogCommand

适用于 安装包运行命令行 步骤。

(输入)

若要防止显示或记录潜在的敏感数据,请将此变量设置为 TRUE。 此变量在安装包步骤期间屏蔽smsts.log中的程序名称。

将此变量设置为 TRUE时,它还会在日志文件的 “运行命令行” 步骤中隐藏命令行。

OSDEnableTCPIPFiltering

适用于 “应用网络设置” 步骤。

(输入)

指定是否启用 TCP/IP 筛选。

有效值

  • true
  • false (默认)

OSDGPTBootDisk

适用于 格式化和分区磁盘 步骤。

(输入)

指定是否在 GPT 硬盘上创建 EFI 分区。 基于 EFI 的计算机使用此分区作为启动磁盘。

有效值

  • true
  • false (默认)

OSDImageCreator

适用于 捕获 OS 映像 步骤。

(输入)

创建映像的用户的可选名称。 此名称存储在 WIM 文件中。 用户名的最大长度为 255 个字符。

OSDImageDescription

适用于 捕获 OS 映像 步骤。

(输入)

捕获的 OS 映像的可选用户定义说明。 此说明存储在 WIM 文件中。 说明的最大长度为 255 个字符。

OSDImageIndex

适用于 “应用 OS 映像” 步骤。

(输入)

指定应用于目标计算机的 WIM 文件的图像索引值。

OSDImageVersion

适用于 捕获 OS 映像 步骤。

(输入)

要分配给捕获的 OS 映像的可选用户定义版本号。 此版本号存储在 WIM 文件中。 此值可以是最大长度为 32 的字母数字字符的任意组合。

OSDInstallDriversAdditionalOptions

适用于 “应用驱动程序包” 步骤。

(输入)

指定在应用驱动程序包时要添加到 DISM 命令行的其他选项。 任务序列不验证命令行选项。

若要使用此变量,请在“应用驱动程序包”步骤中启用设置“通过运行 DISM 和递归”选项安装驱动程序包

有关详细信息,请参阅 DISM 命令行选项

OSDJoinAccount

适用于以下步骤:

(输入)

指定用于将目标计算机添加到域的域用户帐户。 加入域时需要此变量。

有关任务序列域加入帐户的详细信息,请参阅 帐户

OSDJoinDomainName

适用于 “加入域或工作组” 步骤。

(输入)

指定目标计算机加入的 Active Directory 域的名称。 域名的长度必须介于 1 到 255 个字符之间。

OSDJoinDomainOUName

适用于 “加入域或工作组” 步骤。

(输入)

指定目标计算机加入的组织单位 (OU) RFC 1779 格式名称。 如果指定,则该值必须包含完整路径。 OU 名称的长度必须介于 0 到 32,767 个字符之间。 如果将 OSDJoinType 变量设置为 1 (加入工作组) ,则不会设置此值。

示例

LDAP://OU=MyOu,DC=MyDom,DC=MyCompany,DC=com

OSDJoinPassword

适用于以下步骤:

(输入)

指定目标计算机用于加入 Active Directory 域的 OSDJoinAccount 的密码。 如果任务序列环境不包括此变量,则 Windows 安装程序将尝试使用空密码。 如果变量 OSDJoinType 变量设置为 0 (加入域) ,则此值是必需的。

OSDJoinSkipReboot

适用于 “加入域或工作组” 步骤。

(输入)

指定在目标计算机加入域或工作组后是否跳过重启。

有效值

  • true
  • false

OSDJoinType

适用于 “加入域或工作组” 步骤。

(输入)

指定目标计算机是加入 Windows 域还是工作组。

有效值

  • 0:将目标计算机加入 Windows 域
  • 1:将目标计算机加入工作组

OSDJoinWorkgroupName

适用于 “加入域或工作组” 步骤。

(输入)

指定目标计算机加入的工作组的名称。 工作组名称的长度必须介于 1 到 32 个字符之间。

OSDKeepActivation

适用于 准备用于捕获的 Windows 步骤。

(输入)

指定 sysprep 是保留还是重置产品激活标志。

有效值

  • true:保留激活标志
  • false (默认) :重置激活标志

OsdLayeredDriver

从版本 2107 开始

适用于 “应用 OS 映像” 步骤

为要与 Windows 一起安装的分层驱动程序指定整数值。 有关详细信息,请参阅 LayeredDriver Windows 设置。

OsdLayeredDriver 的有效值

键盘驱动程序
0 不要指定 (默认)
1 PC/AT 增强型键盘 (101/102 键)
2 韩国电脑/AT 101 键兼容键盘或Microsoft自然键盘 (键入 1)
3 韩国电脑/AT 101 键兼容键盘或Microsoft自然键盘 (键入 2)
4 韩国电脑/AT 101 键兼容键盘或Microsoft自然键盘 (键入 3)
5 韩语键盘 (103/106 键)
6 日语键盘 (106/109 键)

OSDLocalAdminPassword

适用于 “应用 Windows 设置” 步骤。

(输入)

指定本地管理员帐户密码。 如果启用 “随机生成本地管理员密码”选项并在所有受支持的平台上禁用帐户,则步骤将忽略此变量。 指定的值必须介于 1 到 255 个字符之间。

OSDLogPowerShellParameters

适用于 运行 PowerShell 脚本 步骤。

(输入)

为了防止记录潜在的敏感数据, 运行 PowerShell 脚本 步骤不会在 smsts.log 文件中记录脚本参数。 若要在任务序列日志中包含脚本参数,请将此变量设置为 TRUE

OSDMigrateAdapterSettings

适用于 捕获网络设置 步骤。

(输入)

指定任务序列是否捕获网络适配器信息。 此信息包括 TCP/IP 和 DNS 的配置设置。

有效值

  • true (默认)
  • false

OSDMigrateAdditionalCaptureOptions

适用于 捕获用户状态 步骤。

(输入)

为任务序列用于捕获用户状态的用户状态迁移工具 (USMT) 指定其他命令行选项。 此步骤不会在任务序列编辑器中公开这些设置。 将这些选项指定为字符串,任务序列会将该字符串追加到 ScanState 自动生成的 USMT 命令行。

运行任务序列之前,不会验证使用此任务序列变量指定的 USMT 选项的准确性。

有关可用选项的详细信息,请参阅 ScanState 语法

OSDMigrateAdditionalRestoreOptions

适用于 还原用户状态 步骤。

(输入)

为用户状态迁移工具指定其他命令行选项, (USMT) 任务序列在还原用户状态时使用。 将附加选项指定为字符串,任务序列将其追加到 LoadState 自动生成的 USMT 命令行。

运行任务序列之前,不会验证使用此任务序列变量指定的 USMT 选项的准确性。

有关可用选项的详细信息,请参阅 LoadState 语法

OSDMigrateComputerName

适用于 捕获 Windows 设置 步骤。

(输入)

指定是否迁移计算机名称。

有效值

OSDMigrateConfigFiles

适用于 捕获用户状态 步骤。

(输入)

指定用于控制用户配置文件捕获的配置文件。 仅当 OSDMigrateMode 设置为 Advanced时,才会使用此变量。 此逗号分隔的列表值设置为执行自定义用户配置文件迁移。

示例

miguser.xml,migsys.xml,migapps.xml

OSDMigrateContinueOnLockedFiles

适用于 捕获用户状态 步骤。

(输入)

如果 USMT 无法捕获某些文件,则此变量允许用户继续执行状态捕获。

有效值

  • true (默认)
  • false

OSDMigrateContinueOnRestore

适用于 还原用户状态 步骤。

(输入)

继续该过程,即使 USMT 无法还原某些文件。

有效值

  • true (默认)
  • false

OSDMigrateEnableVerboseLogging

适用于以下步骤:

(输入)

为 USMT 启用详细日志记录。 此步骤需要此值。

有效值

  • true
  • false (默认)

OSDMigrateLocalAccounts

适用于 还原用户状态 步骤。

(输入)

指定是否还原本地计算机帐户。

有效值

  • true
  • false (默认)

OSDMigrateLocalAccountPassword

适用于 还原用户状态 步骤。

(输入)

如果 OSDMigrateLocalAccounts 变量为 true,则此变量必须包含分配给 所有 已迁移本地帐户的密码。 USMT 会将相同的密码分配给所有已迁移的本地帐户。 将此密码视为临时密码,稍后再通过一些其他方法进行更改。

OSDMigrateMode

适用于 捕获用户状态 步骤。

(输入)

允许自定义 USMT 捕获的文件。

有效值

  • Simple:任务序列仅使用标准 USMT 配置文件

  • Advanced:任务序列变量 OSDMigrateConfigFiles 指定 USMT 使用的配置文件

OSDMigrateNetworkMembership

适用于 捕获网络设置 步骤。

(输入)

指定任务序列是迁移工作组还是域成员身份信息。

有效值

  • true (默认)
  • false

OSDMigrateRegistrationInfo

适用于 捕获 Windows 设置 步骤。

(输入)

指定步骤是否迁移用户和组织信息。

有效值

OSDMigrateSkipEncryptedFiles

适用于 捕获用户状态 步骤。

(输入)

指定是否捕获加密文件。

有效值

  • true
  • false (默认)

OSDMigrateTimeZone

适用于 捕获 Windows 设置 步骤。

(输入)

指定是否迁移计算机时区。

有效值

OSDNetworkJoinType

适用于 “应用网络设置” 步骤。

(输入)

指定目标计算机是加入 Active Directory 域还是工作组。

  • 0:加入 Active Directory 域
  • 1:加入工作组

OSDPartitions

适用于 格式化和分区磁盘 步骤。

(输入)

此任务序列变量是分区设置的数组变量。 数组中的每个元素都表示硬盘上单个分区的设置。 通过将数组变量名称与从零开始的磁盘分区号和属性名称相结合,访问为每个分区定义的设置。

使用以下变量名称定义此步骤在硬盘上创建 的第一个 分区的属性:

OSDPartitions0Type

指定分区的类型。 此属性是必需项。 有效值为 PrimaryExtendedLogicalHidden

OSDPartitions0FileSystem

指定格式化分区时要使用的文件系统类型。 此属性可选。 如果未指定文件系统,则步骤不会设置分区的格式。 有效值为 FAT32NTFS

OSDPartitions0Bootable

指定分区是否可启动。 此属性是必需项。 如果 MBR 磁盘的此值设置为 TRUE ,则步骤会将此分区标记为活动。

OSDPartitions0QuickFormat

指定所使用的格式类型。 此属性是必需项。 如果此值设置为 TRUE,则步骤将执行快速格式。 否则,该步骤将执行完整格式。

OSDPartitions0VolumeName

指定格式化卷时分配给卷的名称。 此属性可选。

OSDPartitions0Size

指定分区的大小。 此属性可选。 如果未指定此属性,则会使用所有剩余可用空间创建分区。 单位由 OSDPartitions0SizeUnits 变量指定。

OSDPartitions0SizeUnits

该步骤使用这些单元来解释 OSDPartitions0Size 变量。 此属性可选。 有效值 (MB 默认) GB、 和 Percent

OSDPartitions0VolumeLetterVariable

此步骤创建分区时,它始终使用 Windows PE 中的下一个可用驱动器号。 使用此可选属性可以指定另一个任务序列变量的名称。 该步骤使用此变量保存新的驱动器号以供将来参考。

如果使用此任务序列步骤定义多个分区,则会使用变量名称中的 1 索引定义第二个分区的属性。 例如: OSDPartitions1TypeOSDPartitions1FileSystemOSDPartitions1BootableOSDPartitions1QuickFormatOSDPartitions1VolumeName

OSDPartitionStyle

适用于 格式化和分区磁盘 步骤。

(输入)

指定对磁盘进行分区时要使用的分区样式。

有效值

  • GPT:使用 GUID 分区表样式
  • MBR:使用主启动记录分区样式

OSDProductKey

适用于 “应用 Windows 设置” 步骤。

(输入)

指定 Windows 产品密钥。 指定的值必须介于 1 到 255 个字符之间。

OSDRandomAdminPassword

适用于 “应用 Windows 设置” 步骤。

(输入)

为新 OS 中的本地管理员帐户指定随机生成的密码。

有效值

  • true (默认) :Windows 安装程序禁用目标计算机上的本地管理员帐户

  • false:Windows 安装程序在目标计算机上启用本地管理员帐户,并将帐户密码设置为 OSDLocalAdminPassword 的值

OSDRecoveryKeyPollingFrequency

适用于 启用 BitLocker 步骤。

适用于版本 2203 及更高版本。

BitLocker 操作轮询站点数据库恢复密钥托管状态的频率(以秒为单位)。 最小值为 15 秒。 默认值为 300 秒 (5 分钟) 。

OSDRecoveryKeyPollingTimeout

适用于 启用 BitLocker 步骤。

适用于版本 2203 及更高版本。

BitLocker 操作等待恢复密钥托管到站点数据库的最大秒数。 最小值为 30 秒。 默认值为 1800 秒 (30 分钟) 。

OSDRegisteredOrgName (输入)

适用于 “应用 Windows 设置” 步骤。

指定新 OS 中默认注册的组织名称。 指定的值必须介于 1 到 255 个字符之间。

OSDRegisteredOrgName (输出)

适用于 捕获 Windows 设置 步骤。

设置为计算机的已注册组织名称。 仅当 OSDMigrateRegistrationInfo 变量设置为 时,才会设置 true值。

OSDRegisteredUserName

适用于 “应用 Windows 设置” 步骤。

(输入)

指定新 OS 中默认注册的用户名。 指定的值必须介于 1 到 255 个字符之间。

OSDServerLicenseConnectionLimit

适用于 “应用 Windows 设置” 步骤。

(输入)

指定允许的最大连接数。 指定的数字必须介于 5 到 9999 连接之间。

OSDServerLicenseMode

适用于 “应用 Windows 设置” 步骤。

(输入)

指定使用的 Windows Server 许可证模式。

有效值

  • PerSeat
  • PerServer

OSDSetupAdditionalUpgradeOptions

适用于 升级操作系统 步骤。

(输入)

指定在升级期间添加到 Windows 安装程序的其他命令行选项。 任务序列不验证命令行选项。

有关详细信息,请参阅 Windows 安装程序 Command-Line 选项

OSDStateFallbackToNAA

适用于 “请求状态存储” 步骤。

(输入)

当计算机帐户无法连接到状态迁移点时,此变量指定任务序列是否回退以使用网络访问帐户 (NAA) 。

有关网络访问帐户的详细信息,请参阅 帐户

有效值

  • true
  • false (默认)

OSDStateSMPRetryCount

适用于 “请求状态存储” 步骤。

(输入)

指定任务序列步骤在步骤失败之前尝试查找状态迁移点的次数。 指定的计数必须介于 0 和 600 之间。

OSDStateSMPRetryTime

适用于 “请求状态存储” 步骤。

(输入)

指定任务序列步骤在重试尝试之间等待的秒数。 秒数最多可以有 30 个字符。

OSDStateStorePath

适用于以下步骤:

(输入)

任务序列保存或还原用户状态的文件夹的网络共享或本地路径名称。 没有默认值。

OSDTargetSystemDrive

适用于 “应用 OS 映像” 步骤。

(输出)

指定应用映像后包含 OS 文件的分区的驱动器号。

OSDTargetSystemRoot (输入)

适用于 捕获 OS 映像 步骤。

指定引用计算机上已安装 OS 的 Windows 目录的路径。 任务序列将其验证为受支持的 OS,供 Configuration Manager 捕获。

OSDTargetSystemRoot (输出)

适用于 准备用于捕获的 Windows 步骤。

指定引用计算机上已安装 OS 的 Windows 目录的路径。 任务序列将其验证为受支持的 OS,供 Configuration Manager 捕获。

OSDTimeZone (输入)

适用于 “应用 Windows 设置” 步骤。

指定新 OS 中使用的默认时区设置。

将此变量的值设置为时区的语言固定名称。 例如,在以下注册表项下的时区值中使用字符串 StdHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones

OSDTimeZone (输出)

适用于 捕获 Windows 设置 步骤。

设置为计算机的时区。 仅当 OSDMigrateTimeZone 变量设置为 时,才会设置 true该值。

OSDWindowsSettingsInputLocale

适用于 “应用 Windows 设置” 步骤。

指定新 OS 中使用的默认输入区域设置。

有关 Windows 安装程序应答文件值的详细信息,请参阅 Microsoft-Windows-International-Core - InputLocale

OSDWindowsSettingsSystemLocale

适用于 “应用 Windows 设置” 步骤。

指定新 OS 中使用的默认系统区域设置。

有关 Windows 安装程序应答文件值的详细信息,请参阅 Microsoft-Windows-International-Core - SystemLocale

OSDWindowsSettingsUILanguage

适用于 “应用 Windows 设置” 步骤。

指定新 OS 中使用的默认用户界面语言设置。

有关 Windows 安装程序应答文件值的详细信息,请参阅 Microsoft-Windows-International-Core - UILanguage

OSDWindowsSettingsUILanguageFallback

适用于 “应用 Windows 设置” 步骤。

指定在新 OS 中使用的回退用户界面语言设置。

有关 Windows 安装程序应答文件值的详细信息,请参阅 Microsoft-Windows-International-Core - UILanguageFallback

OSDWindowsSettingsUserLocale

适用于 “应用 Windows 设置” 步骤。

指定新 OS 中使用的默认用户区域设置。

有关 Windows 安装程序应答文件值的详细信息,请参阅 Microsoft-Windows-International-Core - UserLocale

OSDWipeDestinationPartition

适用于 “应用数据映像” 步骤。

(输入)

指定是否删除位于目标分区上的文件。

有效值

  • true (默认)
  • false

OSDWorkgroupName

适用于 “应用网络设置” 步骤。

(输入)

指定目标计算机加入的工作组的名称。

指定此变量或 OSDDomainName 变量。 工作组名称最多可包含 32 个字符。

SetupCompletePause

适用于 升级操作系统 步骤。

当 Windows 设置完成后,使用此变量解决高性能设备上窗口 10 就地升级任务序列的计时问题。 向此变量赋值(以秒为单位)时,Windows 安装程序进程会在启动任务序列之前延迟该时间量。 此超时为 Configuration Manager 客户端提供了额外的初始化时间。

以下日志条目是此问题的常见示例,可使用此变量进行修正:

  • TSManager 组件记录与 smsts.log中的以下错误类似的条目:

    Failed to initate policy evaluation for namespace 'root\ccm\policy\machine', hr=0x80041010
    Error compiling client config policies. code 80041010
    Task Sequence Manager could not initialize Task Sequence Environment. code 80041010
    
  • Windows 安装程序记录与 setupcomplete.log中的以下错误类似的条目:

    Running C:\windows\CCM\\TSMBootstrap.exe to resume task sequence
    ERRORLEVEL = -1073741701
    TSMBootstrap did not request reboot, resetting registry
    Exiting setupcomplete.cmd
    

SMSClientInstallProperties

适用于 安装 Windows 和 ConfigMgr 步骤。

(输入)

指定任务序列在安装 Configuration Manager 客户端时使用的客户端安装属性。

有关详细信息,请参阅 关于客户端安装参数和属性

SMSConnectNetworkFolderAccount

适用于 “连接到网络文件夹” 步骤。

(输入)

指定用于连接到 SMSConnectNetworkFolderPath 中的网络共享的用户帐户。 使用 SMSConnectNetworkFolderPassword 值指定帐户密码。

有关任务序列网络文件夹连接帐户的详细信息,请参阅 帐户

SMSConnectNetworkFolderDriveLetter

适用于 “连接到网络文件夹” 步骤。

(输入)

指定要连接到的网络驱动器号。 该值是可选的。 如果未指定,则网络连接不会映射到驱动器号。 如果指定了此值,则该值必须介于 D 到 Z 的范围内。请勿使用 X,它是 Windows PE 在 Windows PE 阶段使用的驱动器号。

示例

  • D:
  • E:

SMSConnectNetworkFolderPassword

适用于 “连接到网络文件夹” 步骤。

(输入)

指定用于连接到 SMSConnectNetworkFolderPath 中的网络共享的 SMSConnectNetworkFolderAccount 的密码

SMSConnectNetworkFolderPath

适用于 “连接到网络文件夹” 步骤。

(输入)

指定连接的网络路径。 如果需要将此路径映射到驱动器号,请使用 SMSConnectNetworkFolderDriveLetter 值。

示例

\\server\share

SMSInstallUpdateTarget

适用于 安装软件更新 步骤。

(输入)

指定是安装所有更新还是仅安装必需更新。

有效值

  • All
  • Mandatory

SMSRebootMessage

适用于 “重启计算机” 步骤。

(输入)

指定要在重启目标计算机之前向用户显示的消息。 如果未设置此变量,将显示默认消息文本。 指定的消息不能超过 512 个字符。

示例

Save your work before the computer restarts.

SMSRebootTimeout

适用于 “重启计算机” 步骤。

(输入)

指定在计算机重启之前向用户显示警告的秒数。

示例

  • 0 (默认) :不显示重新启动消息
  • 60:显示警告一分钟

SMSTSAllowTokenAuthURLForACP

适用于版本 2203 及更高版本

使用 SMSTSDownloadProgram 变量使用备用内容提供程序时,请将此变量设置为 true 以允许其使用令牌身份验证。 如果未设置此变量或将其设置为 false,则会跳过任何令牌身份验证源。 备用内容提供程序必须支持令牌身份验证。

有关详细信息,请参阅 CMG 客户端身份验证

SMSTSAssignmentsDownloadInterval

自上次尝试未返回策略以来,客户端尝试下载策略之前等待的秒数。 默认情况下,客户端在重试前等待 0 秒。

可以使用媒体或 PXE 的预启动命令设置此变量。

SMSTSAssignmentsDownloadRetry

客户端在第一次尝试时未找到策略后尝试下载策略的次数。 默认情况下,客户端重试 0 次。

可以使用媒体或 PXE 的预启动命令设置此变量。

SMSTSAssignUsersMode

指定任务序列如何将用户与目标计算机关联。 将 变量设置为以下值之一:

  • 自动:当任务序列将 OS 部署到目标计算机时,它会在指定的用户和目标计算机之间创建关系。

  • 挂起:任务序列在指定用户和目标计算机之间创建关系。 管理员必须批准关系才能设置关系。

  • 已禁用:任务序列在部署 OS 时不会将用户与目标计算机相关联。

SMSTSDisableStatusRetry

在断开连接的情况下,任务序列引擎会反复尝试将状态消息发送到管理点。 此方案中的此行为会导致任务序列处理延迟。

将此变量设置为 , true 任务序列引擎在第一条消息发送失败后不会尝试发送状态消息。 第一次尝试包括多次重试。

任务序列重新启动时,此变量的值将保留。 但是,任务序列会尝试发送初始状态消息。 第一次尝试包括多次重试。 如果成功,任务序列将继续发送状态,而不管此变量的值如何。 如果状态无法发送,任务序列将使用此变量的值。

注意

任务序列状态报告 依赖于这些状态消息来显示每个步骤的进度、历史记录和详细信息。 如果状态消息无法发送,则它们不会排队。 将连接还原到管理点后,以后不会发送连接。 此行为导致任务序列状态报告不完整且缺少项。

SMSTSDisableWow64Redirection

适用于 “运行命令行” 步骤。

(输入)

默认情况下,在 64 位 OS 上,任务序列使用 WOW64 文件系统重定向器在命令行中查找并运行程序。 此行为允许命令查找 32 位版本的 OS 程序和 DLL。 将此变量设置为 将 true 禁用 WOW64 文件系统重定向器的使用。 该命令查找本机 64 位版本的 OS 程序和 DLL。 在 32 位 OS 上运行时,此变量不起作用。

SMSTSDownloadAbortCode

此变量包含外部程序下载程序的中止代码值。 此程序在 SMSTSDownloadProgram 变量中指定。 如果程序返回的错误代码等于 SMSTSDownloadAbortCode 变量的值,则内容下载失败,并且不会尝试其他下载方法。

SMSTSDownloadProgram

使用此变量 (ACP) 指定备用内容提供程序。 ACP 是用于下载内容的下载程序。 任务序列使用 ACP 而不是默认的 Configuration Manager 下载器。 作为内容下载过程的一部分,任务序列会检查此变量。 如果指定,任务序列将运行程序来下载内容。

SMSTSDownloadRetryCount

Configuration Manager 尝试从分发点下载内容的次数。 默认情况下,客户端重试 2 次。

SMSTSDownloadRetryDelay

Configuration Manager 在重试从分发点下载内容之前等待的秒数。 默认情况下,客户端在重试前等待 15 秒。

SMSTSDriverRequestConnectTimeOut

适用于 “自动应用驱动程序” 步骤。

请求驱动程序目录时,此变量是任务序列等待 HTTP 服务器连接的秒数。 如果连接花费的时间超过超时设置,任务序列将取消请求。 默认情况下,超时设置为 60 秒。

SMSTSDriverRequestReceiveTimeOut

适用于 “自动应用驱动程序” 步骤。

请求驱动程序目录时,此变量是任务序列等待响应的秒数。 如果连接花费的时间超过超时设置,任务序列将取消请求。 默认情况下,超时设置为 480 秒。

SMSTSDriverRequestResolveTimeOut

适用于 “自动应用驱动程序” 步骤。

请求驱动程序目录时,此变量是任务序列等待 HTTP 名称解析的秒数。 如果连接花费的时间超过超时设置,任务序列将取消请求。 默认情况下,超时设置为 60 秒。

SMSTSDriverRequestSendTimeOut

适用于 “自动应用驱动程序” 步骤。

发送驱动程序目录的请求时,此变量是任务序列等待发送请求的秒数。 如果请求花费的时间超过超时设置,任务序列将取消请求。 默认情况下,超时设置为 60 秒。

SMSTSErrorDialogTimeout

当任务序列中发生错误时,会显示一个包含错误的对话框。 任务序列在此变量指定的秒数后自动消除它。 默认情况下,此值为 900 秒 (15 分钟) 。

SMSTSLanguageFolder

使用此变量可更改非特定语言启动映像的显示语言。

SMSTSLocalDataDrive

指定任务序列在运行时在目标计算机上存储临时缓存文件的位置。

在任务序列开始之前设置此变量,例如通过设置集合变量。 任务序列启动后,Configuration Manager 会根据 SMSTSLocalDataDrive 变量的定义 定义_SMSTSMDataPath变量。

SMSTSMP

使用此变量指定 Configuration Manager 管理点的 URL 或 IP 地址。

SMSTSMPListRequestTimeoutEnabled

适用于以下步骤:

(输入)

如果客户端不在 Intranet 上,请使用此变量启用重复的 MPList 请求来刷新客户端。 默认情况下,此变量设置为 True

当客户端位于 Internet 上时,将此变量设置为 False 以避免不必要的延迟。

SMSTSMPListRequestTimeout

适用于以下步骤:

(输入)

如果任务序列无法从位置服务检索管理点列表 (MPList) ,则此变量指定在重试步骤之前等待的毫秒数。 默认情况下,任务序列在重试之前等待 60000 毫秒 (60 秒) 。 最多重试三次。

SMSTSPeerDownload

使用此变量使客户端能够使用 Windows PE 对等缓存。 将此变量设置为 true 启用此功能。

SMSTSPeerRequestPort

Windows PE 对等缓存用于初始广播的自定义网络端口。 在客户端设置中配置的默认端口为 8004

SMSTSPersistContent

使用此变量可以暂时保留任务序列缓存中的内容。 此变量不同于 SMSTSPreserveContent,后者在任务序列完成后将内容保留在 Configuration Manager 客户端缓存中。 SMSTSPersistContent 使用任务序列缓存,SMSTSPreserveContent 使用 Configuration Manager 客户端缓存。

SMSTSPostAction

指定在任务序列完成后运行的命令。 在退出任务序列之前,TSManager 进程会生成指定的 post 操作。 它不会等待或记录任何状态,只需在调用该命令后退出。

例如,指定 shutdown.exe /r /t 30 /f 在任务序列完成 30 秒后重新启动计算机。

SMSTSPreferredAdvertID

强制任务序列在目标计算机上运行特定的目标部署。 通过媒体或 PXE 的预启动命令设置此变量。 如果设置了此变量,任务序列将替代任何所需的部署。

SMSTSPreserveContent

此变量标记任务序列中的内容,该内容将在部署后保留在 Configuration Manager 客户端缓存中。 此变量不同于 SMSTSPersistContent,后者仅在任务序列的持续时间内保留内容。 SMSTSPersistContent 使用任务序列缓存,SMSTSPreserveContent 使用 Configuration Manager 客户端缓存。 将 SMSTSPreserveContent 设置为 true 以启用此功能。

SMSTSRebootDelay

指定计算机重启前要等待的秒数。 如果此变量为零 (0) ,则任务序列管理器在重新启动前不会显示通知对话框。

示例

  • 0:不显示通知

  • 60:显示通知一分钟

SMSTSRebootDelayNext

将此变量与现有 SMSTSRebootDelay 变量一起使用。 如果希望以与第一个时间不同的超时时间进行任何后续重新启动,请将 SMSTSRebootDelayNext 设置为其他值(以秒为单位)。

示例

你想要在 Windows 就地升级任务序列开始时向用户提供 60 分钟的重启通知。 在第一个长时间超时后,你希望其他超时仅为 60 秒。 将 SMSTSRebootDelay 设置为 3600,将 SMSTSRebootDelayNext 设置为 60

SMSTSRebootMessage

指定要在重启通知对话框中显示的消息。 如果未设置此变量,将显示默认消息。

示例

The task sequence is restarting this computer

SMSTSRebootRequested

指示在当前任务序列步骤完成后请求重启。 如果任务序列步骤需要重启才能完成操作,请设置此变量。 计算机重启后,任务序列将继续从下一个任务序列步骤运行。

  • HD:重启到已安装的 OS
  • WinPE:重启到关联的启动映像

SMSTSRetryRequested

在当前任务序列步骤完成后请求重试。 如果设置了此任务序列变量,则还要配置 SMSTSRebootRequested 变量。 重启计算机后,任务序列管理器将重新运行相同的任务序列步骤。

SMSTSRunCommandLineAsUser

适用于 “运行命令行” 步骤。

使用任务序列变量为 “运行命令行” 步骤配置用户上下文。 无需使用占位符帐户配置 运行命令行 步骤即可使用 SMSTSRunCommandLineUserNameSMSTSRunCommandLineUserPassword 变量。

使用以下值之一进行配置 SMSTSRunCommandLineAsUser

  • true:任何进一步 的“运行命令行” 步骤在 中指定的用户的上下文中 SMSTSRunCommandLineUserName运行。

  • false:任何进一步 的“运行命令行” 步骤在步骤中配置的上下文中运行。

SMSTSRunCommandLineUserName

适用于 “运行命令行” 步骤。

(输入)

指定运行命令行时所使用的帐户。 值是本地帐户的用户名格式字符串,或者域名称为域用户名。 使用 SMSTSRunCommandLineUserPassword 变量指定帐户密码。

注意

SMSTSRunCommandLineAsUser 变量与此变量一起使用,为此步骤配置用户上下文。

有关任务序列运行方式帐户的详细信息,请参阅 帐户

SMSTSRunCommandLineUserPassword

适用于 “运行命令行” 步骤。

(输入)

指定 SMSTSRunCommandLineUserName 变量指定的帐户的密码。

SMSTSRunPowerShellAsUser

适用于 运行 PowerShell 脚本 步骤。

使用任务序列变量为 “运行 PowerShell 脚本” 步骤配置用户上下文。 无需使用占位符帐户配置 运行 PowerShell 脚本 步骤即可使用 SMSTSRunPowerShellUserNameSMSTSRunPowerShellUserPassword 变量。

使用以下值之一进行配置 SMSTSRunPowerShellAsUser

  • true:任何进一步 的运行 PowerShell 脚本 步骤在 中指定的用户的上下文中 SMSTSRunPowerShellUserName运行。

  • false:任何进一步 的“运行 PowerShell 脚本” 步骤在步骤中配置的上下文中运行。

SMSTSRunPowerShellUserName

适用于 运行 PowerShell 脚本 步骤。

(输入)

指定运行 PowerShell 脚本时所使用的帐户。 该值是用户名或域\用户名形式的字符串。 使用 SMSTSRunPowerShellUserPassword 变量指定帐户密码。

注意

若要使用这些变量,请配置 “运行 PowerShell 脚本” 步骤,并将 设置为 “运行此步骤”作为以下帐户。 启用此选项时,如果要使用变量设置用户名和密码,请为帐户指定任何值。

有关任务序列运行方式帐户的详细信息,请参阅 帐户

SMSTSRunPowerShellUserPassword

适用于 运行 PowerShell 脚本 步骤。

(输入)

指定 SMSTSRunPowerShellUserName 变量指定的帐户的密码。

SMSTSSoftwareUpdateScanTimeout

适用于 安装软件更新 步骤。

(输入)

在此步骤中控制软件更新扫描的超时。 例如,如果在扫描期间需要大量更新,请增加 值。 默认值为 3600 秒 (60 分钟) 。 变量值以秒为单位设置。

SMSTSUDAUsers

使用以下格式指定目标计算机的主要用户: <DomainName>\<UserName>。 使用逗号 () , 分隔多个用户。 有关详细信息,请参阅 将用户与目标计算机关联

示例

contoso\jqpublic, contoso\megb, contoso\janedoh

SMSTSWaitCcmexecOperationalTimeout

(输入)

使用此变量控制任务序列等待 SMS 代理主机服务 (ccmexec) 完全启动的超时期限。 指定此值(以秒为单位)。 默认超时期限为 30 分钟或 1800 秒。

SMSTSWaitCcmexecOperationalTimeout 的示例

  • 1800 (默认) :30 分钟
  • 300:任务序列等待 5 分钟,ccmexec 启动

SMSTSWaitForSecondReboot

适用于 安装软件更新 步骤。

(输入)

当安装 软件更新任务触发 的软件更新安装需要多次重启时,此可选任务序列变量控制客户端行为。 在 安装软件更新 步骤之前设置此变量,以防止任务序列因软件更新安装多次重启而失败。

当单个 “安装软件更新” 任务序列步骤安装需要多次重启才能完成安装的软件更新时,此变量很有用。

设置 SMSTSWaitForSecondReboot 值(以秒为单位),以指定任务序列在计算机重启时在此步骤上暂停的时间。 如果多次重启,请留出足够的时间。 例如,如果将 SMSTSWaitForSecondReboot 设置为 600,则任务序列会在重启后暂停 10 分钟,然后再运行其他步骤。

SMSTSWaitForSecondReboot 变量旨在与安装软件更新任务一起使用,但可以在任务序列中的任意位置进行设置,以便在“安装软件更新”任务以外的任务启动重新启动后引入延迟。 因此,在 “安装软件更新” 任务之前设置此变量时,建议在 “安装软件更新” 任务之后再次设置它,值为 0。 这会重置变量,并防止任务序列期间出现不必要的延迟。 如果任务序列中有多个 “安装软件更新 ”任务,请在第一个 “安装软件更新 ”任务之前将变量定义为所需值,然后将其重置回 0 上一个 “安装软件更新” 任务之后。

注意

此变量仅适用于部署 OS 的 OSD 任务序列。 它不适用于任何不使用 安装程序 Windows 和 ConfigMgr 任务的任务序列,例如独立任务序列或就地升级任务序列。

TSDebugMode

在任务序列部署到的集合或计算机对象上,将此变量 TRUE 设置为 。 具有此变量集的任何设备都会将部署到它的任何任务序列置于调试模式。

有关详细信息,请参阅 调试任务序列

TSDebugOnError

将此变量设置为 , TRUE 以在任务序列返回错误时自动启动任务序列 调试器

使用设置此变量:

TSDisableProgressUI

使用此变量控制任务序列何时向最终用户显示进度。 若要在不同时间隐藏或显示进度,请在任务序列中多次设置此变量。

  • true:隐藏任务序列进度

  • false:显示任务序列进度

TSErrorOnWarning

适用于 “安装应用程序” 步骤。

(输入)

指定任务序列引擎是否在此步骤中将检测到的警告视为错误。 任务序列将 _TSAppInstallStatus 变量设置为 Warning ,如果一个或多个应用程序或所需的依赖项未安装,因为它不符合要求。 如果将此变量设置为 True,而任务序列将 _TSAppInstallStatus 设置为 Warning,则结果为错误。 值 False 是默认行为。

TSProgressInfoLevel

指定此变量可控制任务序列进度窗口显示的信息类型。 对此变量使用以下值:

  • 1:将当前步骤和总步骤包含在进度文本中。 例如, 2/10
  • 2:包括当前步骤、总步骤和已完成百分比。 例如, 10 个中的 2 个 (20% 完成)
  • 3:包括完成百分比。 例如, (20% 完成)

TSUEFIDrive

“变量” 字段中对 FAT32 分区的属性使用。 当任务序列检测到此变量时,它会在重启计算机之前准备磁盘以转换为 UEFI。 有关详细信息,请参阅 管理 BIOS 到 UEFI 转换的任务序列步骤

WorkingDirectory

适用于 “运行命令行” 步骤。

(输入)

指定命令行操作的起始目录。 指定的目录名称不能超过 255 个字符。

示例

  • C:\
  • %SystemRoot%

已弃用的变量

以下变量已弃用:

  • OSDAllowUnsignedDriver:部署 Windows Vista 及更高版本的操作系统时不使用
  • OSDBuildStorageDriverList:仅适用于 Windows XP 和 Windows Server 2003
  • OSDDiskpartBiosCompatibilityMode:仅在部署 Windows XP 或 Windows Server 2003 时才需要
  • OSDInstallEditionIndex:不需要 Windows Vista 后
  • OSDPreserveDriveLetter:有关详细信息,请参阅 OSDPreserveDriveLetter

OSDPreserveDriveLetter

重要

此任务序列变量已弃用。

在 OS 部署期间,默认情况下,Windows 安装程序确定最佳驱动器号以使用 (通常为 C:) 。

上一行为:应用映像时,OSDPreverveDriveLetter 变量确定任务序列是否使用映像文件中捕获的驱动器号 (WIM) 。 将此变量的值设置为 ,false以使用在“应用操作系统”任务序列步骤中为“目标”设置指定的位置。 有关详细信息,请参阅 应用 OS 映像

另请参阅