使用現有的 Runbook 和模組

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

注意

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 入口網站 中的自動化帳戶匯入 Runbook。

注意

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

您只能使用 Azure 入口網站 直接從 PowerShell 資源庫 匯入。 您無法使用 PowerShell 執行此函式。 此程式與使用 Azure 入口網站 從 GitHub 匯入 Runbook 中所示的程式相同,不同之處在於 Source 將會 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 資源庫清單中顯示兩次。

注意

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

Microsoft 鼓勵您將 Runbook 新增至您認為對其他客戶有用的 PowerShell 資源庫。 PowerShell 資源庫 接受 PowerShell 模組和 PowerShell 腳本。 您可以將 Runbook 上傳至 PowerShell 資源庫 來新增 Runbook

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

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

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

    View of the module gallery.

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

    • 模組名稱
    • 標籤
    • 作者
    • 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 或模組

您可以將要求傳送至 User Voice。 如果您需要撰寫 Runbook 或有 PowerShell 相關問題的協助,請將問題張貼到我們的 Microsoft Q&A 問題頁面

下一步