使用現有的 Runbook 和模組

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

注意

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

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

注意

  • Azure 入口網站中的[流覽資源庫] 選項具有增強的使用者體驗。
  • [進程自動化>][Runbook] 刀鋒視窗中,您可以匯入Runbook,方法是匯入 Runbook 或[流覽資源庫] 選項,而[Runbook]頁面會顯示兩個新的資料行 -執行時間版本Runbook 類型
  1. 在 Azure 入口網站中,開啟您的自動化帳戶。

  2. 選取[進程自動化] 底下的[Runbook]刀鋒視窗。

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

    Screenshot of selecting a runbook from import runbook option.

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

  5. 選取檔案。

  6. 輸入 [名稱]、[ 執行時間版本] 和 [描述]。

  7. 按一下 [匯入] 。

    Screenshot of selecting a runbook from file or gallery.

  8. 或者,在[Runbook]頁面中選取[流覽資源庫] 以流覽可用的 Runbook。

    Screenshot of selecting browsing gallery option from runbook blade.

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

    Browsing runbook gallery.

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

  11. 在 [ 匯入 Runbook ] 頁面中,輸入 [名稱 ],然後選取 [執行時間版本]。

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

  13. 按一下 [匯入] 。

    Gallery item import.

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

重要

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

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

注意

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

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

Showing runbook gallery source selection.

PowerShell 模組包含您可以在 Runbook 中使用的 Cmdlet。 您可以在 Azure 自動化 中安裝的現有模組,可在PowerShell 資源庫中使用。 您可以從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. [模組 ] 頁面中,選取 [流覽資源庫 ] 以開啟模組清單。

    View of the module gallery.

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

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

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

    Detailed view of a module from the gallery.

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

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

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

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

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

注意

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

要求 Runbook 或模組

您可以將要求傳送至 使用者心聲。 如果您需要撰寫 Runbook 的協助,或有關于 PowerShell 的問題,請將問題張貼到 我們的 Microsoft QA & 問題頁面

下一步