TaskAddParameter 類別

display_name

str

顯示名稱不一定是唯一的，而且可以包含最多 1024 個 Unicode 字元。

command_line

str

必要。 針對多重實例工作，命令列會在主要工作和所有子工作完成協調命令列之後，以主要工作的形式執行。 命令列不會在殼層下執行，因此無法利用環境變數擴充等殼層功能。 如果您想要利用這類功能，您應該在命令列中叫用殼層，例如在 Windows 中使用 「cmd /c MyCommand」 或 Linux 中的 「/bin/sh -c MyCommand」。 如果命令列參考檔案路徑，它應該使用相對於工作工作目錄) 的相對路徑 (，或使用 Batch 提供的環境變數 (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables) 。

container_settings

TaskContainerSettings

工作執行所在容器的設定。 如果執行此工作的集區已設定 containerConfiguration，也必須設定此設定。 如果執行此工作的集區未設定 containerConfiguration，則不得設定此設定。 當指定此專案時，節點) 上Azure Batch目錄根目錄AZ_BATCH_NODE_ROOT_DIR (遞迴地對應到容器、所有 Task 環境變數都會對應到容器中，而且工作命令列會在容器中執行。 在AZ_BATCH_NODE_ROOT_DIR外部容器中產生的檔案可能不會反映到主機磁片，這表示 Batch 檔案 API 將無法存取這些檔案。

exit_conditions

ExitConditions

Batch 服務在工作完成時應該如何回應。

resource_files

list[ResourceFile]

對於多重實例工作，資源檔只會下載到執行主要工作的計算節點。 資源檔案清單的大小上限。 超過大小上限時，要求將會失敗，而回應錯誤碼將會是 RequestEntityTooLarge。 如果發生這種情況，ResourceFiles 的集合必須縮小大小。 這可以使用 .zip 檔案、應用程式套件或 Docker 容器來達成。

output_files

list[OutputFile]

對於多實例工作，檔案只會從執行主要工作的計算節點上傳。

environment_settings

list[EnvironmentSetting]

affinity_info

AffinityInformation

Batch 服務可用來選取要啟動新工作的計算節點的地區提示。

constraints

TaskConstraints

套用至此工作的執行條件約束。 如果您未指定條件約束，maxTaskRetryCount 是針對 Job 指定的 maxTaskRetryCount、maxWallClockTime 為無限，且 retentionTime 為 7 天。

required_slots

int

工作執行所需的排程位置數目。 預設值是 1。 如果節點有足夠的可用排程位置，工作只能排程在計算節點上執行。 對於多重實例工作，這必須是 1。

user_identity

UserIdentity

工作執行所在的使用者身分識別。 如果省略，工作會以 Task 唯一的非系統管理使用者身分執行。

multi_instance_settings

MultiInstanceSettings

物件，指出 Task 是多實例工作，並包含如何執行多重實例工作的資訊。

depends_on

TaskDependencies

此工作相依的工作。 除非所有相依的工作都成功完成，否則不會排程此工作。 如果其中任何一個工作失敗並耗盡其重試計數，則永遠不會排程此工作。 如果作業沒有將 usesTaskDependencies 設定為 true，而且此元素存在，要求就會失敗，並出現錯誤碼 TaskDependenciesNotSpecifiedOnJob。

application_package_references

list[ApplicationPackageReference]

應用程式套件會下載並部署到共用目錄，而不是工作工作目錄。 因此，如果參考的套件已經在節點上，而且是最新的，則不會重新下載;會使用計算節點上的現有複本。 如果無法安裝參考的套件，例如因為套件已刪除，或因為下載失敗，所以工作會失敗。

authentication_token_settings

AuthenticationTokenSettings

工作可用來執行 Batch 服務作業的驗證權杖設定。 如果已設定這個屬性，Batch 服務會提供一個驗證權杖，可用來驗證 Batch 服務作業，而不需要帳戶存取金鑰。 權杖是透過AZ_BATCH_AUTHENTICATION_TOKEN環境變數提供。 工作可以使用權杖執行的作業取決於設定。 例如，工作可以要求 [作業] 許可權，以便將其他工作新增至作業，或檢查 [作業] 或 [作業] 下其他工作的狀態。