Azure Automation で Runbook を管理する

[アーティクル]
09/10/2024

Azure Automation には、新しい Runbook を作成するか、ファイルまたは Runbook ギャラリーから既存の Runbook をインポートすることによって Runbook を追加することができます。この記事では、Runbook の管理に関する情報と、Runbook の設計に関する推奨パターンとベストプラクティスについて説明します。コミュニティによって提供されている Runbook やモジュールの利用について詳しくは、Azure Automation 用の Runbook ギャラリーとモジュールギャラリーに関するページを参照してください。

Runbook を作成する

Azure portal または PowerShell を使用して、Azure Automation に新しい Runbook を作成します。作成した Runbook は、次の情報を使用して編集できます。

Azure portal で Runbook を作成する

Azure portal にサインインします。
Automation アカウントを検索して選択します。
[Automation アカウント] ページで、一覧からお使いの Automation アカウントを選択します。
Automation アカウントで [プロセスオートメーション] の [Runbook] を選択し、Runbook の一覧を開きます。
[Runbook の作成] をクリックします。
1. Runbook に名前を付けます。
2. [Runbook の種類] ドロップダウンから種類を選択します。 Runbook 名は、先頭を英字にする必要があり、英字、数字、アンダースコア、ダッシュを使用できます
3. [ランタイムバージョン] を選択します
4. 該当する [説明] を入力します
[作成] をクリックして、Runbook を作成します。

PowerShell で Runbook を作成する

空の Runbook を作成するには、New-AzAutomationRunbook コマンドレットを使用します。 Type パラメーターを使用して、New-AzAutomationRunbook に対して定義されている Runbook の種類の 1 つを指定します。

次の例は、新しい空の Runbook を作成する方法を示しています。

$params = @{
    AutomationAccountName = 'MyAutomationAccount'
    Name                  = 'NewRunbook'
    ResourceGroupName     = 'MyResourceGroup'
    Type                  = 'PowerShell'
}
New-AzAutomationRunbook @params

Runbook をインポートする

PowerShell または PowerShell ワークフロー (.ps1) スクリプト、グラフィカル Runbook (.graphrunbook)、Python 2 または Python 3 スクリプト (.py) をインポートして独自の Runbook を作成することができます。インポート時に作成される Runbook の種類を指定します。その際、次のことを考慮します。

ワークフローが含まれていない .ps1 ファイルは、PowerShell Runbook または PowerShell ワークフロー Runbook のどちらにもインポートすることができます。それを PowerShell ワークフロー Runbook にインポートすると、ワークフローに変換されます。この場合、Runbook には、加えられた変更を説明するコメントが追加されます。
PowerShell ワークフローを含む .ps1 ファイルは、PowerShell ワークフロー Runbook にのみインポートできます。ファイルに複数の PowerShell ワークフローが含まれている場合、インポートは失敗します。各ワークフローを個別のファイルに保存し、それぞれを個別にインポートする必要があります。
PowerShell ワークフローを含む .ps1 ファイルは PowerShell スクリプトエンジンでは認識できないため、PowerShell Runbook にインポートしないでください。
.graphrunbook ファイルは、新しいグラフィカル Runbook にのみインポートします。

Azure portal から Runbook をインポートする

次の手順を使用して、スクリプトファイルを Azure Automation にインポートできます。

Note

このポータルを使用して PowerShell ワークフロー Runbook にインポートできるのは .ps1 ファイルだけです。

Azure portal で [Automation アカウント] を検索して選択します。
[Automation アカウント] ページで、一覧からお使いの Automation アカウントを選択します。
Automation アカウントで [プロセスオートメーション] の [Runbook] を選択し、Runbook の一覧を開きます。
[Runbook のインポート] をクリックします。次のいずれかのオプションを選択することができます。
1. [ファイルの参照] - ローカルコンピューターからファイルを選択します。
2. [ギャラリーで参照] - ギャラリーから既存の Runbook を参照して選択できます。
ファイルを選択します。
[名前] フィールドが有効になっている場合は、必要に応じて Runbook 名を変更することができます。名前は文字で始める必要があり、文字、数字、アンダースコア、およびダッシュを含めることができます。
[Runbook の種類] は自動的に設定されますが、該当する制限を考慮して種類を変更することもできます。
[ランタイムバージョン] は、自動的に設定されるか、またはドロップダウンリストからバージョンを選択します。
[インポート] をクリックします。新しい Runbook は、自動化アカウントの Runbook のリストに表示されます。
Runbook を実行する前に、Runbook を公開する必要があります。

Note

グラフィカル Runbook は、インポート後、他の種類に変換することができます。ただし、グラフィカル Runbook をテキスト形式の Runbook に変換することはできません。

PowerShell で Runbook をインポートする

Runbook のドラフトとしてスクリプトファイルをインポートするには、Import-AzAutomationRunbook コマンドレットを使用します。 Runbook が既に存在する場合、コマンドレットで Force パラメーターを使用しないと、インポートは失敗します。

次の例では、スクリプトファイルを Runbook にインポートする方法を示します。

$params = @{
    AutomationAccountName = 'MyAutomationAccount'
    Name                  = 'Sample_TestRunbook'
    ResourceGroupName     = 'MyResourceGroup'
    Type                  = 'PowerShell'
    Path                  = 'C:\Runbooks\Sample_TestRunbook.ps1'
}
Import-AzAutomationRunbook @params

リソースを処理する

Runbook でリソースを作成する場合、リソースの作成を試みる前に、リソースが既に存在するかどうかをスクリプトで確認する必要があります。基本的な例を次に示します。

$vmName = 'WindowsVM1'
$rgName = 'MyResourceGroup'
$myCred = Get-AutomationPSCredential 'MyCredential'

$vmExists = Get-AzResource -Name $vmName -ResourceGroupName $rgName
if (-not $vmExists) {
    Write-Output "VM $vmName does not exist, creating"
    New-AzVM -Name $vmName -ResourceGroupName $rgName -Credential $myCred
} else {
    Write-Output "VM $vmName already exists, skipping"
}

アクティビティログから詳細を取得する

Runbook を開始したユーザーやアカウントなど、Runbook に関する詳細を、Automation アカウントのアクティビティログから取得できます。次の PowerShell の例では、指定した Runbook を最後に実行したユーザーが提供されます。

$rgName = 'MyResourceGroup'
$accountName = 'MyAutomationAccount'
$runbookName = 'MyRunbook'
$startTime = (Get-Date).AddDays(-1)

$params = @{
    ResourceGroupName = $rgName
    StartTime         = $startTime
}
$JobActivityLogs = (Get-AzLog @params).Where( { $_.Authorization.Action -eq 'Microsoft.Automation/automationAccounts/jobs/write' })

$JobInfo = @{}
foreach ($log in $JobActivityLogs) {
    # Get job resource
    $JobResource = Get-AzResource -ResourceId $log.ResourceId

    if ($null -eq $JobInfo[$log.SubmissionTimestamp] -and $JobResource.Properties.Runbook.Name -eq $runbookName) {
        # Get runbook
        $jobParams = @{
            ResourceGroupName     = $rgName
            AutomationAccountName = $accountName
            Id                    = $JobResource.Properties.JobId
        }
        $Runbook = Get-AzAutomationJob @jobParams | Where-Object RunbookName -EQ $runbookName

        # Add job information to hashtable
        $JobInfo.Add($log.SubmissionTimestamp, @($Runbook.RunbookName, $Log.Caller, $JobResource.Properties.jobId))
    }
}
$JobInfo.GetEnumerator() | Sort-Object Key -Descending | Select-Object -First 1

進行状況の追跡

簡単に再利用や再起動ができるロジックを使用したモジュールの形式で Runbook を作成することをお勧めします。問題が発生しても、Runbook の進行状況が追跡されていれば、Runbook のロジックを正常に実行することができます。

Runbook の進行状況は、ストレージアカウント、データベース、ファイル共有などの外部ソースを使用して追跡できます。最後に実行されたアクションの状態をまずチェックするロジックを、Runbook に作成します。その後、チェックの結果に基づいて、Runbook 内の特定のタスクをスキップまたは続行できます。

同時実行ジョブの防止

一部の Runbook は、同時に複数のジョブで実行されると、おかしな動作をすることがあります。この場合は、既に実行中のジョブがあるかどうかをチェックするロジックを Runbook に実装することが重要です。基本的な例を次に示します。

# Ensures you do not inherit an AzContext in your runbook
Disable-AzContextAutosave -Scope Process

# Connect to Azure with system-assigned managed identity 
$AzureContext = (Connect-AzAccount -Identity).context

# set and store context 
$AzureContext = Set-AzContext -SubscriptionName $AzureContext.Subscription -DefaultProfile $AzureContext

# Check for already running or new runbooks 
$runbookName = "runbookName" 
$resourceGroupName = "resourceGroupName" 
$automationAccountName = "automationAccountName"

$jobs = Get-AzAutomationJob -ResourceGroupName $resourceGroupName -AutomationAccountName $automationAccountName -RunbookName $runbookName -DefaultProfile $AzureContext

# Ranking all the active jobs
$activeJobs = $jobs | where {$_.status -eq 'Running' -or $_.status -eq 'Queued' -or $_.status -eq 'New' -or $_.status -eq 'Activating' -or $_.status -eq 'Resuming'} | Sort-Object -Property CreationTime 
$jobRanking = @() 
$rank = 0 
ForEach($activeJob in $activeJobs) 
{         
    $rank = $rank + 1 
    $activeJob | Add-Member -MemberType NoteProperty -Name jobRanking -Value $rank -Force 
    $jobRanking += $activeJob 
}
    
$AutomationJobId = $PSPrivateMetadata.JobId.Guid 
$currentJob = $activeJobs | where {$_.JobId -eq $AutomationJobId} 
$currentJobRank = $currentJob.jobRanking 

# Only allow the Job with Rank = 1 to start processing. 
If($currentJobRank -ne "1") 
{ 
    Write-Output "$(Get-Date -Format yyyy-MM-dd-hh-mm-ss.ffff) Concurrency check failed as Current Job Ranking is not 1 but $($currentJobRank) therefore exiting..." 
    Exit 
} Else
{
    Write-Output "$(Get-Date -Format yyyy-MM-dd-hh-mm-ss.ffff) Concurrency check passed. Start processing.." 
}

Runbook をシステム割り当てマネージド ID で実行する場合は、コードをそのままにしておきます。ユーザー割り当てマネージド ID を使用する場合は、次のようにします。

5 行目から、$AzureContext = (Connect-AzAccount -Identity).context を削除し、
それを $AzureContext = (Connect-AzAccount -Identity -AccountId <ClientId>).context に置き換えた後、
クライアント ID を入力します。

Note

PowerShell 7.2 ハイブリッドジョブの場合、28 行目で変更を行います。 $PSPrivateMetadata.JobId.Guid を $env:PSPrivateMetaDataに置き換えます。

時間に依存するスクリプトの一時的なエラーを処理する

Runbook は堅牢であること、そして再起動や失敗を引き起こす可能性のあるエラー (一時的なエラーを含む) を処理できることが必要です。 Runbook が失敗した場合、Azure Automation によって再試行されます。

Runbook が時間制約内で普通に実行される場合は、スクリプトで実行時間をチェックするロジックを実装します。このチェックにより、特定の時間帯にのみ、起動、シャットダウン、スケールアウトなどの操作が実行されることが保証されます。

Note

Azure サンドボックスプロセス上のローカル時刻は UTC に設定されます。 Runbook での日付と時刻の計算では、この事実を考慮する必要があります。

Runbook でロジックを再試行し、一時的なエラーを回避する

Runbook は、ARM、Azure Resource Graph、SQL サービス、その他の Web サービスを介して、Azure などのリモートシステムを呼び出すことがよくあります。 Runbook が呼び出しているそのシステムがビジー状態である、一時的に使用できない、または負荷時に調整を実装している場合、その呼び出しでランタイムエラーが発生することがあります。 Runbook 内に回復性を構築するには、Runbook が失敗することなく一時的な問題を処理できるように、呼び出しを行う際の再試行ロジックを実装する必要があります。

詳しくは、「再試行パターン」と「一般的な REST および再試行のガイドライン」をご参照ください。

例 1: Runbook が 1 つまたは 2 つの呼び出しのみを行う場合

$searchServiceURL = "https://$searchServiceName.search.windows.net"
$resource = Get-AzureRmResource -ResourceType "Microsoft.Search/searchServices" -ResourceGroupName $searchResourceGroupName -ResourceName  $searchServiceName -ApiVersion 2015-08-19
$searchAPIKey = (Invoke-AzureRmResourceAction -Action listAdminKeys -ResourceId $resource.ResourceId -ApiVersion 2015-08-19 -Force).PrimaryKey

Invoke-AzureRmResourceAction を呼び出すと、一時的な失敗が発生する場合があります。そのようなシナリオでは、そのコマンドレットの呼び出しに関する次の基本パターンを実装することをお勧めします。

$searchServiceURL = "https://$searchServiceName.search.windows.net"
$resource = Get-AzureRmResource -ResourceType "Microsoft.Search/searchServices" -ResourceGroupName $searchResourceGroupName -ResourceName  $searchServiceName -ApiVersion 2015-08-19

    # Adding in a retry
    $Stoploop = $false
    $Retrycount = 0
 
    do {
        try   {
               $searchAPIKey = (Invoke-AzureRmResourceAction -Action listAdminKeys -ResourceId $resource.ResourceId -ApiVersion 2015-08-19 -Force).PrimaryKey
               write-verbose "Invoke-AzureRmResourceAction on $resource.ResourceId completed"
               $Stoploop = $true
              }
        catch {
               if ($Retrycount -gt 3)
                 {
                  Write-verbose "Could not Invoke-AzureRmResourceAction on $resource.ResourceId after 3 retrys."
                  $Stoploop = $true
                 }
               else  
                 {
                  Write-verbose "Could not Invoke-AzureRmResourceAction on $resource.ResourceId retrying in 30 seconds..."
                  Start-Sleep -Seconds 30
                  $Retrycount = $Retrycount + 1
                 }
               }
        }
    While ($Stoploop -eq $false)

Note

最大 3 回の再試行がその呼び出しに対して実行され、毎回 30 秒間スリープ状態になります。

例 2: Runbook が頻繁にリモート呼び出しを行っている場合

Runbook が頻繁にリモート呼び出しを行っている場合は、一時的なランタイムの問題が発生することがあります。実行される呼び出しごとに再試行ロジックを実装し、スクリプトブロックとして実行されるその呼び出しを渡して実行する関数を作成します。

Function ResilientRemoteCall {

         param(
               $scriptblock
               )
        
         $Stoploop = $false
         $Retrycount = 0
 
         do {
             try   {
                    Invoke-Command -scriptblock $scriptblock 
                    write-verbose "Invoked $scriptblock completed"
                    $Stoploop = $true
                   }
             catch {
                    if ($Retrycount -gt 3)
                      {
                       Write-verbose "Invoked $scriptblock failed 3 times and we will not try again."
                       $Stoploop = $true
                      }
                    else  
                      {
                       Write-verbose "Invoked $scriptblock failed  retrying in 30 seconds..."
                       Start-Sleep -Seconds 30
                       $Retrycount = $Retrycount + 1
                      }
                    }
             }
         While ($Stoploop -eq $false)
}

その後、各リモート呼び出しを次のように関数に渡すことができます。

ResilientRemoteCall { Get-AzVm } または

ResilientRemoteCall { $searchAPIKey = (Invoke-AzureRmResourceAction -Action listAdminKeys -ResourceId $resource.ResourceId -ApiVersion 2015-08-19 -Force).PrimaryKey}

複数のサブスクリプションの操作

Runbook は、サブスクリプションを操作できることが必要です。たとえば、複数のサブスクリプションを処理するために、Runbook には Disable-AzContextAutosave コマンドレットが使用されます。このコマンドレットを使用するのは、同じサンドボックスで実行されている別の Runbook から認証コンテキストが取得されないようにするためです。

# Ensures you do not inherit an AzContext in your runbook
Disable-AzContextAutosave -Scope Process

# Connect to Azure with system-assigned managed identity
$AzureContext = (Connect-AzAccount -Identity).context

# set and store context
$AzureContext = Set-AzContext -SubscriptionName $AzureContext.Subscription `
    -DefaultProfile $AzureContext

$childRunbookName = 'childRunbookDemo'
$resourceGroupName = "resourceGroupName"
$automationAccountName = "automationAccountName"

$startParams = @{
    ResourceGroupName     = $resourceGroupName
    AutomationAccountName = $automationAccountName
    Name                  = $childRunbookName
    DefaultProfile        = $AzureContext
}
Start-AzAutomationRunbook @startParams

5 行目から、$AzureContext = (Connect-AzAccount -Identity).context を削除し、
それを $AzureContext = (Connect-AzAccount -Identity -AccountId <ClientId>).context に置き換えた後、
クライアント ID を入力します。

カスタムスクリプトを使用する

Note

通常、Log Analytics エージェントがインストールされているホストでカスタムスクリプトと Runbook を実行することはできません。

カスタムスクリプトを使用するには、次の手順に従います。

Automation アカウントを作成します。
Hybrid Runbook Worker ロールを展開します。
Linux コンピューターでは通常より高い権限が必要です。サインインして署名の確認を無効にします。

Runbook をテストする

Runbook のテスト時にはドラフトバージョンが実行され、そのバージョンで行われるすべてのアクションが完了します。ジョブ履歴は作成されませんが、[テスト出力] ペインに出力および警告とエラーのストリームが表示されます。 VerbosePreference 変数が Continue に設定されている場合のみ、詳細ストリームに対するメッセージが [出力] ペインに表示されます。

ドラフトバージョンを実行している場合も、Runbook は通常どおり実行され、環境中のリソースに対するすべての操作が実行されます。このため、Runbook をテストするのは非運用環境のリソースのみにしてください。

Note

すべての Runbook 実行アクションは、操作名が [Azure Automation ジョブの作成] の Automation アカウントのアクティビティログに記録されます。ただし、Runbook のドラフトバージョンが実行されるテストペインでの Runbook の実行は、操作名 [Azure Automation Runbook ドラフトを書き込む] でアクティビティログに記録されます。 [操作] と [JSON] タブを選択し、../runbooks/(runbook name)/draft/testjob で終わるスコープを参照します。

Runbook の各種類をテストする手順はいずれも同じです。 Azure portal のテキストエディターとグラフィカルエディターではテスト方法に違いはありません。

テキストエディターまたはグラフィカルエディターのどちらかで、ドラフトバージョンの Runbook を開きます。
[テスト] をクリックして [テスト] ページを開きます。
Runbook にパラメーターがある場合は左ペインに表示され、そこでテストに使用する値を指定することができます。
Hybrid Runbook Worker に対してテストを実施する場合は、[実行設定] を [ハイブリッド worker] に変更してターゲットグループの名前を選択します。それ以外の場合は、既定の [Azure] をそのまま使用してクラウドでテストを実行します。
[開始] をクリックしてテストを開始します。
テスト中の Powershell Workflow およびグラフィカル Runbook は、[出力] ペインのボタンで停止および一時停止できます。 Runbook は、中断される場合は中断前に現在のアクティビティを完了します。 Runbook を中断した後で、停止または再開できます。
[出力] ペインで Runbook の出力を調べます。

Runbook を発行する

新しく作成またはインポートした Runbook は、実行する前に発行しておく必要があります。 Azure Automation の各 Runbook には、ドラフトバージョンと発行バージョンがあります。実行できるのは発行バージョンのみで、編集できるのはドラフトバージョンのみです。ドラフトバージョンを変更しても発行バージョンに影響はありません。ドラフトバージョンを使用できるようにする必要がある場合は、それを発行します。これにより、現在発行されているバージョンがドラフトバージョンで上書きされます。

Azure portal で Runbook を発行する

Azure portal で [Automation アカウント] を検索して選択します。
[Automation アカウント] ページで、一覧からお使いの Automation アカウントを選択します。
お使いの Automation アカウントで Runbook を開きます。
[編集] をクリックします。
[発行] をクリックしてから、確認メッセージに対して [はい] を選択します。

PowerShell を使用して Runbook を発行する

Publish-AzAutomationRunbook コマンドレットを使用して Runbook を発行します。

$accountName = "MyAutomationAccount"
$runbookName = "Sample_TestRunbook"
$rgName = "MyResourceGroup"

$publishParams = @{
    AutomationAccountName = $accountName
    ResourceGroupName     = $rgName
    Name                  = $runbookName
}
Publish-AzAutomationRunbook @publishParams

Azure portal で Runbook をスケジュールする

Runbook が発行済みであるときに、操作のスケジュールを設定できます。

Azure portal で [Automation アカウント] を検索して選択します。
[Automation アカウント] ページで、一覧からお使いの Automation アカウントを選択します。
Runbook の一覧から Runbook を選択します。
[リソース] の下の [スケジュール] を選択します。
[スケジュールの追加] を選択します。
[Runbook のスケジュール設定] ウィンドウで、[スケジュールを Runbook にリンクします] を選択します。
[スケジュール] ウィンドウで、[新しいスケジュールを作成します] を選択します。
[新しいスケジュール] ウィンドウで、名前、説明、その他のパラメーターを入力します。
スケジュールを作成したら、それを強調表示し、[OK] をクリックします。これで、Runbook にリンクされるようになります。
メールボックスの電子メールで、Runbook の状態通知を探します。

削除した Runbook を復元する

PowerShell スクリプトを使用して、削除した Runbook を復旧することができます。 Runbook を復旧するには、次の条件が満たされていることを確認します。

復元する Runbook が過去 29 日間に削除されていること。
その Runbook の Automation アカウントが存在すること。
Automation アカウントのシステム割り当てマネージド ID に Automation 共同作成者のロール権限が付与されていること。

PowerShell スクリプト

Automation アカウントで PowerShell スクリプトをジョブとして実行し、削除された Runbook を復元します。
GitHub から PowerShell スクリプトをダウンロードします。または、Runbook ギャラリーから "Automation Runbook の復元" という PowerShell スクリプトをインポートします。復元する Runbook の名前を指定し、Azure Automation でジョブとして実行して、削除された Runbook を復元します。
GitHub からスクリプトをダウンロードするか、Runbook ギャラリーから "削除した Automation Runbook の一覧表示" という PowerShell スクリプトをインポートして、過去 29 日間に削除された Runbook の名前を識別します。

ジョブの状態を取得する

Azure portal で状態を表示する

Azure Automation におけるジョブの処理について詳しくは、「ジョブ」を参照してください。 Runbook ジョブを見る準備が整ったら、Azure portal を使用して Automation アカウントにアクセスします。右側にある [ジョブの統計情報] で、すべての Runbook ジョブの概要を確認できます。

[ジョブの統計情報] タイル

概要では、実行された各ジョブの数を確認できるほか、その状態がグラフィカルに表示されます。

タイルをクリックすると、実行されたすべてのジョブの概要を示す一覧が含まれた [ジョブ] ページが表示されます。このページには、各ジョブの状態、Runbook 名、開始時刻、完了時間が表示されます。

[ジョブ] ページのスクリーンショット。

[ジョブのフィルター] を選択すると、ジョブの一覧をフィルター処理すできます。特定の Runbook、ジョブの状態、またはドロップダウンリストから選択したものでフィルター処理し、検索の時間範囲を指定します。

ジョブの状態でフィルター処理する

また、Automation アカウントの [Runbook] ページで Runbook を選択してから、[ジョブ] を選択することで、特定の Runbook のジョブ概要の詳細を表示することができます。この操作により、[ジョブ] ページが表示されます。ここから、ジョブレコードをクリックして、その詳細と出力を表示できます。

[エラー] ボタンが強調表示された [ジョブ] ページのスクリーンショット。

PowerShell を使用してジョブの状態を取得する

Runbook 用に作成されたジョブと、特定のジョブの詳細を取得するには、Get-AzAutomationJob コマンドレットを使用します。 Start-AzAutomationRunbook を使用して Runbook を開始すると、結果として作成されたジョブが返されます。ジョブの出力を取得するには Get-AzAutomationJobOutput を使用します。

次の例では、サンプル Runbook の最後のジョブが取得されて、その状態、Runbook パラメーターに指定された値、およびジョブの出力が表示されます。

$getJobParams = @{
    AutomationAccountName = 'MyAutomationAccount'
    ResourceGroupName     = 'MyResourceGroup'
    Runbookname           = 'Test-Runbook'
}
$job = (Get-AzAutomationJob @getJobParams | Sort-Object LastModifiedDate -Desc)[0]
$job | Select-Object JobId, Status, JobParameters

$getOutputParams = @{
    AutomationAccountName = 'MyAutomationAccount'
    ResourceGroupName     = 'MyResourceGroup'
    Id                    = $job.JobId
    Stream                = 'Output'
}
Get-AzAutomationJobOutput @getOutputParams

次の例では、特定のジョブの出力が取得されて、各レコードが返されます。いずれかのレコードで例外が発生した場合、スクリプトでは値ではなく例外が書き出されます。この動作は役に立ちます。出力時に通常はログに記録されない追加情報が、例外によって提供される可能性があるためです。

$params = @{
    AutomationAccountName = 'MyAutomationAccount'
    ResourceGroupName     = 'MyResourceGroup'
    Stream                = 'Any'
}
$output = Get-AzAutomationJobOutput @params

foreach ($item in $output) {
    $jobOutParams = @{
        AutomationAccountName = 'MyAutomationAccount'
        ResourceGroupName     = 'MyResourceGroup'
        Id                    = $item.StreamRecordId
    }
    $fullRecord = Get-AzAutomationJobOutputRecord @jobOutParams

    if ($fullRecord.Type -eq 'Error') {
        $fullRecord.Value.Exception
    } else {
        $fullRecord.Value
    }
}

次のステップ

サンプルクエリについて、ジョブログおよびジョブストリームのサンプルクエリを参照してください
Runbook の管理の詳細については「Azure Automation での Runbook の実行」を参照してください。
PowerShell Runbook の準備については、「Azure Automation でのテキスト形式の Runbook の編集」を参照してください。
Runbook の実行に関する問題のトラブルシューティングについては、Runbook の問題のトラブルシューティングに関するページを参照してください。

次の方法で共有

Azure Automation で Runbook を管理する

Runbook を作成する

Azure portal で Runbook を作成する

PowerShell で Runbook を作成する

Runbook をインポートする

Azure portal から Runbook をインポートする

PowerShell で Runbook をインポートする

リソースを処理する

アクティビティログから詳細を取得する

進行状況の追跡

同時実行ジョブの防止

時間に依存するスクリプトの一時的なエラーを処理する

Runbook でロジックを再試行し、一時的なエラーを回避する

例 1: Runbook が 1 つまたは 2 つの呼び出しのみを行う場合

例 2: Runbook が頻繁にリモート呼び出しを行っている場合

複数のサブスクリプションの操作

カスタムスクリプトを使用する

Runbook をテストする

Runbook を発行する

Azure portal で Runbook を発行する

PowerShell を使用して Runbook を発行する

Azure portal で Runbook をスケジュールする

削除した Runbook を復元する

PowerShell スクリプト

ジョブの状態を取得する

Azure portal で状態を表示する

PowerShell を使用してジョブの状態を取得する

次のステップ

フィードバック

その他のリソース

次の方法で共有

Azure Automation で Runbook を管理する

Runbook を作成する

Azure portal で Runbook を作成する

PowerShell で Runbook を作成する

Runbook をインポートする

Azure portal から Runbook をインポートする

PowerShell で Runbook をインポートする

リソースを処理する

アクティビティ ログから詳細を取得する

進行状況の追跡

同時実行ジョブの防止

時間に依存するスクリプトの一時的なエラーを処理する

Runbook でロジックを再試行し、一時的なエラーを回避する

例 1: Runbook が 1 つまたは 2 つの呼び出しのみを行う場合

例 2: Runbook が頻繁にリモート呼び出しを行っている場合

複数のサブスクリプションの操作

カスタム スクリプトを使用する

Runbook をテストする

Runbook を発行する

Azure portal で Runbook を発行する

PowerShell を使用して Runbook を発行する

Azure portal で Runbook をスケジュールする

削除した Runbook を復元する

PowerShell スクリプト

ジョブの状態を取得する

Azure portal で状態を表示する

PowerShell を使用してジョブの状態を取得する

次のステップ

フィードバック

その他のリソース

アクティビティログから詳細を取得する

カスタムスクリプトを使用する