工作順序變數

發行項
02/29/2024

適用於：Configuration Manager (目前的分支)

本文是所有可用變數的參考，依字母順序排列。使用瀏覽器 Find 函式 (通常是 CTRL + F) 來尋找特定變數。變數會指出它是否專屬於特定步驟。工作順序步驟的相關文章包含每個步驟特定的變數清單。

如需詳細資訊，請參閱使用工作順序變數。

工作順序變數參考

_OSDDetectedWinDir

工作順序會掃描計算機的硬碟，以在 Windows PE 啟動時安裝先前的作業系統。 Windows 資料夾位置會儲存在此變數中。您可以設定工作順序，從環境中擷取此值，並使用它來指定要用於新作業系統安裝的相同 Windows 資料夾位置。

_OSDDetectedWinDrive

工作順序會掃描計算機的硬碟，以在 Windows PE 啟動時安裝先前的作業系統。安裝作業系統的硬碟位置會儲存在此變數中。您可以將工作順序設定為從環境中擷取此值，並使用它來指定要用於新作業系統的相同硬碟位置。

_OSDMigrateUsmtPackageID

適用於擷取用戶狀態步驟。

(輸入)

指定包含 USMT 檔案之 Configuration Manager 套件的套件識別碼。這是必要變數。

_OSDMigrateUsmtRestorePackageID

適用於還原用戶狀態步驟。

(輸入)

指定包含 USMT 檔案之 Configuration Manager 套件的套件識別碼。這是必要變數。

_SMSTSAdvertID

儲存目前執行中的工作順序部署唯一標識碼。其使用的格式與 Configuration Manager 軟體發佈部署標識符相同。如果工作順序是從獨立媒體執行，則此變數未定義。

範例

ABC20001

_SMSTSAppInstallNeedsRetry

從此 Configuration Manager 2211 HFRU Kb 開始16643863和更新版本

適用於安裝應用程式步驟。

如果先前的應用程式無法安裝且需要重試，此值會設定為 true。

否則，這個值會設定為 false。

_SMSTSAssetTag

適用於設定動態變數步驟。

指定計算機的資產標記。

_SMSTSBootImageID

如果目前執行中的工作順序參考開機映射套件，此變數會儲存開機映像套件標識符。如果工作順序未參考開機映射套件，則不會設定此變數。

範例

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

儲存目前執行中的工作順序標識碼。此標識碼使用與 Configuration Manager 套件識別元相同的格式。

範例

HJT00001

_SMSTSPackageName

儲存目前執行中的工作順序名稱。建立工作順序時，Configuration Manager 系統管理員會指定此名稱。

範例

Deploy Windows 10 task sequence

_SMSTSRunFromDP

true如果目前的工作順序是在從發佈點模式執行，請設定為。此模式表示工作順序管理員會從發佈點取得必要的套件共用。

_SMSTSSerialNumber

適用於設定動態變數步驟。

指定電腦的序號。

_SMSTSSetupRollback

指定 Windows 安裝程式是否在就地升級期間執行復原作業。變數值可以是 true 或 false。

_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

適用於檢查整備步驟。

針對 要重新整理的目前作業系統 是否要檢查的唯讀變數會 () 1 傳回 true，或 () 傳回 false 0 。如果您未啟用檢查，這個唯讀變數的值會是空白的。

_TS_CRARCH

適用於檢查整備步驟。

只讀變數，用於 目前OS的 架構檢查是否傳回 true () 1 或 false (0) 。如果您未啟用檢查，這個唯讀變數的值會是空白的。

_TS_CRMINOSVER

適用於檢查整備步驟。

只讀變數，用於最 小OS版本 檢查傳回 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

適用於檢查整備步驟。

唯讀變數，用於 檢查 AC 電源外掛程式 是否傳回 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

這是必要的設定。可能的值為 True 或 False。例如：

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

NetBIOS over TCP/IP 的選項。可能的值如下：

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

適用於套用驅動程式套件步驟。

(輸入)

指定要從驅動程式套件安裝之大型儲存設備驅動器的內容識別碼。如果未指定此變數，則不會安裝大量記憶體驅動程式。

OSDApplyDriverBootCriticalHardwareComponent

適用於套用驅動程式套件步驟。

(輸入)

指定是否已安裝大型儲存設備驅動器，此變數必須是 scsi。

如果已設定 OSDApplyDriverBootCriticalContentUniqueID ，則需要此變數。

OSDApplyDriverBootCriticalID

適用於套用驅動程式套件步驟。

(輸入)

指定要安裝之大型儲存設備驅動器的開機關鍵標識符。此標識符會列在設備驅動器 txtsetup.oem 檔案的 scsi 區段中。

如果已設定 OSDApplyDriverBootCriticalContentUniqueID ，則需要此變數。

OSDApplyDriverBootCriticalINFFile

適用於套用驅動程式套件步驟。

(輸入)

指定要安裝之大型記憶體驅動程式的 INF 檔案。

如果已設定 OSDApplyDriverBootCriticalContentUniqueID ，則需要此變數。

OSDAutoApplyDriverBestMatch

適用於自動套用驅動程式步驟。

(輸入)

如果驅動程式類別目錄中有多個設備驅動器與硬體裝置相容，此變數會決定步驟的動作。

有效值

true (預設) ：僅安裝最佳的設備驅動器
false：安裝所有相容的設備驅動器，而 Windows 會選擇最適合使用的驅動程式

OSDAutoApplyDriverCategoryList

適用於自動套用驅動程式步驟。

(輸入)

驅動程式類別目錄類別唯一標識碼的逗號分隔清單。 [自動套用驅動程式] 步驟只會考慮至少其中一個指定類別中的驅動程式。此值是選擇性的，而且預設不會設定。列舉網站上的 SMS_CategoryInstance物件清單 ，以取得可用的類別標識碼。

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映射步驟。

(輸入)

指定有權將擷取的映像儲存在 OSDCaptureDestination (網路共用) 的 Windows 帳戶名稱。也請指定 OSDCaptureAccountPassword。

如需擷取OS映像帳戶的詳細資訊，請參閱帳戶。

OSDCaptureAccountPassword

適用於擷取OS映射步驟。

(輸入)

指定用來將擷取的映像儲存在OSDCaptureDestination) ) (網路共用上之OSDCaptureAccount (Windows 帳戶的密碼。

OSDCaptureDestination

適用於擷取OS映射步驟。

(輸入)

指定工作順序儲存所擷取OS映射的位置。目錄名稱長度上限為 255 個字元。如果網路共用需要驗證，請指定 OSDCaptureAccount 和 OSDCaptureAccountPassword 變數。

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-Key Compatible 鍵盤或 Microsoft Natural 鍵盤 (類型 1)
`3`	韓文電腦/AT 101-Key Compatible 鍵盤或 Microsoft Natural 鍵盤 (類型 2)
`4`	韓文電腦/AT 101-Key Compatible 鍵盤或 Microsoft Natural 鍵盤 (類型 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 (USMT) 之用戶狀態移轉工具的其他命令行選項。將其他選項指定為字串，工作順序會將其附加至LoadState自動產生的USMT命令行。

在執行工作順序之前，不會驗證使用此工作順序變數指定的 USMT 選項是否正確。

如需可用選項的詳細資訊，請參閱 LoadState語法。

OSDMigrateComputerName

適用於擷取 Windows 設定步驟。

(輸入)

指定是否移轉計算機名稱。

有效值

true (預設) 。 OSDComputerName (輸出) 變數會設定為計算機的 NetBIOS 名稱。
false

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 設定步驟。

(輸入)

指定步驟是否移轉用戶和組織資訊。

有效值

true (預設) 。 OSDRegisteredOrgName (輸出) 變數會設定為計算機的已註冊組織名稱。
false

OSDMigrateSkipEncryptedFiles

適用於擷取用戶狀態步驟。

(輸入)

指定是否擷取加密的檔案。

有效值

true
false (預設)

OSDMigrateTimeZone

適用於擷取 Windows 設定步驟。

(輸入)

指定是否移轉計算機時區。

有效值

true (預設) 。 OSDTimeZone (輸出) 變數會設定為計算機的時區。
false

OSDNetworkJoinType

適用於套用網路設定步驟。

(輸入)

指定目的地電腦是否加入 Active Directory 網域或工作組。

值值

0：加入 Active Directory 網域
1：加入工作組

OSDPartitions

適用於 [格式化] 和 [磁碟分區 ] 步驟。

(輸入)

此工作順序變數是數據分割設定的數位變數。陣列中的每個元素都代表硬碟上單一磁碟分區的設定。結合陣列變數名稱與以零起始的磁碟分區編號和屬性名稱，以存取為每個分割區定義的設定。

使用下列變數名稱來定義此步驟在硬碟上建立 之第一個 磁碟分區的屬性：

OSDPartitions0Type

指定數據分割的類型。此為必要屬性。有效值為 Primary、 Extended、 Logical和 Hidden。

OSDPartitions0FileSystem

指定格式化資料分割時要使用的檔案系統類型。這個屬性是選擇性的。如果您未指定檔案系統，則此步驟不會格式化數據分割。有效值為 FAT32 與 NTFS。

OSDPartitions0Bootable

指定數據分割是否可開機。此為必要屬性。如果 MBR 磁碟的這個值設定 TRUE 為，則步驟會將此磁碟分區標示為使用中。

OSDPartitions0QuickFormat

指定所使用的格式類型。此為必要屬性。如果此值設定為 TRUE，此步驟會執行快速格式。否則，步驟會執行完整格式。

OSDPartitions0VolumeName

指定格式化時指派給磁碟區的名稱。這個屬性是選擇性的。

OSDPartitions0Size

指定數據分割的大小。這個屬性是選擇性的。如果未指定此屬性，則會使用所有剩餘的可用空間建立數據分割。單位是由 OSDPartitions0SizeUnits 變數指定。

OSDPartitions0SizeUnits

此步驟會使用這些單位來解譯 OSDPartitions0Size 變數。這個屬性是選擇性的。有效值 (MB 預設) 、 GB和 Percent。

OSDPartitions0VolumeLetterVariable

當此步驟建立磁碟分區時，它一律會在 Windows PE 中使用下一個可用的驅動器號。使用這個選擇性屬性來指定另一個工作順序變數的名稱。此步驟會使用此變數來儲存新的驅動器號以供日後參考。

如果您使用此工作順序步驟定義多個數據分割，則會使用變數名稱中的1個索引來定義第二個資料分割的屬性。例如： OSDPartitions1Type、 OSDPartitions1FileSystem、 OSDPartitions1Bootable、 OSDPartitions1QuickFormat 和 OSDPartitions1VolumeName。

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中使用的預設時區設定。

將此變數的值設定為不因語言而異的時區名稱。例如，在下列登錄機碼下的時區值中 Std 使用字串： HKEY_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 安裝完成時，請使用此變數來解決高效能裝置上 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

適用於 [ 連線到網络資料夾] 步驟。

(輸入)

指定 SMSConnectNetworkFolderAccount 的密碼，用來連線到 SMSConnectNetworkFolderPath中的網路共用。

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

適用於下列步驟：

(輸入)

如果用戶端不在內部網路上，請使用此變數來啟用重複的 MPList 要求來重新整理用戶端。根據預設，此變數會設定為 True。

當用戶端在因特網上時，請將此變數設定為， False 以避免不必要的延遲。

SMSTSMPListRequestTimeout

適用於下列步驟：

(輸入)

如果工作順序無法從位置服務擷取 MPList) (管理點清單，此變數會指定在重試步驟之前，要等候多少毫秒。根據預設，工作順序會等候 60000 毫秒 (60 秒) 再重試。最多重試三次。

SMSTSPeerDownload

使用此變數可讓用戶端使用 Windows PE 對等快取。將此變數設定為可 true 啟用這項功能。

SMSTSPeerRequestPort

Windows PE 對等快取用於初始廣播的自定義網路埠。用戶端設定中設定的預設埠是 8004。

SMSTSPersistContent

使用此變數暫時將內容保存在工作順序快取中。此變數與SMSTSPreserveContent不同，後者會在工作順序完成之後，將內容保留在 Configuration Manager用戶端快取中。 SMSTSPersistContent 使用工作順序快取，SMSTSPreserveContent 會使用 Configuration Manager 用戶端快取。

SMSTSPostAction

指定工作順序完成後執行的命令。在結束工作順序之前，TSManager 進程會繁衍指定的張貼動作。它不會等候或記錄任何狀態，只會在呼叫該命令之後結束。

例如，指定 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

適用於執行命令行步驟。

使用工作順序變數來設定執行 命令行 步驟的用戶內容。您不需要使用佔位符帳戶設定執行 命令行 步驟，即可使用 SMSTSRunCommandLineUserName 和 SMSTSRunCommandLineUserPassword 變數。

SMSTSRunCommandLineAsUser使用下列其中一個值進行設定：

true：任何進一步的執行 命令行 步驟會在中指定的用戶內容中 SMSTSRunCommandLineUserName執行。
false：任何進一步的執行 命令行 步驟會在您在步驟上設定的內容中執行。

SMSTSRunCommandLineUserName

適用於執行命令行步驟。

(輸入)

指定執行命令行所依據的帳戶。值是本機帳戶的窗體用戶名稱字串，或網域帳戶的 domain\username 字串。使用 SMSTSRunCommandLineUserPassword 變數指定帳戶密碼。

注意事項

使用 SMSTSRunCommandLineAsUser 變數搭配此變數來設定此步驟的用戶內容。

如需工作順序執行身分帳戶的詳細資訊，請參閱帳戶。

SMSTSRunCommandLineUserPassword

適用於執行命令行步驟。

(輸入)

指定 SMSTSRunCommandLineUserName 變數所指定帳戶的密碼。

SMSTSRunPowerShellAsUser

適用於執行 PowerShell 腳本步驟。

使用工作順序變數來設定執行 PowerShell 腳本 步驟的用戶內容。您不需要使用佔位符帳戶設定執行 PowerShell 腳本 步驟，即可使用 SMSTSRunPowerShellUserName 和 SMSTSRunPowerShellUserPassword 變數。

SMSTSRunPowerShellAsUser使用下列其中一個值進行設定：

true：任何進一步的 執行 PowerShell 腳本 步驟會在中指定的使用者內容中 SMSTSRunPowerShellUserName執行。
false：任何進一步的 執行 PowerShell 腳本 步驟會在您在步驟上設定的內容中執行。

SMSTSRunPowerShellUserName

適用於執行 PowerShell 腳本步驟。

(輸入)

指定執行 PowerShell 腳本的帳戶。值是用戶名稱或 domain\username 格式的字串。使用 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 (20% 的 2 個完成) 。
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映像。