Edit

Share via


Classic process parameters

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Note

Process parameters are only available in Classic pipelines. For parameters in YAML pipelines, see runtime parameters.

Process parameters are used in Classic pipelines and differ from variables in the types of input they support. Unlike variables, which only accept strings, process parameters support richer data types such as checkboxes and dropdown lists.

Process parameters are a list of essential settings that can be shared across all tasks in your pipeline definition. They act as central settings for the entire Classic pipeline, making it easy to update values without editing each task. Having these parameters in one location allows you to quickly edit these arguments without having to click through each task individually. Templates come with a set of predefined process parameters.

Note

Process parameters are not available in Classic release pipelines.

Prerequisites

Product Requirements
Azure DevOps - An Azure DevOps organization.
- An Azure DevOps project.
- A Classic pipeline.

Add new process parameters

Follow these steps to add new process parameters to your Classic pipeline:

  1. Sign in to your Azure DevOps organization, then navigate to your project.

  2. Select your Classic pipeline, then select Edit.

  3. Select Tasks, then under your agent job select the task whose setting you want to expose as a process parameter.

  4. Select the i icon next to the setting you want to include, then select Link in the pop‑up message.

    A screenshot displaying the info and link window to link a new process parameter in a classic pipeline.

  5. Configure your settings as needed, then select Link to add it to your process parameters. Your view may differ depending on the task and the setting you're configuring.

    A screenshot displaying how to link a new parameter in a classic pipeline.

  6. Once linked, you can find the parameter under Tasks > Pipeline > Parameters.

Configure existing process parameters

Follow these steps to configure existing process parameters in your Classic pipeline:

  1. Sign in to your Azure DevOps organization, then navigate to your project.

  2. Select your Classic pipeline, then select Edit.

  3. Select Tasks > Pipeline, then scroll down to Parameters. Your view may differ depending on your project type and the parameters defined for your tasks. Select the parameter you want to modify and configure it as needed.

    A screenshot displaying how to configure existing process parameters in a Classic pipeline.

Follow these steps to unlink single or all existing process parameters in your Classic pipeline:

  1. Sign in to your Azure DevOps organization, then navigate to your project.

  2. Select your Classic pipeline, then select Edit.

  3. Select the task that you want to unlink, select the link icon next to the parameter, and then select Unlink in the pop‑up message.

    A screenshot displaying how to unlink a single process parameter in a Classic pipeline.

  1. Sign in to your Azure DevOps organization, then navigate to your project.

  2. Select your Classic pipeline, then select Edit.

  3. Select Tasks > Pipeline, then scroll down to Parameters.

  4. Select Unlink all, then select Confirm to confirm your choice.

    A screenshot displaying how to unlink all process parameters in a Classic pipeline.