進程參數

發行項
02/23/2023

Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019 |TFS 2018

注意

本指導方針不適用於 YAML 管線。如需 YAML 管線中的參數，請參閱執行時間參數。

程式參數會用於傳統管線中，而且與變數在支援的輸入類型不同。除了字串輸入之外，變數只會接受字串輸入，同時處理參數支援更多資料類型，例如核取方塊和下拉式清單方塊。

您可以將建置定義中用來工作的所有重要引數連結為進程參數，然後顯示在一個位置 - 管線檢視。這表示您可以快速編輯這些引數，而不需要按一下所有工作。

範本隨附一組預先定義的進程參數。

注意

[連結] 和 [取消連結] 功能僅適用于建置管線。它不適用於發行管線。

若要將所有工作中的更多引數連結至新的或現有的進程參數，請從工作引數中選取 [連結 ]。

若要設定進程參數，請編輯管線並移至 [工作>管線]。

將參數新增至傳統工作的螢幕擷取畫面。

從組建管線中的範本設定進程參數

您可以從建置管線中的工作輸入建立進程參數。如果您在多個工作中會有相同的輸入值，進程參數就很有用。您可以將所有工作之間的更多引數連結至新的或現有的進程參數。

顯示工作的圖解

若要連結進程參數：

選取屬於工作輸入欄位一部分的 i 圖示。
在開啟的視窗中，選取 [ 連結]。
設定 連結設定。您可以設定新的 顯示名稱 ，以便稍後識別進程參數。
您現在可以選擇在重複使用相同的工作時連結進程參數。若要連結進程參數，請選取 i 圖示，然後按一下 [ 連結]。
將 Process 參數設定為連結至此設定 ，以參考您現有的進程參數，然後選取 [ 連結]。

如果您需要中斷引數與進程參數的連接，請選取 [取消連結 ]。

您也可以從進程參數取消連結引數。

選取連結圖示。
選擇 [ 取消連結 ] 選項。在此範例中 Parameter.solution ，進程參數是未連結的。

取消連結引數。

定義新的進程參數

您可以使用管線的定義來定義新的進程參數 json 。

從 [ 組建定義 ] 頁面匯出現有的範本。

在文字編輯器中開啟 JSON。在檔案的 process 參數區段中新增輸入。如果您有現有的進程參數，您可以複製其中一個參數。例如，這是以 msBuildArgs 參數為基礎的新參數定義。

    {
            "aliases":[

            ],
            "options":{

            },
            "properties":{

            },
            "name":"myNewParam",
            "label":"MyProcessParam",
            "defaultValue":"/p:DeployOnBuild=true /p:WebPublishMethod=Package /p:PackageAsSingleFile=true /p:SkipInvalidConfigurations=true /p:PackageLocation=\"$(build.artifactstagingdirectory)\\\\\"",
            "type":"string",
            "helpMarkDown":"Additional arguments for process parameters.",
            "visibleRule":"",
            "groupName":""
        }

針對您想要使用它的任何工作，新增新參數做為輸入值。例如，這裡的新值為 msbuildArgsmyNewParam 。

    "inputs":{
                    "solution":"$(Parameters.solution)",
                    "vsVersion":"latest",
                    "msbuildArgs":"$(Parameters.myNewParam)",
                    "platform":"$(BuildPlatform)",
                    "configuration":"$(BuildConfiguration)",
                    "clean":"false",
                    "maximumCpuCount":"false",
                    "restoreNugetPackages":"false",
                    "msbuildArchitecture":"x86",
                    "logProjectEvents":"true",
                    "createLogFile":"false"
                }

返回 [ 組建定義] 頁面，然後選取 [ 匯入]。
新增檔案 json 並匯入管線。
在匯入的管線內，您現在可以選擇連結至新的進程參數。您可能需要取消連結，然後再連結一次，進程參數才會出現。

進程參數

從組建管線中的範本設定進程參數

定義新的進程參數

其他資源

其他資源