Azure 自動化執行手冊類型

Azure 程序自動化功能支援數種類型的 Runbook，如下表所定義。

類型 描述
PowerShell
(建議)		 基於 Windows PowerShell 指令碼的文字型運作手冊。 目前支援的版本為 PowerShell 7.6、PowerShell 7.4 和 PowerShell 5.1。 由於 PowerShell 7.1 和 PowerShell 7.2 已不再被母產品 PowerShell 支援，請依長期支援版本（如 PowerShell 7.6 或 PowerShell 7.4）建立 runbook。
PowerShell 工作流程 以 Windows PowerShell 工作流程指令碼為基礎的文字式操作手冊。
Python（編程語言）
(建議)		 以 Python 腳本為基礎的文字式運行手冊。 目前支援的版本是 Python 3.10。 由於父產品 Python 不再支援 Python 2.7 和 Python 3.8，因此建議您在 Python 3.10 中建立 Runbook。
圖形化 圖形化 Runbook 是以 Windows PowerShell 為基礎，而且完全在 Azure 入口網站的圖形化編輯器中建立和編輯。
圖形化 PowerShell 工作流程 圖形化 Runbook 是以 Windows PowerShell 工作流程為基礎，而且完全在 Azure 入口網站的圖形化編輯器中建立和編輯。

若要了解流程自動化環境，請參閱 Azure 自動化中的 Runbook 執行。

附註

Azure 自動化 將依據母產品 PowerShell 與 Python 發布的時間軸，遵循 PowerShell 與 Python 版本的支援生命週期。 我們建議您搭配支援的語言版本使用 Runbook。

在決定要針對特定 Runbook 使用何種類型時，請考慮下列考量：

  • 您無法將 Runbook 從圖形化類型轉換為文字類型，反之亦然。
  • 使用不同類型的 Runbook 作為子 Runbook 時有所限制。 如需更多資訊，請參閱Azure 自動化中的子流程手冊。

PowerShell 運行手冊

PowerShell Runbook 以 Windows PowerShell 為基礎。 您可以直接使用 Azure 入口網站的文字編輯器來編輯 Runbook 的程式碼。 您也可以使用任何離線文字編輯器，並 匯入 Runbook 到 Azure 自動化。

PowerShell 版本是由指定的 運行時間版本 所決定。

相同的 Azure 沙箱和混合式 Runbook 背景工作角色可以並行執行多個以不同執行階段版本為目標的 PowerShell Runbook。 PowerShell 7.6 與 PowerShell 7.4 執行時版本在所有區域的雲端與混合工作均支援。

附註

  • 在執行 Runbook 時，如果您選取 [運行時間版本] 作為 7.4，則會使用以 7.4 運行時間版本為目標的 PowerShell 模組，而如果您選取 [運行時間版本] 作為 5.1，則會使用以 5.1 運行時間版本為目標的 PowerShell 模組。

請確定您為模組選取正確的 run-time 版本。

例如：如果您要在 運行時間7.4 版中執行 SharePoint 自動化案例的 Runbook，請在 運行時間版本 7.4 中匯入模組;如果您要在 運行時間5.1 版中執行 SharePoint 自動化案例的 Runbook，請在 運行時間5.1 版中匯入模組。

優點

  • 使用 PowerShell 程式碼實作所有複雜的邏輯，不必處理 PowerShell 工作流程的其他複雜性。
  • 啟動速度會比 PowerShell 工作流程 Runbook 更快，因為其在執行之前不需要編譯。
  • 在 Azure 中執行，以及在 Windows 和 Linux 的混合式 Runbook 工作角色上運行。

限制與已知問題

以下是 PowerShell Runbook 目前限制與已知的問題：

限制 PowerShell 7.6 可在 執行環境體驗中提供。

  • 在 PowerShell 7.6 執行版本中，匯入的模組活動不會被解壓。

  • PowerShell 7.x 不支援工作流程。 如需詳細資訊，請參閱 PowerShell工作流程。

  • PowerShell 7.x 目前不支援已簽署的執行手冊。

  • 原始碼控制整合不支援 PowerShell 7.6。 另外，PowerShell 7.6 的執行簿在原始碼控制中會以 Automation 帳號建立為執行時 5.1。

  • 預設安裝了 Az 模組 15.1.0。 一旦使用 Azure 入口網站或 API 再次設定 Az 版本，就會顯示所選 Az 模組版本的完整元件模組清單。

  • 匯入的 PowerShell 7.6 模組會在工作執行時進行驗證。 確定選取模組的所有相依性也會匯入，以成功執行作業。

  • Azure 自動化 runbook 不支援 -Credential 的 Start-Job。

  • Azure 不支援所有 PowerShell 輸入參數。 深入了解。 已知問題

  • 依賴內部檔案路徑的執行手冊（例如 C:\modules）可能會因服務後端基礎設施的變更而無法運作。 變更 Runbook 程式碼以確保沒有任何內部檔案路徑相依性，並使用 Get-ChildItem 來取得必要的模組資訊。

  • Get-AzStorageAccount Cmdlet 可能失敗並發生錯誤：在模組 Get-AzStorageAccount 中發現 Az.Storage 命令，但該模組無法載入。

  • 不支援使用 .\child-runbook.ps1 執行子指令碼。
    因應措施：使用 Start-AutomationRunbook（內部 cmdlet）或 Start-AzAutomationRunbook（從 Az.Automation 模組），從父指令碼啟動另一個指令碼。

  • 當您使用 ExchangeOnlineManagement 模組 3.0.0 版或更高版本時，可能會遇到錯誤。 若要解決此問題，請確定您已明確上傳 PowerShellGet 和 PackageManagement 模組。

  • 當您在 Az.Automation Module 中使用 New-AzAutomationVariable Cmdlet 來上傳類型為物件的變數時，作業不會如預期般運作。 因應措施：使用 ConvertTo-Json Cmdlet 將對象轉換成 JSON 字串，然後將變數與 JSON 字串作為其值上傳。 此因應措施可確保將 Azure 自動化環境內的變數適當處理為 JSON 字串。

    範例 - 建立一個 PowerShell 物件，儲存關於 Azure VM 的資訊

    azurepowershell

# Retrieve Azure virtual machines with status information for the 'northeurope' region 
$AzVM = Get-AzVM -Status | Where-Object {$_.Location -eq "northeurope"} 

$VMstopatch = @($AzVM).Id 

# Create an Azure Automation variable (This cmdlet will not fail, but the variable may not work as intended when used in the runbook.) 
New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $VMstopatch 

# Convert the object to a JSON string 
$jsonString = $VMstopatch | ConvertTo-Json 

# Create an Azure Automation variable with a JSON string value (works effectively within the automation runbook) 
New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $jsonString

PowerShell Workflow 執行手冊

PowerShell Workflow Runbook 是以 Windows PowerShell 工作流程為基礎的文字 Runbook。 您可以直接使用 Azure 入口網站的文字編輯器來編輯 Runbook 的程式碼。 您也可以使用任何離線文字編輯器，並 匯入 Runbook 到 Azure 自動化。

附註

PowerShell 7.1 (預覽版) 和 PowerShell 7.2 不支援工作流程執行手冊。

優點

  • 使用 PowerShell 工作流程程式碼實作所有複雜的邏輯。
  • 發生錯誤時，使用檢查點來繼續執行作業。
  • 使用平行處理來平行執行多個動作。
  • 可併入其他圖形化 Runbook 和 PowerShell 工作流程 Runbook 成為子 Runbook，以建立高階工作流程。

限制

  • PowerShell 7+ 版本中不支援 PowerShell 工作流程。 因此，無法升級過期的 Runbook。
  • 相較於較新的 PowerShell 7+ 版本，平行執行的處理效率不佳。
  • PowerShell 工作流程在內部使用多個程序運作。 因此，一個程序中可用的模組可能無法在另一個程序中使用，並導致找不到命令等例外狀況。
  • Runbook 必須處理 PowerShell 工作流程的其他複雜性，例如反序列化的物件。
  • Runbook 所需的啟動時間比 PowerShell Runbook 更久，因為其在執行之前必須進行編譯。
  • 您只能使用 Start-AzAutomationRunbook Cmdlet，將 PowerShell runbook 包含為子 runbook。
  • Runbook 無法在 Linux 混合式 Runbook Worker 上執行。

Python Runbook

Python Runbook 會在 Python 3.10 下編譯。 您可以直接使用 Azure 入口網站的文字編輯器來編輯 Runbook 的程式碼。 您也可以使用離線文字編輯器，並匯入 Runbook 到 Azure 自動化。 父產品不再支援 Python 2.7 和 Python 3.8，建議您在 Python 3.10 運行時間版本中建立 Runbook。

Python 3.10 執行時版本在所有區域的雲端與混合工作均支援。

優點

附註

匯入 Python 套件可能需要幾分鐘的時間。

  • 使用強固的 Python 程式庫。
  • 可以在 Azure 中或在混合式 Runbook 背景工作角色上執行。
  • 如果程式碼與不同版本相容，來自任何 3.x 版本的指令碼和套件可能得以運作。
  • 針對 Windows 機器上的 Python 3.10 混合式作業，您可以選擇安裝您想要使用的任何 3.x 版本。
  • 針對 Linux 電腦上的 Python 3.10 混合式作業工作，我們依賴電腦上安裝的 Python 3 版本來執行 DSC OMSConfig 和 Linux 混合式工作代理程式。 如果 Python 3 版本之間未發生方法簽章或合約的重大變更，則不同的版本應該得以運作。

限制

Python Runbook 的限制如下：

  • 針對 Python 3.10 模組，目前僅支援以 cp310 Linux OS 為目標的轉輪檔案。 深入了解
  • 不支援原始程式碼控制整合。
  • Python 3.10 的自定義套件只會在作業運行時間期間進行驗證。 如果套件在執行階段中不相容，或套件的必要相依性未匯入自動化帳戶，則預期作業會失敗。
  • 目前，只有 Azure 入口網站和 Rest API 才支援 Python 3.10 Runbook。

附註

不支援使用 Webhook 來啟動 Python Runbook。

多個 Python 版本

適用於 Windows 混合式員工。 針對 Windows Runbook 背景工作角色，在執行 Python 2 Runbook 時，會先尋找環境變數 PYTHON_2_PATH，並驗證此變數是否指向有效的可執行檔。 例如，如果安裝資料夾是 C:\Python2，此變數會檢查 C:\Python2\python.exe 是否為有效的路徑。 如果找不到，則會尋找 PATH 環境變數以執行類似的檢查。

針對 Python 3，會先尋找 PYTHON_3_PATH env 變數，然後再回復至 PATH 環境變數。

僅使用一個版本的 Python 時，您可以將安裝路徑新增至 PATH 變數。 如果您想要在 Runbook 背景工作器上使用這兩個版本，請將 PYTHON_2_PATH 和 PYTHON_3_PATH 設定為這些版本模組的位置。

已知問題

針對雲端作業，Python 3.8 作業有時會失敗，並顯示例外狀況訊息 invalid interpreter executable path。 如果作業延遲、啟動超過 10 分鐘，或使用 Start-AutomationRunbook 啟動 Python 3.8 Runbook，您可能會看到此例外狀況。 如果作業延遲，重新啟動 runbook 可能有效。

圖形化 Runbook

您可以使用 Azure 入口網站中的圖形化編輯器，建立和編輯圖形化和圖形化 PowerShell 工作流程 Runbook。 不過，您無法使用另一個工具來建立或編輯這種類型的 Runbook。 圖形化操作手冊的主要功能：

  • 匯出至您自動化帳戶中的檔案，然後匯入至另一個自動化帳戶。
  • 產生 PowerShell 程式碼。
  • 在匯入期間轉換為圖形化 PowerShell 工作流程 Runbook，或從該 Runbook 進行轉換。

優點

  • 使用視覺化的插入連結設定撰寫模型。
  • 將焦點放在資料如何透過此程序來流動。
  • 以視覺方式呈現管理程序。
  • 包含其他 Runbook 做為子 Runbook 來建立高階工作流程。
  • 建議您採用模組化的程式設計。

限制

  • 無法在 Azure 入口網站外部建立或編輯。
  • 可能需要包含 PowerShell 程式碼的程式碼活動來執行複雜邏輯。
  • 無法轉換成其中一個文字格式，也無法將文字 Runbook 轉換成圖形格式。
  • 無法檢視或直接編輯圖形化工作流程所建立的 PowerShell 程式碼。 您可以檢視您在任何程式碼活動中所建立的程式碼。
  • 無法在 Linux 混合式 Runbook 背景工作角色上執行 Runbook。 請參閱使用混合式 Runbook 背景工作角色將資料中心或雲端中的資源自動化。
  • 無法以數位方式簽署圖形化 Runbook。

下一步

  • Last updated on