共用方式為


使用現有的 Runbook 和模組

您可以存取已由 Microsoft 和社群建置的案例,而不是在 Azure 自動化中建立您自己的 Runbook 和模組。 您可以從 Azure 入口網站的 Runbook 資源庫中取得與 Azure 相關的 PowerShell 和 Python Runbook,並從 PowerShell 資源庫中取得模組Runbook (可能非 Azure 專屬)。 您也可以藉由共用您開發的案例來參與社群。

注意

TechNet 指令碼中心即將淘汰。 Runbook 資源庫中指令碼中心的所有 Runbook 都已移至我們的自動化 GitHub 組織。如需詳細資訊,請參閱 Azure 自動化 Runbook 移至 GitHub

使用 Azure 入口網站從 GitHub 匯入 Runbook

注意

  • Azure 入口網站中的 [瀏覽資源庫] 選項已提升了使用者體驗。
  • 在 [處理自動化]> [Runbook] 刀鋒視窗中,您可以透過 [匯入 Runbook] 或 [瀏覽資源庫] 選項匯入 Runbook,而 [Runbook] 分頁會顯示兩個新的資料行 - [執行階段版本] 和 [Runbook 類型]
  1. 在 Azure 入口網站中,開啟自動化帳戶。

  2. 在 [程序自動化] 下方,選取 [Runbook] 刀鋒視窗。

  3. 按一下 [Runbook] 分頁中的 [匯入 Runbook]

    從匯入 Runbook 選項選取 Runbook 的螢幕擷取畫面。

  4. 在 [匯入 Runbook] 分頁中,您可以分別使用 [瀏覽檔案] 或 [從資源庫瀏覽],從 GitHub 匯入儲存在本機電腦上的檔案。

  5. 選取 檔案。

  6. 輸入 [名稱]、[執行階段版本] 和 [描述]

  7. 按一下 [匯入]

    從檔案或資源庫選取 Runbook 的螢幕擷取畫面。

  8. 也可以在 [Runbook] 分頁中選取 [瀏覽資源庫] 以瀏覽可用的 Runbook。

    從 Runbook 刀鋒視窗選取瀏覽資源庫選項的螢幕擷取畫面。

  9. 您可以使用清單上方的篩選準則,依發行者、類型和排序來縮小顯示範圍。 找出您想要的資源庫項目,並且選取以檢視其詳細資料。

    瀏覽 Runbook 資源庫。

  10. 按一下 [選取] 以選取所選的 Runbook。

  11. 在 [匯入 Runbook] 分頁中,輸入 [名稱],並選取 [執行階段版本]

  12. Runbook 類型描述會自動填入。

  13. 按一下 [匯入]

    資源庫項目匯入。

  14. Runbook 會出現在自動化帳戶的 [Runbook] 索引標籤上。

重要

您應該驗證任何取自 PowerShell 資源庫中的 Runbook 內容。 在實際執行環境中安裝和執行它們時,請特別小心。

PowerShell 資源庫提供各種來自 Microsoft 和社群的 Runbook,您可以將其匯入 Azure 自動化。 若要使用 Runbook,請從資源庫下載 Runbook,或者,您可以直接從資源庫匯入 Runbook, 或從 Azure 入口網站的自動化帳戶匯入。

注意

PowerShell 資源庫中不支援圖形化 Runbook。

若要直接從 PowerShell 資源庫匯入,您只能使用 Azure 入口網站。 您無法使用 PowerShell 執行此函式。 程序與透過 Azure 入口網站從 GitHub 匯入 Runbook 中所顯示的程序相同,不同之處在於來源會是 PowerShell 資源庫

顯示 Runbook 資源庫來源選取項目。

PowerShell 模組包含您可以在 Runbook 中使用的 Cmdlet。 PowerShell 資源庫中提供您可以安裝至 Azure 自動化的現有模組。 您可以從 Azure 入口網站啟動此資源庫,然後直接安裝模組至 Azure 自動化,也可以手動下載及安裝。

您也可以在 Azure 入口網站中找到要匯入的模組。 這些模組會列在您自動化帳戶 [共用資源] 下的 [模組] 中。

重要

請勿在任何專為 Az 模組執行的指令碼中包含關鍵字 "AzureRm"。 就算只是在註解中包含關鍵字,也可能導致 AzureRm 載入,然後與 Az 模組發生衝突。

下列清單包含一些支援常見案例的 Runbook。 如需 Azure 自動化小組建立的 Runbook 完整清單,請參閱 AzureAutomationTeam 設定檔

參與社群

我們強烈建議您參與並協助拓展 Azure 自動化社群。 與社群分享您建置的絕佳 Runbook。 感謝您的貢獻!

您可以使用此 GitHub 工作流程,將新的 PowerShell 或 Python Runbook 新增至 Runbook 資源庫。

  1. 在 GitHub 上建立公用存放庫,並新增 Runbook 和其他任何必要檔案 (例如 readme.md、描述等等)。

  2. 新增主題 azureautomationrunbookgallery,確保我們的服務能探索到存放庫,以便顯示在自動化 Runbook 資源庫中。

  3. 如果您建立的 Runbook 是 PowerShell 工作流程,請新增主題 PowerShellWorkflow。 如果是 Python 3 Runbook,請新增 Python3。 Azure Runbook 不需要其他特定主題,但建議您新增其他主題,以便在 Runbook 資源庫中進行分類和搜尋。

    注意

    請查看資源庫中現有的 Runbook,以了解您可能使用的格式化、標頭和現有的標籤 (如 Azure AutomationLinux Azure Virtual Machines)。

若要對現有的 Runbook 提出變更建議,請對其提出提取要求。

如果您決定複製和編輯現有的 Runbook,最佳做法是提供不同的名稱。 如果您重複使用舊名稱,名稱將會在 Runbook 資源庫清單中顯示兩次。

注意

對於更新和新增的 Runbook,請允許至少 12 小時進行 GitHub 與自動化 Runbook 資源庫之間的同步處理。

Microsoft 鼓勵您將 Runbook 新增至您認為可能有助於其他客戶的 PowerShell 資源庫。 「PowerShell 資源庫」接受 PowerShell 模組和 PowerShell 指令碼。 您可以藉由將其上傳至 PowerShell 資源庫,以新增 Runbook。

  1. 在 Azure 入口網站中,開啟自動化帳戶。

  2. 在 [共用資源] 底下,選取 [模組]。

  3. 在 [模組] 分頁中,選取 [瀏覽資源庫] 以開啟模組清單。

    模組資源庫的檢視。

  4. 在 [瀏覽資源庫] 頁面上,您可以依下列欄位來搜尋:

    • 模組名稱
    • 標籤
    • 作者
    • Cmdlet/DSC 資源名稱
  5. 尋找您感興趣的模組,並選取以檢視其詳細資料。

    當您向下切入到特定的模組時,您可以檢視更多的資訊。 此資訊包括返回 PowerShell 資源庫的連結、任何必要的相依性,以及該模組包含的所有 Cmdlet 或 DSC 資源。

    來自資源庫的模組詳細檢視。

  6. 若要將該模組直接安裝至 Azure 自動化,請按一下 [匯入]

  7. 在 [匯入] 窗格中,您可以看見要匯入的模組名稱。 如果已安裝所有相依性,[確定] 按鈕會啟動。 如果缺少相依性,您必須先匯入這些相依性後,才能匯入此模組。

  8. 在 [匯入] 窗格中,按一下 [確定],以匯入模組。 當 Azure 自動化將模組匯入至您的帳戶時,它會擷取有關模組和 Cmdlet 的中繼資料。 因為必須解壓縮每個活動,此動作可能需要幾分鐘的時間。

  9. 您會收到初始通知,表示正在部署模組,而完成時還會收到另一個通知。

  10. 匯入模組之後,您可以看到可用的活動。 您可以使用 Runbook 和 DSC 資源中的模組資源。

注意

Azure 自動化不支援僅支援 PowerShell 核心的模組,該模組無法匯入 Azure 入口網站中,或直接從 PowerShell 資源庫部署。

要求 Runbook 或模組

您可以將要求傳送至 使用者心聲。 如果您需要協助撰寫 Runbook 或有關於 PowerShell 的問題,請將問題張貼至我們的 Microsoft 問與答頁面 \(英文\)。

下一步