在 Azure 自動化中透過 VS Code 製作 Runbook
本文會說明如何使用 Visual Studio 延伸模組來建立和管理 Runbook。
Azure 自動化會提供 VS Code 的新延伸模組，以建立和管理 Runbook。 使用此延伸模組，您可執行所有 Runbook 管理作業，例如建立及編輯 Runbook、觸發作業、追蹤最近的作業輸出、連結排程、資產管理和本機偵錯。
必要條件
- 具有有效訂用帳戶的 Azure 帳戶。 免費建立帳戶。
- Visual Studio Code \(英文\)。
- Runbook 所使用的 PowerShell 模組和 Python 封裝必須在本機機器上安裝，才能在本機上執行 Runbook。
受支援的作業系統
測試矩陣包含下列作業系統:
- 隨附 Windows PowerShell 5.1 和 PowerShell Core 7.2.7 的 Windows Server 2022
- 隨附 Windows PowerShell 5.1 和 PowerShell Core 7.2.7 的 Windows Server 2019
- 隨附 PowerShell Core 7.2.7 的 macOS 11
- 隨附 PowerShell Core 7.2.7 的 Ubuntu 20.04
注意
- 延伸模組應該在 VS Code 中的任何位置運作，且支援 PowerShell 7.2 或更高版本。 針對 Windows PowerShell，僅支援 5.1 版。
- PowerShell Core 6 已終止生命週期，且不受支援。
主要功能
- 簡易上線 – 您可以使用 Azure 帳戶以簡單且安全的方式登入。
- 多種語言 - 支援所有自動化執行階段堆疊，例如 PowerShell 5、PowerShell 7、Python 2 和 Python 3 Runbook。
- 支援性 - 支援在 Azure 和混合式背景工作角色中測試作業執行、發佈自動化作業和觸發作業。 您可以在本機執行 Runbook。
- 支援 Python 位置參數和 PowerShell 參數來觸發作業。
- Webhook 簡化 – 您可以建立 Webhook，以更簡單的方式透過 Webhook 啟動作業。 此外，支援將排程連結至 Runbook。
- 管理自動化資產 – 您可以針對資產執行建立、更新和刪除作業，包括憑證、變數、認證和連線。
- 檢視屬性 – 您可以檢視屬性，然後選取 [混合式背景工作角色群組] 來執行混合式作業，並檢視最近執行的 10 個作業。
- 在本機偵錯 - 您可以在本機偵錯 PowerShell 指令碼。
- Runbook 比較 - 您可以將本機 Runbook 與已發布的 Runbook 或草稿 Runbook 複本進行比較。
v1.0.8 的主要功能
本機目錄組態設定 - 您可以定義您要在本機儲存 Runbook 的工作目錄。
- 變更目錄: 基底路徑 - 當您重新開啟 Visual Studio Code 整合式開發環境時，請使用已變更的目錄路徑。 若要使用命令選擇區變更目錄，請使用 [Ctrl+Shift+P] -> 選取 [變更目錄]。 若要從延伸模組組態設定變更基底路徑，請選取左側活動列中的 [管理] 圖示，然後移至 [設定]> [延伸模組] > [Azure 自動化] >[目錄: 基底路徑]。
- 變更目錄: 資料夾結構 - 您可以將本機目錄資料夾結構從 vscodeAutomation/accHash 變更為 subscription/resourceGroup/automationAccount。 選取左側活動列中 [管理] 圖示，然後移至 [設定] > [延伸模組] > [Azure 自動化] > [目錄: 資料夾結構]。 您可以將預設組態設定從 vscodeAutomation/accHash 變更為 subscription/resourceGroupe/automationAccount 格式。
注意
如果您的自動化帳戶與來源控制整合，您可以提供 GitHub 存放庫的 Runbook 資料夾路徑作為目錄路徑。 例如: 將目錄變更為 C:\abc 會將 Runbook 儲存在 C:\abc\vscodeAutomation.. 或 C:\abc//subscriptionName//resourceGroupName//automationAccountName//runbookname.ps1。
Runbook 管理作業 - 您可以建立 Runbook、擷取草稿 Runbook、擷取已發佈 Runbook、在編輯器中開啟本機 Runbook、比較本機 Runbook 與已發佈或草稿 Runbook 複本、上傳為草稿、發布 Runbook，以及從自動化帳戶中刪除 Runbook。
Runbook 執行作業 - 您可以執行本機版本的自動化作業，例如啟動自動化作業、啟動自動化測試作業、檢視作業輸出，以及在偵錯模式中執行 PowerShell Runbook 的本機版本，讓您在指令碼中新增中斷點。
注意
目前，我們僅支援使用非加密資產的內部 Cmdlet，例如
Get-AutomationVariable。使用排程、資產和 Webhook - 您可以檢視排程的屬性、刪除排程、連結排程以將排程連結至 Runbook。
新增 Webhook - 您可以將 Webhook 新增至 Runbook。
更新資產的屬性 - 您可以建立、更新、檢視資產的屬性，例如憑證、連線、認證、變數和從延伸模組刪除資產。
限制
目前不支援下列功能:
- 建立新的排程。
- 在資產中新增憑證。
- 從延伸模組上傳模組 (PowerShell 和 Python) 套件。
- 將本機 Runbook 自動同步至 Azure 自動化帳戶。 您必須執行作業，才能 擷取 或 發佈 Runbook。
- 混合式背景工作角色群組的管理。
- 圖表化 Runbook 和工作流程。
- 針對 Python，我們不會提供任何偵錯選項。 建議您在 Python 指令碼中安裝任何偵錯工具延伸模組。
- 目前，我們僅支援本機執行中未加密的資產。
下一步
- 如需 Runbook 管理作業和測試 Runbook 和作業，請參閱 使用適用於 Visual Studio Code 的 Azure 自動化延伸模組