• 项目

Configuration Manager 中的任务序列内置变量

 

适用对象：System Center 2012 Configuration Manager, System Center 2012 Configuration Manager SP1, System Center 2012 Configuration Manager SP2, System Center 2012 R2 Configuration Manager, System Center 2012 R2 Configuration Manager SP1

任务序列内置变量由 System Center 2012 Configuration Manager 提供。 内置变量提供有关任务序列的运行环境的信息，并且它们的值可在整个任务序列可用。 通常，在任务序列中运行步骤前初始化内置变量。 例如，内置变量 _SMSTSLogPath 是一个环境变量，指定任务序列运行时 配置管理器 组件用于写入日志文件的路径；任何任务序列步骤均可以访问此环境变量。 但是，有些变量（如 _SMSTSCurrentActionName）在执行每个步骤前都要进行评估。 内置变量的值通常是只读的。 对于名称以下划线开头的内置变量，值是只读的。

任务序列内置变量列表

下面的列表描述了 配置管理器 中可用的内置变量：

内置变量名称

描述

_SMSTSAdvertID

存储当前运行的任务序列部署的唯一 ID。 它使用与 配置管理器 软件分发部署 ID 相同的格式。 如果任务序列从独立的媒体运行，则此变量未定义。

例如：

ABC20001

_TSAppInstallStatus

适用于 System Center 2012 R2 Configuration Manager 和更高版本：

任务序列在“安装应用程序”任务序列步骤中随应用程序的安装状态一起设置 _TSAppInstallStatus 变量。 任务序列使用下列值之一设置该变量：

  1. 未定义：在“安装应用程序”任务序列步骤未运行时设置。

  2. 错误：在至少一个应用程序由于“安装应用程序”任务序列步骤中出错而失败时设置。

  3. 警告：在“安装应用程序”任务序列步骤中未出错但一个或多个应用程序或必需的依赖关系由于不满足要求而未安装时设置。

  4. 成功：在“安装应用程序”任务序列步骤中未检测到错误或警告时设置。

_SMSTSBootImageID

如果某个启动映像包与当前运行的任务序列关联，则存储 配置管理器 启动映像包 ID。 如果任何 配置管理器 启动映像包都不关联，则不设置此变量。

例如：

ABC00001

_SMSTSBootUEFI

适用于 System Center 2012 Configuration Manager SP1 和更高版本：

当任务序列检测到计算机处于 UEFI 模式时，它会设置 SMSTSBootUEFI 变量。

_SMSTSClientGUID

存储 配置管理器 客户端 GUID 的值。 如果从独立的媒体运行任务序列，则不设置此变量。

例如：

0a1a9a4b-fc56-44f6-b7cd-c3f8ee37c04c

_SMSTSCurrentActionName

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

例如：

运行命令行

_SMSTSDownloadOnDemand

如果当前任务序列正在按需下载模式下运行（意味着任务序列管理器仅在必须访问内容时本地下载内容），则设置为“true”。

_SMSTSInWinPE

如果当前任务序列步骤正在 Windows PE 环境中运行，则此变量设置为“true”，否则设置为“false”。 你可以测试此任务序列变量以确定当前的操作系统环境。

_SMSTSLastActionRetCode

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

例如：

0

_SMSTSLastActionSucceeded

如果上一操作成功，变量设置为“true”，如果上一操作失败，变量设置为“false”。 如果由于步骤被禁用或关联的条件被评估为“false”而跳过上一操作，则此变量不会重置，这意味着仍保留之前操作的值。

_SMSTSLaunchMode

指定任务序列启动方法。 任务序列可以有下列值：

  • SMS - 指定通过使用 配置管理器 客户端启动任务序列。

  • UFD - 指定通过使用 USB 媒体启动任务序列和在 Windows XP/2003 中创建的 USB 媒体。

  • UFD+FORMAT - 指定通过使用 USB 媒体启动任务序列和在 Windows Vista 以及更高版本中创建的 USB 媒体。

  • CD - 指定通过使用 CD 启动任务序列。

  • DVD - 指定通过使用 DVD 启动任务序列。

  • PXE - 指定从 PXE 启动任务序列。

  • HD – 指定从硬盘（仅预暂存媒体）启动任务序列。

_SMSTSLogPath

存储日志目录的完整路径。 可用于确定记录操作的位置。 如果没有硬盘驱动器可用，则不设置此值。

_SMSTSMachineName

存储并指定计算机名称。 存储任务序列将用于记录所有状态消息的计算机的名称。 要更改新操作系统中的计算机名称，请使用“OSDComputerName”变量。

例如：

ABC

_SMSTSMDataPath

指定由 SMSTSLocalDataDrive 变量定义的路径。 当你在任务序列开始前定义 SMSTSLocalDataDrive 时，例如设置集合变量，任务序列开始后，配置管理器 将定义 _SMSTSMDataPath 变量。

_SMSTSMediaType

指定用于启动安装的媒体类型。 媒体类型示例有启动媒体、完全媒体、PXE 和预暂存媒体。

_SMSTSMP

存储 配置管理器 管理点的名称或 IP 地址。

_SMSTSMPPort

存储 配置管理器 管理点的管理点端口号。

例如：

80

_SMSTSOrgName

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

例如：

XYZ Organization

_SMSTSPackageID

存储当前运行的任务序列的 ID。 此 ID 使用与 配置管理器 软件包 ID 相同的格式。

例如：

HJT00001

_SMSTSPackageName

存储当前运行的任务序列由 配置管理器 管理员在创建任务序列时指定的名称。

例如：

部署 Windows 7 任务序列

_SMSTSRunFromDP

如果当前任务序列正在“从分发点运行”模式下运行（意味着任务序列管理器将从分发点获取所需的包共享），则此值设置为“true”。

_SMSTSSiteCode

存储 配置管理器 站点的站点代码。

例如：

ABC

_SMSTSType

指定当前运行的任务序列的类型。 可以有下列值：

1 - 表示一般任务序列。

2 - 表示操作系统部署任务序列。

_SMSTSTimezone

_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, 东部标准时间, 东部白天时间 

_SMSTSUseCRL

指示当任务序列使用安全套接字层 (SSL) 证书与管理点通信时，任务序列是否使用证书吊销列表。

_SMSTSUserStarted

指定任务序列是否由用户启动。 仅当任务序列从软件中心启动时设置此变量。 例如，如果“_SMSTSLaunchMode”设置为“SMS”。 变量可以有下列值：

  • true - 指示任务序列通过用户从软件中心手动启动。

  • false - 指示任务序列由 配置管理器 计划器自动启动。

_SMSTSUseSSL

指定任务序列是否使用 SSL 与 配置管理器 管理点通信。 如果你的站点在纯模式下运行，则将此值设置为“true”。

_SMSTSWTG

适用于 System Center 2012 Configuration Manager SP1 和更高版本：

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

SMSTSAssignmentsDownloadInterval

适用于 System Center 2012 Configuration Manager SP1 和更高版本：

使用此变量可指定客户端自上次尝试（未返回策略）下载策略到再次尝试之前所等待的秒数。 默认情况下，客户端将等待 0 秒，然后再重试。

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

SMSTSAssignmentsDownloadRetry

适用于 System Center 2012 Configuration Manager SP1 和更高版本：

此变量用于指定客户端在初次尝试下载策略而未找到策略之后将再次尝试下载该策略的次数。 默认情况下，客户端将重试 0 次。

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

SMSTSAssignUsersMode

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

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

  • 挂起：任务序列创建特定用户和目标计算机之间的关系，但在设置关系前等待来自管理用户的批准。

  • 已禁用：当任务序列部署操作系统时，它不会将用户与目标计算机关联。

SMSTSDownloadProgram

适用于 System Center 2012 Configuration Manager SP1 和更高版本：

使用此变量可指定替换内容提供程序，以便使用此下载程序而不是默认的 配置管理器 下载程序为任务序列下载内容。 作为内容下载过程的一部分，任务序列会检查此变量，以了解是否指定了下载程序。 如果已指定，则任务序列会运行指定的程序来执行下载。

SMSTSDownloadRetryCount

适用于 System Center 2012 R2 Configuration Manager 和更高版本：

使用此变量来指定 配置管理器 尝试从分发点下载内容的次数。 默认情况下，客户端将重试 2 次。 

SMSTSDownloadRetryDelay

适用于 System Center 2012 R2 Configuration Manager 和更高版本：

使用此变量来指定 配置管理器 在尝试从分发点下载内容之前等待的秒数。 默认情况下，客户端将在重试之前等待 15 秒。

SMSTSErrorDialogTimeout

当任务序列中发生错误时，显示对话框，在此变量指定的秒数后自动关闭。 默认情况下，该对话框将在 900 秒（15 分钟）后自动关闭..

TSErrorOnWarning

适用于 System Center 2012 R2 Configuration Manager 和更高版本：

使用此变量指定任务序列引擎是否将应用程序安装任务序列步骤检测到的警告视为错误。 由于未满足要求而导致一个或多个应用程序或所需的依赖项未安装时，任务序列将 _TSAppInstallStatus 变量设置为 Warning。 当你将 TSErrorOnWarning 变量设置为 True 且 _TSAppInstallStatus 变量设置为 Warning 时，它被视为错误。 值 False 是默认行为。

SMSTSLanguageFolder

适用于 System Center 2012 Configuration Manager SP1 和更高版本：

使用此变量可更改语言中性启动映像的显示语言。

SMSTSLocalDataDrive

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

此变量必须在任务序列开始前设置，例如通过设置集合变量。 任务序列启动后，配置管理器定义 _SMSTSMDataPath 变量。

SMSTSMPListRequestTimeout

适用于 System Center 2012 R2 Configuration Manager 和更高版本：

使用此变量指定任务序列在利用定位服务检索管理点列表失败后重新尝试安装应用程序之前等待的毫秒数。 默认情况下，60,000 毫秒（60 秒）后，它重试此步骤，最多三次。 此变量仅适用于安装应用程序任务序列步骤。

SMSTSPersistContent

适用于 System Center 2012 Configuration Manager SP1 和更高版本：

使用此变量可临时将内容保存在任务序列缓存中。

SMSTSPostAction

适用于 System Center 2012 Configuration Manager SP1 和更高版本：

指定任务序列完成后运行的命令。 例如，你可使用此变量指定任务序列将操作系统部署到设备后，在嵌入的设备上启用写筛选器的脚本。

SMSTSPreferredAdvertID

强制运行目标计算机上的特定目标部署。 可通过媒体或 PXE 的预启动命令对其进行设置。 如果设置此变量，则任务序列覆盖任何必需的部署。

OSDPreserveDriveLetter

适用于 System Center 2012 Configuration Manager SP1 和更高版本：

此变量决定当将此图像应用到目标计算机时，任务序列是否使用在操作系统映像 WIM 文件中捕获的驱动器号。 在不带 Service Pack 的 配置管理器 中，当应用操作系统映像 WIM 文件时，会使用 WIM 文件上捕获的驱动器号。 在 配置管理器 SP1 中，你可以将此变量的值设置为 False 以使用为“应用操作系统”任务序列步骤中的“目标”设置指定的位置。 有关应用操作系统任务序列步骤的详细信息，请参阅 应用操作系统映像 主题中的 Configuration Manager 中的任务序列步骤 部分。

SMSTSRebootDelay

指定在计算机重新启动之前要等待多少秒。 如果此变量没有设置为 0，则任务序列管理器将在重新启动之前显示通知对话。

例如：

0

30

SMSTSRebootMessage

指定需要重新启动时显示在关机对话框中的消息。 如果未设置此变量，则显示默认消息。

例如：

此计算机将由任务序列管理器重新启动。

SMSTSRebootRequested

指示当前任务序列步骤完成后，请求重新启动。 如果需要重新启动，则仅将此变量设置为 true，任务序列管理器将在此任务序列步骤后重新启动计算机。 任务序列步骤必须设置此任务序列变量，如果其需要重新启动以完成任务序列步骤。 重新启动计算机后，任务序列将继续从下一个任务序列步骤运行。

SMSTSRetryRequested

在完成当前的任务序列步骤后，将请求重试。 如果设置任务序列变量，SMSTSRebootRequested 必须设置为 true。 重新启动计算机后，任务序列管理器将重新运行相同的任务序列步骤。

SMSTSUDAUsers

指定目标计算机的主要用户。 通过使用以下格式指定用户。 使用逗号 (，) 分隔多个用户。

例如：

domain\user1、domain\user2、domain\user3

有关如何将用户与目标计算机关联的详细信息，请参阅如何将用户与目标计算机相关联。