如何在執行中工作順序中使用工作順序變數 Configuration Manager 工作順序

發行項
01/06/2024

在 Configuration Manager 中，您可以使用工作順序環境 COM 自動化物件 Microsoft.SMS.TSEnvironment () ，在執行中的工作順序中建立、取得和設定工作順序變數。

一般而言，您會使用執行腳本的命令行動作來存取工作順序變數。但是，您也可以使用任何可使用 COM 自動化物件的程式設計環境，在執行中的工作順序中存取它們。

注意事項

當您在 Configuration Manager 客戶端上設定工作變數時，該變數會變成可供工作順序中的後續步驟使用。

若要建立自定義工作順序變數，您可以使用想要建立的新變數名稱來設定 Microsoft.SMS.TSEnvironment 屬性。如果變數不存在，則會加以建立。如果變數已經存在，則會更新其值。您稍後可以從 Microsoft.SMS.TSEnvironment取得自定義變數值。

當工作順序變數是陣列時，會以下列格式傳遞：

<base array name><element #><Property>="value".

例如，變數 OSDPartitions 是的陣列 SMS_TaskSequencePartitionSettings。下列範例代表一個元素 OSDPartitions Array：

OSDPartitions0Bootable="true"  
OSDPartitions0FileSystem="NTFS"  
OSDPartition0QuickFormat="false"  
OSDPartitions0Size="100"  
OSDPartitions0SizeUnits="Percent"  
OSDPartitions0Type="Primary"

若要在此陣列中存取 FileSystem ，您可以使用 OSDPartitions0FileSystem。如果陣列較大，您會使用OSDPartitions1FileSystem 作為第二個元素，依此類推透過陣列。

不建議您搭配工作排序環境使用 Managed 程式代碼，因為您無法在下列環境中使用它：

Windows PE
Windows Server 2008
Windows 2000

當已安裝正確版本的 .NET Framework 執行完整作業系統時，Managed 程式代碼會正常運作。

所需的 .NET Framework 版本取決於您使用的 Visual Studio 版本。

Visual Studio	.NET Framework 版本
Visual Studio 2003	1.0
Visual Studio 2005	2.0
Visual Studio 2008	2.0 至 3.5

您必須使用 COM Interop 來存取 TSEnvironment 物件。您將需要下列項目：

TSEnvironment 1.0 類型連結庫的參考。
TSEnvironmentLib 命名空間。

在執行中的工作順序中使用工作變數

在執行中的工作順序中，建立的實 Microsoft.SMS.TSEnvironment例。
取得或設定必要的環境變數。

範例

下列範例方法會取得 _SMSTSLogPath 變數。它也會設定自定義變數和數位自訂變數值的值。

如需呼叫範例程式代碼的相關信息，請參閱呼叫 Configuration Manager 代碼段。

Sub UseTaskSequenceVariables()  
   dim osd: set env = CreateObject("Microsoft.SMS.TSEnvironment")  
   dim logPath  

   ' You can query the environment to get an existing variable.  
   logPath = env("_SMSTSLogPath")  

    wscript.echo logPath   

   ' You can also set a variable in the Operating System Deployment environment.  
   env("MyCustomVariable") = "My Custom Value"  

   ' Set the OSDPartitions(0) Bootable array member to 0.  
    env("OSDPartitions0Bootable") = "true"  
End Sub

正在編譯程式碼

平台

操作系統部署工作排序環境

健全的程式設計

如需錯誤處理的詳細資訊，請參閱關於 Configuration Manager 錯誤。

.NET Framework 安全性

如需保護 Configuration Manager 應用程式的詳細資訊，請參閱 Configuration Manager 角色型系統管理。

另請參閱

物件概觀如何使用Managed程式代碼在 Configuration Manager 中聯機到SMS提供者
 如何使用 WMI 在 Configuration Manager 中連線到 SMS 提供者
 工作順序概觀如何設定操作系統部署工作順序變數

共用方式為