ManualValidation@0 - 手動驗證 v0 任務

使用此任務可暫停 YAML 管道運行以等待手動交互。

語法

# Manual validation v0
# Pause a pipeline run to wait for manual interaction. Works only with YAML pipelines.
- task: ManualValidation@0
  inputs:
    notifyUsers: # string. Required. Notify users. 
    #instructions: # string. Instructions. 
    #onTimeout: 'reject' # 'reject' | 'resume'. On timeout. Default: reject.

輸入

notifyUsers - 通知使用者
string。 必須的。

向特定使用者（或組）發送手動驗證待處理電子郵件。 只有具有佇列構建許可權的使用者才能執行手動驗證。 您可以使用語法 [org name]\group name 向組發送電子郵件。

此工作輸入是必要的，但如果您不想通知任何人，可以指定空字串，例如在測試回合期間：notifyUsers: ''。

instructions - 指示
string。

指定繼續或拒絕手動驗證時向用戶顯示的指示。 根據這些指示，使用者將會針對此手動驗證做出明智的決策。

onTimeout - 逾時
string。 允許的值：reject、resume。 預設值: reject。

在等待指定的逾時或 30 天之後，自動拒絕或繼續此手動驗證，無論早於哪一天。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。 如需詳細資訊，請參閱 控制項選項和一般工作屬性。

輸出變數

沒有。

備註

在 YAML 管線中使用這項工作，在階段內暫停執行。 這通常會執行以執行各種手動步驟或動作，然後繼續或拒絕執行。

這很重要

只有在 YAML 管線中才支援這項工作，而且只能在 YAML 管線的 無代理程式作業 中使用。

手動驗證 工作可讓您在階段內暫停管線執行，通常是執行一些手動步驟或動作，然後繼續進行管線。 例如，使用者可能需要在管線開始長時間執行計算密集作業之前，手動驗證特定部署組態。

手動驗證 工作組態包含 指示 參數，用來提供相關信息，或指定使用者在暫停期間執行的手動步驟。 您可以設定工作在等候檢閱時傳送電子郵件通知給使用者和使用者群組，並在可設定的逾時發生后指定自動回應（拒絕或繼續）。

您可以使用選擇性的 timeoutInMinutes 參數來指定工作的逾時值，一般工作屬性。

備註

若要讓工作完全執行，包含此工作之作業（timeoutInMinutes）的 default = 60 minutes 值應該高於工作本身的 timeoutInMinutes 值。 請參閱預設作業逾時值。

小提示

您可以使用變數在 notifyUsers 參數中指定電子郵件位址。

在管線期間啟動手動驗證工作時，會顯示訊息列，其中包含開啟 [手動驗證] 對話框的連結，其中包含指示。 執行手動步驟之後，系統管理員或使用者可以選擇繼續執行或拒絕執行。 具有 佇列組建 管線許可權的使用者可以繼續或拒絕執行。

範例

  jobs:
  - job: waitForValidation
    displayName: Wait for external validation
    pool: server
    timeoutInMinutes: 4320 # job times out in 3 days
    steps:
    - task: ManualValidation@0
      timeoutInMinutes: 1440 # task times out in 1 day
      inputs:
        notifyUsers: |
          test@test.com
          example@example.com
        instructions: 'Please validate the build configuration and resume'
        onTimeout: 'resume'

此範例會使用 ，這是所有工作 通用工作屬性。

需求

要求	說明
管線類型	YAML，傳統組建
執行於	伺服器
要求	沒有
能力	此工作不符合作業中後續工作的任何需求。
命令限制	任意
Settable 變數	任意
代理程式版本	所有支援的代理程式版本。
工作類別	部署