Runbookの編集
発行: 2016年6月
適用対象: Windows Azure Pack for Windows Server
サービス管理オートメーション の各 Runbook には、Draft、Published、という 2 つのバージョンがあります。 ワークフローの Draft バージョンは編集してから、実行できるように公開します。 公開済みバージョンは編集できません。
管理ポータルを使用して Runbook を編集するには
管理ポータルには、Runbook の閲覧と編集を行うことができるエディターが含まれています。 エディターは基本的なテキスト編集機能だけでなく、グローバル アセット、アクティビティ、Runbook にコードを自動的に挿入する機能を備えています。
管理ポータルで、[Automation] を選択します。
[Runbooks] タブを選択します。
編集する Runbook の名前をクリックします。
[Author] タブを選択します。
画面上部の [Draft] か画面下部の [編集] ボタンのいずれかをクリックします。
必要な編集を行います。
編集が終了したら [保存] をクリックします。
Runbook の最新のドラフト バージョンを公開する場合は、[Publish] をクリックします。
コードを Runbook に挿入します。
オートメーション エディターには、Runbook にアクティビティ、設定、Runbook 用のコードを挿入するための機能が備わっています。 コードを自分で入力しなくても、使用できるアセットの一覧から選択し、適切なコードを Runbook に挿入できます。
Runbook のコードを Runbook に挿入するには
管理ポータル エディターで、Runbook を開きます。
画面下部で、[挿入]、[Runbook] とクリックします。
Runbook を選択して中央の列から挿入し、右矢印をクリックします。
Runbook にパラメーターがある場合、一覧に表示されます。
チェック ボタンをクリックします。
選択した Runbook を実行するコードが現在の Runbook に挿入されます。
Runbook でパラメーターが要求される場合、中かっこ <> で囲まれたデータ型に適切な値を提供します。
Runbook にグローバル アセットを挿入するには
管理ポータル エディターで、Runbook を開きます。
画面下部で、[挿入]、[設定] とクリックします。
設定アクション列で、必要なコードの種類を選択します。
中央の列で使用できるアセットから選択します。
チェック ボタンをクリックします。
Runbook にアクティビティを挿入するには
管理ポータル エディターで、Runbook を開きます。
画面下部で、[挿入]、[アクティビティ] とクリックします。
統合モジュール列で、アクティビティを含むモジュールを選択します。
[アクティビティ] ウィンドウで、アクティビティを選択します。
説明列で、アクティビティの説明を入力します。 必要に応じて、[詳細なヘルプを表示する] をクリックしてブラウザーでアクティビティのヘルプを起動します。
右矢印をクリックします。
アクティビティにパラメーターがある場合、一覧に表示されます。
チェック ボタンをクリックします。
アクティビティを実行するコードが Runbook に挿入されます。
アクティビティでパラメーターが要求される場合、中かっこ <> で囲まれたデータ型に適切な値を提供します。
Windows PowerShell を使用して、Automation Runbook を編集するには
Windows PowerShell を使用して Runbook を編集するには、任意のエディターを使用してワークフローを編集し、.ps1 ファイルに保存します。Get-smarunbookdefinition コマンドレットを使用して Runbook の内容を取得し、それから Edit-smarunbook コマンドレットを使用して、既存のドラフト ワークフローを変更したものに置き換えます。
スクリプト ファイルの内容から新しい Runbook を作成するには、「d14db796-a3e5-4b1d-a098-e734ceae2e0e#ImportRunbookScriptPS」をご覧ください。
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]