工作順序變數

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

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

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

工作順序變數參考

_OSDDetectedWinDir

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

_OSDDetectedWinDrive

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

_OSDMigrateUsmtPackageID

適用於 Capture User State 步驟。

(輸入)

指定包含 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。 測試此工作順序變數以判斷目前的作業系統環境。

_SMSTSIPAddresses

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

指定電腦使用的 IP 位址。

_SMSTSLastActionName

儲存上次執行的動作名稱。 此變數與 _SMSTSLastActionRetCode相關。 工作順序會將這些值記錄到 smsts.log 檔案。 此變數在對工作順序進行疑難排解時很有用。 當步驟失敗時，自訂指令碼可以包含步驟名稱以及傳回碼。

_SMSTSLastActionRetCode

儲存上次執行動作的傳回碼。 此變數可用來做為判斷是否執行下一個步驟的條件。

範例

0

_SMSTSLastActionSucceeded

  • 如果最後一個步驟成功，此變數為 true。

  • 如果最後一個步驟失敗，則為 false。

  • 如果工作順序略過上一個動作，因為步驟已停用或相關聯的條件評估為 false，則不會重設此變數。 它仍會保留上一個動作的值。

_SMSTSLastContentDownloadLocation

此變數包含工作順序下載或嘗試下載內容的最後位置。 檢查此變數，而不是剖析此內容位置的用戶端記錄。

_SMSTSLaunchMode

指定工作順序是透過下列其中一種方法啟動：

  • SMS：Configuration Manager 用戶端，例如當使用者從軟體中心啟動它時
  • UFD：舊版 USB 媒體
  • UFD+格式：較新的 USB 媒體
  • CD：可開機的 CD
  • DVD：可開機的 DVD
  • PXE： 使用 PXE 進行網路開機
  • HD：硬碟上的預備媒體

_SMSTSLogPath

儲存記錄目錄的完整路徑。 使用此值來判斷工作順序步驟記錄其動作的位置。 硬碟無法使用時，不會設定此值。

_SMSTSMacAddresses

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

指定電腦使用的 MAC 位址。

_SMSTSMachineName

儲存及指定電腦名稱。 儲存工作順序用來記錄所有狀態訊息的電腦名稱。 若要變更新作業系統中的電腦名稱，請使用 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： 作業系統部署工作順序

_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

適用於 檢查整備 程度步驟。

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

_TS_CRARCH

適用於 檢查整備 程度步驟。

目前 OS 檢查的架構 是傳回 True (1) ，還是 (0) 傳回 False 的唯讀變數。 如果未啟用檢查，則此唯讀變數的值為空白。

_TS_CRMINOSVER

適用於 檢查整備 程度步驟。

這是唯讀變數，用於顯示 最低作業系統版本 檢查是傳回 True) (1 還是 (0) 傳回 False。 如果未啟用檢查，則此唯讀變數的值為空白。

_TS_CRMAXOSVER

適用於 檢查整備 程度步驟。

僅唯讀變數，用於判斷 [作業系統最高版本] 檢查是否傳回 True (1) 或 False (0) 。 如果未啟用檢查，則此唯讀變數的值為空白。

_TS_CRCLIENTMINVER

適用於 檢查整備 程度步驟。

僅唯讀變數，用於判斷 最小用戶端版本 檢查是否傳回 true (1) 或 false (0) 。 如果未啟用檢查，則此唯讀變數的值為空白。

_TS_CROSLANGUAGE

適用於 檢查整備 程度步驟。

目前 OS 檢查的語言 是傳回 True () ，還是傳回 false) (10 唯讀變數。 如果未啟用檢查，則此唯讀變數的值為空白。

_TS_CRACPOWER

適用於 檢查整備 程度步驟。

用於檢查 AC 電源 是否返回 true) 或 false (1) (0 返回 false 的唯讀變數。 如果未啟用檢查，則此唯讀變數的值為空白。

_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：啟用 NetBIOS over TCP/IP
  • 2：停用 NetBIOS over TCP/IP

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 毫秒) 。 例如，指定值 45000，重試延遲為 45 秒。

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] 步驟不是為金鑰管理選項僅在 USB 上啟動金鑰產生隨機啟動金鑰，而是使用信賴平台模組 (TPM) 做為啟動金鑰。 該值必須是有效的 256 位元 Base64 編碼的 BitLocker 啟動金鑰。

OSDCaptureAccount

適用於 Capture OS Image 步驟。

(輸入)

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

如需擷取作業系統映像帳戶的詳細資訊，請參閱 帳戶。

OSDCaptureAccountPassword

適用於 Capture OS Image 步驟。

(輸入)

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

OSDCaptureDestination

適用於 Capture OS Image 步驟。

(輸入)

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

OSDComputerName (輸入)

適用於 套用 Windows 設定 步驟。

指定目的地電腦的名稱。

範例

%_SMSTSMachineName% (預設)

OSDComputerName (輸出)

適用於 Capture Windows 設定步驟。

設定為電腦的 NetBIOS 名稱。 只有在 OSDMigrateComputerName 變數設定為 true時，才會設定該值。

OSDConfigFileName

適用於套用 作業系統映像 步驟。

(輸入)

指定與作業系統部署映像套件相關聯之作業系統部署回應檔案的檔案名稱。

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

OSDDoNotLog命令

適用於 安裝套件 和 執行命令列 步驟。

(輸入)

若要防止顯示或記錄潛在的敏感性資料，請將此變數設定為 TRUE。 此變數會在「安裝套件」步驟期間遮罩smsts.log中的程式名稱。

當您將此變數設定為 TRUE時，也會在記錄檔中隱藏記錄檔中 [ 執行命令列 ] 步驟的命令列。

OSDEnableTCPIPFiltering

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

(輸入)

指定是否啟用 TCP/IP 篩選。

有效值

  • true
  • false (預設)

OSDGPTBootDisk

適用於格式 化和磁碟分割 步驟。

(輸入)

指定是否要在 GPT 硬碟上建立 EFI 磁碟分割。 EFI 型電腦會使用此磁碟分割做為啟動磁碟。

有效值

  • true
  • false (預設)

OSDImageCreator

適用於 Capture OS Image 步驟。

(輸入)

建立映像的使用者選擇性名稱。 此名稱會儲存在 WIM 檔案中。 使用者名稱最長可為 255 個字元。

OSDImageDescription

適用於 Capture OS Image 步驟。

(輸入)

擷取之作業系統映像的選用使用者定義描述。 此描述會儲存在 WIM 檔案中。 說明的最大長度為 255 個字元。

OSDImageIndex

適用於套用 作業系統映像 步驟。

(輸入)

指定套用至目的地電腦的 WIM 檔案影像索引值。

OSDImageVersion

適用於 Capture OS Image 步驟。

(輸入)

指派給擷取作業系統映像的選用使用者定義版本號碼。 此版本號碼會儲存在 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

適用於為Capture準備 Windows 步驟。

(輸入)

指定 sysprep 是保留還是重設產品啟用旗標。

有效值

  • true：保留啟用旗標
  • false (預設) ：重設啟用旗標

OsdLayeredDriver

從版本 2107 開始

適用於套用 作業系統映像 步驟

指定要與 Windows 一起安裝的多層驅動程式的整數值。 如需詳細資訊，請參閱 LayeredDriver Windows 設定。

OsdLayeredDriver 的有效值

值 鍵盤驅動程式
0 請勿指定 (預設)
1 PC/AT 增強型鍵盤 (101/102 鍵)
2 韓文 PC/AT 101 鍵相容鍵盤或 Microsoft Natural 鍵盤 (類型 1)
3 韓文 PC/AT 101 鍵相容鍵盤或 Microsoft Natural 鍵盤 (類型 2)
4 韓文 PC/AT 101 鍵相容鍵盤或 Microsoft Natural 鍵盤 (Type 3)
5 韓文鍵盤 (103/106 鍵)
6 日文鍵盤 (106/109 鍵)

OSDLocalAdminPassword

適用於 套用 Windows 設定 步驟。

(輸入)

指定本機系統管理員帳戶密碼。 如果您啟用 隨機產生本機系統管理員密碼的選項，並在所有支援的平台上停用帳戶，則該步驟會忽略此變數。 指定的值必須介於 1 到 255 個字元之間。

OSDLogPowerShellParameters

適用於 執行 PowerShell 指令碼 步驟。

(輸入)

為了防止記錄潛在的敏感性資料，[ 執行 PowerShell 指令碼 ] 步驟不會在 smsts.log 檔案中記錄指令碼參數。 若要在工作順序記錄檔中包含指令碼參數，請將此變數設定為 TRUE。

OSDMigrateAdapterSettings

適用於 Capture Network Settings 步驟。

(輸入)

指定工作順序是否擷取網路介面卡資訊。 此資訊包括 TCP/IP 和 DNS 的組態設定。

有效值

  • true (預設)
  • false

OSDMigrateAdditionalCaptureOptions

適用於 Capture User State 步驟。

(輸入)

為工作順序用來擷取使用者狀態的使用者狀態移轉工具 (USMT) 指定其他命令列選項。 此步驟不會在工作順序編輯器中公開這些設定。 將這些選項指定為字串，工作順序會附加到自動產生的 ScanState USMT 命令列。

在此工作順序變數所指定的 USMT 選項在執行工作順序之前，不會驗證其正確性。

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

OSDMigrateAdditionalRestoreOptions

適用於 還原使用者狀態步驟 。

(輸入)

指定工作順序在還原使用者狀態時所使用的使用者狀態移轉工具 (USMT) 的其他命令列選項。 將其他選項指定為字串，工作順序會附加到自動產生的 LoadState USMT 命令列。

在此工作順序變數所指定的 USMT 選項在執行工作順序之前，不會驗證其正確性。

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

OSDMigrateComputerName

適用於 Capture Windows 設定步驟。

(輸入)

指定是否移轉電腦名稱。

有效值

OSDMigrateConfigFiles

適用於 Capture User State 步驟。

(輸入)

指定用來控制使用者設定檔擷取的組態檔。 只有當 OSDMigrateMode 設定為 Advanced時，才會使用此變數。 此逗點分隔清單值是設定為執行自訂的使用者設定檔移轉。

範例

miguser.xml,migsys.xml,migapps.xml

OSDMigrateContinueOnLockedFiles

適用於 Capture User State 步驟。

(輸入)

如果 USMT 無法擷取某些檔案，此變數會允許使用者狀態擷取繼續進行。

有效值

  • true (預設)
  • false

OSDMigrateContinueOnRestore

適用於 還原使用者狀態步驟 。

(輸入)

即使 USMT 無法還原某些檔案，仍請繼續此程序。

有效值

  • true (預設)
  • false

OSDMigrateEnableVerboseLogging

適用於下列步驟：

(輸入)

為 USMT 啟用詳細記錄。 該步驟需要此值。

有效值

  • true
  • false (預設)

OSDMigrateLocalAccounts

適用於 還原使用者狀態步驟 。

(輸入)

指定是否還原本機電腦帳戶。

有效值

  • true
  • false (預設)

OSDMigrateLocalAccountPassword

適用於 還原使用者狀態步驟 。

(輸入)

如果 OSDMigrateLocalAccounts 變數為 true，此變數必須包含指派給 所有 已移轉本機帳戶的密碼。 USMT 會將相同的密碼指派給所有移轉的本機帳戶。 請將此密碼視為暫時密碼，稍後再以其他方法變更。

OSDMigrateMode

適用於 Capture User State 步驟。

(輸入)

允許您自訂 USMT 擷取的檔案。

有效值

  • Simple： 工作順序僅使用標準 USMT 設定檔

  • Advanced：工作順序變數 OSDMigrateConfigFiles 會指定 USMT 使用的設定檔案

OSDMigrateNetworkMembership

適用於 Capture Network Settings 步驟。

(輸入)

指定工作順序是否移轉工作群組或網域成員資格資訊。

有效值

  • true (預設)
  • false

OSDMigrateRegistrationInfo

適用於 Capture Windows 設定步驟。

(輸入)

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

有效值

OSDMigrateSkipEncryptedFiles

適用於 Capture User State 步驟。

(輸入)

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

有效值

  • true
  • false (預設)

OSDMigrateTimeZone

適用於 Capture Windows 設定步驟。

(輸入)

指定是否移轉電腦時區。

有效值

  • true (預設) 。 輸出) 的變數 OSDTimeZone ( 設定為電腦的時區。
  • false

OSDNetworkJoinType

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

(輸入)

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

值

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

OSDPartitions

適用於格式 化和磁碟分割 步驟。

(輸入)

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

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

OSDPartitions0Type

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

OSDPartitions0FileSystem

指定格式化磁碟分割時要使用的檔案系統類型。 此屬性是選擇性的。 如果您未指定檔案系統，此步驟不會格式化磁碟分割。 有效值為 FAT32 和 NTFS。

OSDPartitions0Bootable

指定磁碟分割是否可開機。 此為必要屬性。 如果此值設定為 TRUE 針對 MBR 磁碟，則步驟會將此磁碟分割標記為使用中。

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

(輸入)

為新作業系統中的本機系統管理員帳戶指定隨機產生的密碼。

有效值

  • true (預設) ：Windows 安裝程式停用目標電腦上的本機系統管理員帳戶

  • false： Windows 安裝程式會啟用目標電腦上的本機系統管理員帳戶，並將帳戶密碼設定為 OSDLocalAdminPassword 的值

OSDRecoveryKeyPollingFrequency

適用於啟用 BitLocker 步驟。

適用於版本 2203 及更新版本。

BitLocker 動作會輪詢網站資料庫以尋找復原金鑰委付狀態的頻率，以秒為單位。 最小值為 15 秒。 預設值為 300 秒 (5 分鐘) 。

OSDRecoveryKeyPollingTimeout

適用於啟用 BitLocker 步驟。

適用於版本 2203 及更新版本。

BitLocker 動作等候修復金鑰附帶至網站資料庫的最大秒數。 最小值為 30 秒。 預設值為 1800 秒 (30 分鐘) 。

OSDRegisteredOrgName (輸入)

適用於 套用 Windows 設定 步驟。

指定新作業系統中預設的已登錄組織名稱。 指定的值必須介於 1 到 255 個字元之間。

OSDRegisteredOrgName (輸出)

適用於 Capture Windows 設定步驟。

設定為電腦的已登錄組織名稱。 只有在 OSDMigrateRegistrationInfo 變數設定為 true時，才會設定該值。

OSDRegisteredUserName

適用於 套用 Windows 設定 步驟。

(輸入)

指定新作業系統中預設的登錄使用者名稱。 指定的值必須介於 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

適用於套用 作業系統映像 步驟。

(輸出)

指定套用映像之後，包含作業系統檔案的磁碟分割磁碟機代號。

OSDTargetSystemRoot (輸入)

適用於 Capture OS Image 步驟。

指定參照電腦上已安裝作業系統的 Windows 目錄路徑。 工作順序會驗證它是 Configuration Manager 擷取的支援作業系統。

OSDTargetSystemRoot (輸出)

適用於為Capture準備 Windows 步驟。

指定參照電腦上已安裝作業系統的 Windows 目錄路徑。 工作順序會驗證它是 Configuration Manager 擷取的支援作業系統。

OSDTimeZone (輸入)

適用於 套用 Windows 設定 步驟。

指定新作業系統中使用的預設時區設定。

將此變數的值設定為時區的語言不變名稱。 例如，在下列登錄機碼下的時區值中使用 Std 字串： HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones。

OSDTimeZone (輸出)

適用於 Capture Windows 設定步驟。

設定為電腦的時區。 只有在 OSDMigrateTimeZone 變數設定為 true時，才會設定該值。

OSDWindowsSettingsInputLocale

適用於 套用 Windows 設定 步驟。

指定新作業系統中使用的預設輸入地區設定。

如需 Windows 安裝程式回應檔案值的詳細資訊，請參閱 Microsoft-Windows-International-Core - InputLocale。

OSDWindowsSettingsSystemLocale

適用於 套用 Windows 設定 步驟。

指定新作業系統中使用的預設系統地區設定。

如需 Windows 安裝程式回應檔案值的詳細資訊，請參閱 Microsoft-Windows-International-Core - SystemLocale。

OSDWindowsSettingsUILanguage

適用於 套用 Windows 設定 步驟。

指定新作業系統中使用的預設使用者介面語言設定。

如需 Windows 安裝程式回應檔案值的詳細資訊，請參閱 Microsoft-Windows-International-Core - UILanguage。

OSDWindowsSettingsUILanguageFallback

適用於 套用 Windows 設定 步驟。

指定新作業系統中使用的後援使用者介面語言設定。

如需 Windows 安裝程式回應檔案值的詳細資訊，請參閱 Microsoft-Windows-International-Core - UILanguageFallback。

OSDWindowsSettingsUserLocale

適用於 套用 Windows 設定 步驟。

指定新作業系統中使用的預設使用者地區設定。

如需 Windows 安裝程式回應檔案值的詳細資訊，請參閱 Microsoft-Windows-International-Core - UserLocale。

OSDWipeDestinationPartition

適用於套用 資料影像 步驟。

(輸入)

指定是否要刪除位於目的地磁碟分割上的檔案。

有效值

  • true (預設)
  • false

OSDWorkgroupName

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

(輸入)

指定目的地電腦加入的工作群組名稱。

指定此變數或 OSDDomainName 變數。 工作群組名稱最多可以有 32 個字元。

SetupCompletePause

適用於升級 作業系統 步驟。

使用此變數來解決當 Windows 安裝完成時，高效能裝置上 Window 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 中的 prestart 命令來設定此變數。

SMSTSAssignmentsDownloadRetry

第一次嘗試找不到任何原則之後，用戶端嘗試下載原則的次數。 預設情況下，用戶端重試 0 次。

您可以使用媒體或 PXE 中的 prestart 命令來設定此變數。

SMSTSAssignUsersMode

指定工作順序如何將使用者與目的地電腦建立關聯。 將變數設定為下列其中一個值：

  • 自動：當工作順序將作業系統部署到目的地電腦時，它會在指定的使用者與目的地電腦之間建立關聯。

  • 擱置中： 工作順序會在指定的使用者與目的地電腦之間建立關聯。 必須管理員核准關聯才能進行設定。

  • 已停用：工作順序在部署作業系統時不會將使用者與目的地電腦建立關聯。

注意事項

設定 SMSTSAssignUsersMode 變數時，指定的值必須與啟用 PXE 的 DP、開機媒體或用於映像的預暫存媒體上的設定相符。

如果值不相符，則不會設定裝置親和性。

如需詳細資訊，請參閱在 Configuration Manager 中將使用者與目的地電腦建立關聯。

SMSTSDisableStatusRetry

在斷開連線的情況下，工作順序引擎會重複嘗試將狀態訊息傳送至管理點。 此案例中的行為會導致工作順序處理延遲。

將此變數 true 設為，工作順序引擎就不會在第一則訊息無法傳送後嘗試傳送狀態訊息。 第一次嘗試包含多次重試。

當工作順序重新啟動時，此變數的值會持續存在。 不過，工作順序會嘗試傳送初始狀態訊息。 第一次嘗試包含多次重試。 如果成功，則工作順序會繼續傳送狀態，而無論此變數的值為何。 如果狀態無法傳送，工作順序會使用此變數的值。

注意事項

工作順序狀態報告 仰賴這些狀態訊息，以顯示每個步驟的進度、歷程記錄及詳細資料。 如果狀態訊息無法傳送，則不會放入佇列。 當連線還原至管理點時，稍後不會傳送。 此行為會導致工作順序狀態報告不完整且缺少項目。

SMSTSDisableWow64Redirection

適用於 執行命令列 步驟。

(輸入)

根據預設，在 64 位元 OS 上，工作順序會使用 WOW64 檔案系統重新導向程式，在命令列中尋找並執行程式。 此行為可讓命令尋找 32 位元版本的作業系統程式和 DLL。 將此變數設定為 true 停用 WOW64 檔案系統重新導向器的使用。 此命令可尋找原生 64 位元版本的作業系統程式和 DLL。 此變數在 32 位元作業系統上執行時沒有作用。

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 中的 prestart 命令設定此變數。 如果已設定此變數，則工作順序會覆寫任何必要的部署。

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：重新啟動至已安裝的作業系統
  • WinPE：重新啟動至相關聯的開機映像

SMSTSRetryRequested

要求在目前的工作順序步驟完成之後重試。 如果已設定此工作順序變數，也請設定 SMSTSRebootRequested 變數。 重新啟動電腦後，工作順序管理員會重新執行相同的工作順序步驟。

SMSTSRunCommandLineAsUser

適用於 執行命令列 步驟。

使用工作順序變數來設定 [執行命令列 ] 步驟的使用者內容。 您不需要使用預留位置帳戶設定 [ 執行命令列 ] 步驟，即可使用 SMSTSRunCommandLineUserName 和 SMSTSRunCommandLineUserPassword 變數。

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

  • true：任何進一步 的 [執行命令列 ] 步驟均在以下使用者 SMSTSRunCommandLineUserName的內容中執行。

  • false： 任何進一步 的 [執行命令列] 步驟，均會在您在步驟中設定的內容中執行。

SMSTSRunCommandLineUserName

適用於 執行命令列 步驟。

(輸入)

指定執行命令列的帳戶。 此值是本機帳戶的字串格式為 username，或網域帳戶的 domain\username。 使用 SMSTSRunCommandLineUserPassword 變數指定帳戶密碼。

注意事項

使用 SMSTSRunCommandLineAsUser 變數與此變數以設定此步驟的使用者內容。

如需任務序列執行身分帳戶的詳細資訊，請參閱 帳戶。

SMSTSRunCommandLineUserPassword

適用於 執行命令列 步驟。

(輸入)

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

SMSTSRunPowerShellAsUser

適用於 執行 PowerShell 指令碼 步驟。

使用工作順序變數來設定 執行 PowerShell 指令碼 步驟的使用者內容。 您不需要使用預留位置帳戶設定 執行 PowerShell 指令碼 步驟，即可使用 SMSTSRunPowerShellUserName 和 SMSTSRunPowerShellUserPassword 變數。

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

  • true：任何進一步 執行 PowerShell 指令碼 步驟，均在以下使用者的內容 SMSTSRunPowerShellUserName中執行。

  • false： 任何進一步 執行 PowerShell 指令碼 步驟，都會在您在步驟中設定的內容中執行。

SMSTSRunPowerShellUserName

適用於 執行 PowerShell 指令碼 步驟。

(輸入)

指定執行 PowerShell 指令碼的帳戶。 該值是 username 或 domain\username 格式的字串。 使用 SMSTSRunPowerShellUserPassword 變數指定帳戶密碼。

注意事項

若要使用這些變數，請設定 [執行 PowerShell 指令碼 ] 步驟，並將設定為 [以下列帳戶身分執行此步驟]。 啟用此選項時，如果您要使用變數設定使用者名稱和密碼，請為帳戶指定任何值。

如需任務序列執行身分帳戶的詳細資訊，請參閱 帳戶。

SMSTSRunPowerShellUserPassword

適用於 執行 PowerShell 指令碼 步驟。

(輸入)

指定由 SMSTSRunPowerShellUserName 變數所指定的帳戶密碼。

SMSTSSoftwareUpdateScanTimeout

適用於安裝軟體匯報步驟。

(輸入)

在此步驟中控制軟體更新掃描的逾時。 例如，如果您預期在掃描期間會有大量更新，請增加值。 預設值為 3600 秒 (60 分鐘) 。 變數值的設定是以秒為單位。

SMSTSUDA使用者

使用下列格式指定目的地電腦的主要使用者。 <DomainName>\<UserName> 以逗號 (,) 分隔多個使用者。 如需詳細資訊，請參閱 將使用者與目的地電腦建立關聯。

範例

contoso\jqpublic, contoso\megb, contoso\janedoh

SMSTSWaitCcmexecOperationalTimeout

(輸入)

使用此變數來控制工作順序等候 SMS 代理程式主機服務 (ccmexec) 完全啟動的逾時期間。 指定此值，單位秒為單位。 預設逾時期間為 30 分鐘或 1800 秒。

SMSTSWaitCcmexecOperationalTimeout 的範例

  • 1800 (預設) ：30 分鐘
  • 300：工作順序會等候五分鐘讓 ccmexec 啟動

SMSTSWaitForSecondReboot

適用於安裝軟體匯報步驟。

(輸入)

當安裝軟體更新工作觸發的軟體更新安裝需要重新啟動多次時，這個選用匯報變數可控制用戶端行為。 在 [安裝軟體匯報] 步驟之前設定此變數，以避免工作順序因為從軟體更新安裝重新啟動多次而失敗。

當單一 [安裝軟體匯報] 工作順序步驟安裝需要重新啟動多次才能完成安裝的軟體更新時，此變數非常有用。

設定 SMSTSWaitForSecondReboot 值（以秒為單位），以指定工作順序在此步驟暫停的時間長度，而電腦重新開機。 請允許足夠的時間，以防有多次重新啟動。 例如，如果您將 SMSTSWaitForSecondReboot 設為 600，工作順序會在重新啟動後暫停 10 分鐘，然後再執行其他步驟。

SMSTSWaitForSecondReboot 變數是用來搭配 [安裝軟體匯報] 工作，但也可以設定在工作順序中的任何位置，以便在 [安裝匯報] 工作以外的工作所起始的重新開機之後引入延遲。 因此，在「安裝軟體匯報」工作之前設定此變數時，建議您在「安裝軟體匯報」工作之後再次設定，並設定值0為 。 這會重設變數，並防止工作順序期間出現不必要的延遲。 如果工作順序中有多個 [安裝匯報] 工作，請在第一個 [安裝匯報] 工作之前將變數定義為想要的值，然後將其重設回0最後一個 [安裝匯報] 工作之後。

注意事項

此變數僅適用于部署作業系統的 OSD 工作順序。 它無法搭配未使用安裝程式視窗和 ConfigMgr 工作的任何工作順序使用，例如獨立工作順序或就地升級工作順序。

TSDebugMode

將此變數設定為 TRUE 部署工作順序的集合或電腦物件上。 任何設定此變數的裝置，都會將部署到它的任何工作順序置於偵錯模式。

如需詳細資訊，請參閱 偵錯工作順序。

TSDebugOnError

將此變數 TRUE 設定為，當工作順序傳回錯誤時，自動啟動 工作順序偵錯工具 。

使用以下方法設定此變數：

TSDisableProgressUI

使用此變數來控制工作順序向使用者顯示進度的時機。 若要在不同時間隱藏或顯示進度，請在工作順序中多次設定此變數。

  • true：隱藏工作順序進度

  • false：顯示工作順序進度

TSErrorOnWarning

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

(輸入)

指定工作順序引擎是否在此步驟中將偵測到的警告視為錯誤。 工作順序會將 _TSAppInstallStatus 變數 Warning 設定為當一或多個應用程式或必要的相依性未安裝時，因為它不符合需求。 當您將此變數設為 True，而工作順序將 _TSAppInstallStatus 設為 Warning時，結果為錯誤。 值 為 False 預設行為。

TSProgressInfoLevel

指定此變數以控制工作順序進度視窗顯示的資訊類型。 為此變數使用以下值：

  • 1： 在進度文字中包含目前的步驟和總步驟。 例如， 2 of 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

重要事項

此工作順序變數已被取代。

在作業系統部署期間，預設情況下，Windows 安裝程式會決定最適合使用的磁碟機代號 (通常是 C：) 。

先前的行為：套用映像時，OSDPreverveDriveLetter 變數會判斷工作順序是否使用映像檔中擷取的磁碟機代號 (WIM) 。 將此變數false的值設定為使用您在 [套用作業系統] 工作順序步驟中為 [目的地] 設定指定的位置。 如需詳細資訊，請參閱 套用作業系統映像。

另請參閱

  • Last updated on