發行項
09/16/2016

編輯 Runbook

發行︰ 2016年7月

適用於： Windows Azure Pack for Windows Server

服務管理自動化中的每一個 Runbook 有兩個版本，「草稿」和「已發佈」。您可以編輯工作流程的「草稿」版本，然後發佈它以執行。無法編輯已發佈版本。

使用管理入口網站編輯 Runbook

管理入口網站包含可用來檢視和編輯 Runbook 的編輯器。除了提供基本的文字編輯功能，編輯器可讓您自動插入全域資產、活動和 Runbook 的程式碼。

在管理入口網站中，選取 [自動化]。
選取 [Runbook] 索引標籤。
按一下您想要編輯的 Runbook 名稱。
選取 [作者] 索引標籤。
按一下畫面頁端的 [草稿]，或畫面底部的 [編輯] 按鈕。
執行必要的編輯。
完成編輯時按一下 [儲存]。
若要發佈 Runbook 的最新草稿版本，請按一下 [發佈]。

將程式碼插入至 Runbook

自動化編輯器包含將活動、設定和 Runbook 的程式碼插入 Runbook 的功能。您不需輸入程式碼本身，可改為從可用的資產清單中選取，然後將適當的程式碼插入 Runbook。

將 Runbook 的程式碼插入 Runbook

在管理入口網站編輯器中開啟 Runbook。
在畫面底部，依序按一下 [插入] 及 [Runbook]。
選取要從中央欄插入的 Runbook，再按一下向右鍵。
如果 Runbook 有參數，它們會列出供您參考。
按一下檢查按鈕。
會將用來執行選定 Runbook 的程式碼插入目前的 Runbook。
如果 Runbook 需要參數，請提供適當的值來取代括號 <> 括住的資料類型。

將全域資產插入 Runbook

在管理入口網站編輯器中開啟 Runbook。
在畫面底部，依序按一下 [插入] 及 [設定]。
在 [設定動作] 欄中，選取您需要的程式碼類型
從中心欄的可用資產中選取。
按一下檢查按鈕。

將活動插入 Runbook

在管理入口網站編輯器中開啟 Runbook。
在畫面底部，依序按一下 [插入] 及 [活動]。
在 [整合模組] 欄中，選取包含活動的模組。
在 [活動] 窗格中，選取一個活動。
在 [描述] 欄中，記下活動的描述。或者，您可以按一下 [檢視詳細的說明]，在瀏覽器中啟動活動的說明。
按一下向右鍵。
如果活動有參數，它們會列出供您參考。
按一下檢查按鈕。
會將用來執行活動的程式碼插入 Runbook。
如果活動需要參數，請提供適當的值來取代括號 <> 括住的資料類型。

使用 Windows PowerShell 編輯自動化 Runbook

若要使用 Windows PowerShell 編輯 Runbook，請使用選擇的編輯器編輯工作流程，並將它儲存到 .ps1 檔案。您可以使用 Get-SMARunbookDefinition Cmdlet 來擷取 Runbook 內容，再使用 Edit-SMARunbook Cmdlet，以修改過的草稿工作流程取代現有的草稿工作流程。

若要從指令碼檔案的內容建立新的 Runbook，請參閱To import a runbook from a script file with Windows PowerShell。

使用 Windows PowerShell 擷取 Runbook 的內容

下列命令範例會顯示如何擷取 Runbook 的指令碼，並將它儲存到指令碼檔案。在此範例中會擷取草稿版本。此外，也可以擷取已發佈版本的 Runbook，但無法變更此版本。

$webServer = 'https://MyServer'  
$port = 9090  
$runbookName = "Test-Runbook"  
$scriptPath = "c:\runbooks\Test-Runbook.ps1"  
  
$runbookDefinition = Get-SMARunbookDefinition –WebServiceEndpoint $webServer –Port $port -Name $runbookName -Type Draft  
$runbookContent = $runbookDefinition.Content  
  
Out-File -InputObject $runbookContent -FilePath $scriptPath

使用 Windows PowerShell 變更 Runbook 的內容

下列命令範例顯示如何以包含工作流程的指令碼檔案內容，取代現有的 Runbook 內容。

$webServer = 'https://MyServer'  
$port = 9090  
$runbookName = "Test-Runbook"  
$scriptPath = "c:\runbooks\Test-Runbook.ps1"  
  
Edit-SmaRunbook –WebServiceEndpoint $webServer –Port $port -Name $runbookName -Path $scriptPath -Overwrite  
Publish-SmaRunbook –WebServiceEndpoint $webServer –Port $port –Name $runbookName –Path $scriptPath

請參閱

建立或匯入 Runbook
Service Management Automation
Runbook 撰寫 [SMA]

共用方式為