az pipelines variable

參考

備註

此參考是 Azure CLI azure-devops 延伸模組的一部分（2.30.0 版或更高版本）。擴充功能會在您第一次執行 az pipelines variable 命令時自動安裝。深入瞭解擴充功能。

管理管線變數。

命令

名稱	Description	類型	狀態
az pipelines variable create	將變數新增至管線。	擴充套件	GA
az pipelines variable delete	從管線中刪除變數。	擴充套件	GA
az pipelines variable list	列出管線中的變數。	擴充套件	GA
az pipelines variable update	更新管線中的變數。	擴充套件	GA

az pipelines variable create

將變數新增至管線。

az pipelines variable create --name
                             [--allow-override {false, true}]
                             [--detect {false, true}]
                             [--org]
                             [--pipeline-id]
                             [--pipeline-name]
                             [--project]
                             [--secret {false, true}]
                             [--value]

必要參數

--name

變數的名稱。

選擇性參數

--allow-override

指出值是否可以在佇列時間設定。

接受的值: false, true

--detect

自動偵測組織。

接受的值: false, true

--org --organization

Azure DevOps 組織 URL。您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。如果未設定為預設，或透過 git 組態挑選，則為必要專案。範例：https://dev.azure.com/MyOrganizationName/。

--pipeline-id

管線的標識碼。

--pipeline-name

管線的名稱。如果提供 --pipeline-id 參數，則會忽略。

--project -p

項目的名稱或識別碼。您可以使用 az devops configure -d project=NAME_OR_ID 來設定預設專案。如果未設定為預設，或未透過 git config 自動取得，則為必要。

--secret

指出變數的值是否為秘密。

接受的值: false, true

--value

變數的值。針對秘密變數，如果未指定 --value 參數，則會從前面加上 AZURE_DEVOPS_EXT_PIPELINE_VAR_ 的環境變數中挑選，否則系統會提示使用者透過標準輸入輸入。例如，名為 MySecret 的變數可以使用環境變數AZURE_DEVOPS_EXT_PIPELINE_VAR_MySecret來輸入。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

az pipelines variable delete

從管線中刪除變數。

az pipelines variable delete --name
                             [--detect {false, true}]
                             [--org]
                             [--pipeline-id]
                             [--pipeline-name]
                             [--project]
                             [--yes]

必要參數

--name

要刪除的變數名稱。

選擇性參數

--detect

自動偵測組織。

接受的值: false, true

--org --organization

--pipeline-id

管線的標識碼。

--pipeline-name

管線的名稱。

--project -p

項目的名稱或識別碼。您可以使用 az devops configure -d project=NAME_OR_ID 來設定預設專案。如果未設定為預設，或未透過 git config 自動取得，則為必要。

--yes -y

請勿提示確認。

預設值: False

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

az pipelines variable list

列出管線中的變數。

az pipelines variable list [--detect {false, true}]
                           [--org]
                           [--pipeline-id]
                           [--pipeline-name]
                           [--project]

選擇性參數

--detect

自動偵測組織。

接受的值: false, true

--org --organization

--pipeline-id

管線的標識碼。

--pipeline-name

管線的名稱。如果提供 --pipeline-id 參數，則會忽略。

--project -p

項目的名稱或識別碼。您可以使用 az devops configure -d project=NAME_OR_ID 來設定預設專案。如果未設定為預設，或未透過 git config 自動取得，則為必要。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

az pipelines variable update

更新管線中的變數。

az pipelines variable update --name
                             [--allow-override {false, true}]
                             [--detect {false, true}]
                             [--new-name]
                             [--org]
                             [--pipeline-id]
                             [--pipeline-name]
                             [--project]
                             [--prompt-value {false, true}]
                             [--secret {false, true}]
                             [--value]

必要參數

--name

變數的名稱。

選擇性參數

--allow-override

指出值是否可以在佇列時間設定。

接受的值: false, true

--detect

自動偵測組織。

接受的值: false, true

--new-name

變數的新名稱。

--org --organization

--pipeline-id

管線的標識碼。

--pipeline-name

管線的名稱。如果提供 --pipeline-id 參數，則會忽略。

--project -p

項目的名稱或識別碼。您可以使用 az devops configure -d project=NAME_OR_ID 來設定預設專案。如果未設定為預設，或未透過 git config 自動取得，則為必要。

--prompt-value

將它設定為 True，以使用環境變數或透過標準輸入提示來更新秘密變數的值。

接受的值: false, true

--secret

如果變數的值是秘密，則為。

接受的值: false, true

--value

變數的新值。針對秘密變數，請使用 --prompt-value 參數，提示其透過標準輸入輸入。針對非互動式控制台，可以從前面加上 AZURE_DEVOPS_EXT_PIPELINE_VAR_的環境變數中挑選，例如，名為的變數 MySecret 可以使用環境變數AZURE_DEVOPS_EXT_PIPELINE_VAR_MySecret來輸入。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

共用方式為

az pipelines variable

命令

az pipelines variable create

必要參數

選擇性參數

az pipelines variable delete

必要參數

選擇性參數

az pipelines variable list

選擇性參數

az pipelines variable update

必要參數

選擇性參數

其他資源