本文說明如何設定您的 Managed DevOps Pool 實例的進階設定。
概觀
要查看並設定你的池的進階設定，請在 Azure 入口網站中進入你的池，然後進入 「設定>進階」。
工作資料夾
Managed DevOps Pool 代理程式的預設工作資料夾通常是D:\a\_work（或C:\a\_work如果 VM 容量沒有D硬碟）是 Windows 代理或 /mnt/vss/_work Linux 代理，而你的管線可以透過Agent.WorkFolder參考工作資料夾。 設定 工作資料夾 設定，以取代池中每個代理程序映像的預設工作資料夾。
一個常見的情況是，當你有一個附加的資料磁碟時，想要把你的代理的Work folder設置在該磁碟上。 舉例來說，如果你有一個 Windows 代理映像檔，並附有一個指定為磁碟代號 F 的資料磁碟，你可以將 工作資料夾 設定為 F:\custom-work-folder，這樣所有使用該映像的代理程式就會將該資料磁碟上的指定資料夾作為它們的工作資料夾。 對於 Linux 代理程式，資料磁碟掛載為 /mnt/storage/sdc，因此若要使用附加資料磁碟上命名 custom-work-folder 的資料夾，請使用 /mnt/storage/sdc/custom-work-folder。
這很重要
工作資料夾設定適用於你池中所有代理。 如果你的池裡有多個映像，想為每個映像設定不同的工作資料夾，可以在管線中設定 WorkFolder 需求 ，針對不想使用池層 級 Work 資料夾 設定的映像檔。 管線層級的 WorkFolder 需求優先於 工作資料夾 池的設定。
不要為 Linux 代理指定 Windows 風格的工作資料夾。 如果你為 Linux 代理程式指定一個 Windows 風格的工作資料夾，例如 F:\custom-work-folder，Linux 代理程式會嘗試使用類似 mnt/vss/_workF:\custom-work-folder 的代理工作資料夾，但該資料夾會失敗。
如果你為 Windows 代理程式指定一個 Linux 風格的工作資料夾，例如 /mnt/storage/sdc/custom-work-folder，Windows 代理程式會在預設磁碟中使用這個資料夾，例如 D:\mnt\storage\sdc\custom-work-folder。
你可以在建立新池時，在進階標籤頁設定 Work 資料夾 的設定，或是進入現有池的 「設定>進階 」。
在 工作資料夾 設定中指定要使用的資料夾，然後選擇 套用 來儲存你的變更。 將設定留空白以使用默認的工作資料夾。
workfolder區段中的runtimeConfiguration屬性指定Work 資料夾的設定。
備註
runtimeConfiguration該區段與workFolder屬性自 API 版本2025-09-20開始提供。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [
{
"name": "fabrikam-managed-pool",
"type": "microsoft.devopsinfrastructure/pools",
"location": "eastus",
"tags": {},
"properties": {
...
"organizationProfile": {...},
"agentProfile": {...},
"fabricProfile": {...},
"runtimeConfiguration": {
"workFolder": "<your custom work folder>"
}
}
}
]
}
你可以透過呼叫workFolder，使用以下參數來設定這個值。
| 參數 |
Description |
--ids |
受控 DevOps 集區的資源識別碼。 |
--set |
要更新的屬性，在此情況下為 properties.runtimeConfiguration.workFolder。 |
az resource update \
--ids "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevOpsInfrastructure/pools/{poolName}" \
--set properties.runtimeConfiguration.workFolder="C:\\my-custom-work-folder"
要使用 Bicep 設定 Work 資料夾 的設定，請在 workFolder 區塊中新增 屬性。 以下範例中，池中的代理被設定為使用 D:\MyWorkFolder。
若要使用預設的代理工作資料夾，請省略該 runtimeConfiguration 區段或在建立或更新池池時指定空值 workFolder 。
備註
runtimeConfiguration該區段與workFolder屬性自 API 版本2025-09-20開始提供。
resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
name: 'MyManagedDevOpsPool'
...
properties: {
...
"organizationProfile": {...},
"agentProfile": {...},
"fabricProfile": {...},
"runtimeConfiguration": {
"workFolder": "<your custom work folder>"
}
}
}