通过

操作系统部署任务序列变量

  • 项目

应用到: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

以下部分描述了任务序列操作变量（操作变量）和任务序列内置变量（内置变量）。以下列表显示了 Configuration Manager 2007 任务序列变量，并描述您可以如何使用它们来控制和自定义任务序列。任务序列变量为计算机、操作系统和在 Configuration Manager 2007 计算机上执行的用户状态配置任务提供配置设置。任务序列变量提供了一种机制来配置和自定义任务序列中的各个任务序列步骤。有关任务序列变量的详细信息，请参阅关于任务序列变量。

当计算机运行任务序列时，将使用常规配置设置初始化任务序列环境。随着在任务序列中运行各个任务序列步骤，特定于当前任务序列操作的设置将被添加到任务序列环境中。每个任务序列步骤完成之后，将从任务序列环境中删除任何特定于任务序列步骤的设置。

通过使用操作变量，您可以更改任务序列的关联默认值，以自定义如何在目标计算机上运行任务序列步骤。

备注

名称以下划线 (_) 字符开头的任务序列变量是只读的。您可以访问与只读任务序列变量相关联的值，但是不能更改相关联的值。

任务序列操作变量

任务序列操作变量（操作变量）指定特定任务序列步骤的配置属性。默认情况下，任务序列步骤设置会被初始化，并且只有当运行关联的任务序列步骤时才可用。也就是说，任务序列变量设置在运行任务序列步骤之前添加到任务序列环境，并且在任务序列步骤运行之后删除值。

例如，通过使用任务序列编辑器指定命令行操作的开始目录，在“运行命令行”任务序列步骤中指定“开始于”属性值。指定的默认值在任务序列环境中存储为 WorkingDirectory 变量，此变量特定于“运行命令行”任务序列操作。“WorkingDirectory”环境变量在运行“运行命令行”任务序列操作之前会被初始化。在“运行命令行”步骤期间，指定的目录值可通过名为 WorkingDirectory 的环境变量来访问。任务序列步骤完成之后，将从任务序列环境中删除此变量。如果序列包含另一个“运行命令行”任务序列步骤，则新的 WorkingDirectory 变量会被初始化并设置为该任务序列的启动值。

尽管在运行任务序列步骤时任务序列操作设置存在默认值，但是序列中的多个步骤可以使用您设置的任何新值。如果使用任务序列变量创建方法之一来替代内置变量值，则新值仍将保留在环境中，并替代任务序列中其他步骤的默认值。在上一示例中，如果将“设置任务序列变量”步骤添加为任务序列的第一个步骤，并将 WorkingDirectory 环境变量设置为值 C:\，则任务序列中的“运行命令行”步骤都将使用新的开始目录值。

按照关联的任务序列操作对 Configuration Manager 2007 任务序列变量进行分组：

任务序列内置变量

任务序列内置变量（内置变量）由基础任务序列引擎产生，其关联值通常是只读的。内置变量提供有关关联任务序列运行环境的信息。与内置变量关联的值在整个任务序列的任务序列环境中可用。通常，内置变量在任务序列中的任何任务序列步骤运行之前会被初始化。例如，内置变量 _SMSTSLogPath 指定任务序列运行时 Configuration Manager 2007 组件用来写入日志文件的路径；任何任务序列步骤均可以访问此环境变量。

以下列表描述 Configuration Manager 2007 任务序列中可使用的 Configuration Manager 2007 内置变量：

内置变量名称 描述

_SMSTSAdvertID

存储当前运行的任务序列播发 ID。它使用与 Configuration Manager 2007 软件分发播发 ID 相同的格式。如果任务序列从独立的媒体中运行，则不定义此变量。

例如：

ABC20001

_SMSTSBootImageID

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

例如：

ABC00001

_SMSTSClientGUID

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

例如：

0a1a9a4b-fc56-44f6-b7cd-c3f8ee37c04c

_SMSTSCurrentActionName

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

例如：

run command line

_SMSTSDownloadOnDemand

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

_SMSTSInWinPE

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

_SMSTSLastActionRetCode

存储所运行的上一操作返回的返回代码。

例如：

0

_SMSTSLastActionSucceeded

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

_SMSTSLaunchMode

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

  • SMS - 指定使用 Configuration Manager 2007 客户端启动任务序列。

  • UFD - 指定使用 USB 媒体启动任务序列。

  • CD - 指定使用 CD/DVD 集启动任务序列。

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

_SMSTSLogPath

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

_SMSTSMachineName

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

例如：

ABC

_SMSTSMediaType

指定将用于启动安装的媒体类型。媒体类型示例包括启动媒体、完全媒体、PXE 和预留媒体。

_SMSTSMP

存储 Configuration Manager 2007 管理点的名称或 IP 地址。

_SMSTSMPPort

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

例如：

80

_SMSTSOrgName

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

例如：

XYZ Organization

_SMSTSPackageID

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

例如：

HJT00001

_SMSTSPackageName

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

例如：

Deploy xpsp2 task sequence

_SMSTSRunFromDP

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

_SMSTSSiteCode

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

例如：

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,Eastern Standard Time,Eastern Daylight Time

_SMSTSUseCRL

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

_SMSTSUserStarted

指定任务序列是否由用户启动。只有当任务序列从 Configuration Manager 2007 客户端启动时，才设置此变量。例如，如果“_SMSTSLaunchMode”设置为“SMS”。变量可以有下列值：

  • true - 指定任务序列由用户从客户端“运行播发程序”程序手动启动。

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

_SMSTSUseSSL

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

SMSTSErrorDialogTimeout

当任务序列中发生错误时，会显示一个对话框，该对话框会在默认超时值之后自动关闭。使用此变量指定默认值 15 分钟之外的超时值（秒）。

SMSTSRebootDelay

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

例如：

0

30

SMSTSRebootMessage

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

例如：

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

SMSTSRebootRequested

表示在完成当前的任务序列步骤后需要重新启动。如果需要重新启动，则只需将此变量设置为“true”，任务序列管理器将在此任务序列步骤之后重新启动计算机。如果任务序列步骤需要重新启动才能完成，则必须设置此任务序列变量。计算机重新启动之后，任务序列将继续运行下一个任务序列步骤。

SMSTSLocalDataDrive

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

SMSTSRetryRequested

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

另请参阅

概念

关于任务序列变量

有关其他信息，请参阅 Configuration Manager 2007 Information and Support。
要与文档团队联系，请将电子邮件发送至 SMSdocs@microsoft.com。