Runbook の問題のトラブルシューティング

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

この記事では、発生する可能性がある Runbook 問題と、その解決方法について説明します。一般的な情報については、「Azure Automation での Runbook の実行」を参照してください。

グラフィカル PowerShell Runbook でインポートされた既定以外のモジュールのコマンドレットは使用できなくなりました

問題点

PowerShell モジュールをインポートすると、グラフィカル PowerShell Runbook でそのコマンドレットを使用できません。

原因

PowerShell Runbook のセキュリティ態勢を向上するため、このサービスで、コマンドレットと関数をエクスポートするためにモジュールマニフェストファイルが処理されなくなりました。つまり、それらは、グラフィカル PowerShell Runbook の作成時に使用できません。

解決方法

既存の Runbook の実行には影響はありません。既定以外の PowerShell モジュールを使用する新しい Runbook の場合、この問題を解決するために、グラフィカル PowerShell Runbook ではなくテキスト Runbook を使用することをお勧めします。 PowerShell Runbook の作成と編集には、GitHub Copilot を利用して Runbook の作成エクスペリエンスを簡素化する、VScode 用の Azure Automation 拡張機能を使用できます。

Start-AzAutomationRunbook が "runbookName does not match expected pattern" というエラーメッセージで失敗する

問題

Start-AzAutomationRunbook を実行して特定の Runbook を開始する場合:

start-azautomationRunbook -Name "Test_2" -AutomationAccountName "AutomationParent" -ResourceGroupName "AutomationAccount"

次のエラーで失敗します:

Start-AzAutomationRunbook: "runbookname" does not match expected pattern '^[a-zA-Z]*-*[a-zA-Z0-9]*$'

原因

1.9.0 バージョンの Az.Automation モジュールで導入されたコードは、Runbook の名前を検証して、複数の "-" 文字または名前に "_" 文字を含む Runbook に無効なフラグを設定します。

回避策

モジュールの 1.8.0 バージョンに戻すことをお勧めします。

解決方法

現在、この問題に対処するための修正プログラムの展開に取り組んでいます。

Runbook の問題を診断する

Azure Automation で Runbook を実行しているときにエラーが発生した場合は、次の手順を使用すると、問題の診断に役立ちます。

ローカルコンピューターで Runbook スクリプトが正常に実行されることを確認します。

言語リファレンスと学習モジュールについては、PowerShell のドキュメントまたは Python のドキュメントを参照してください。スクリプトをローカルで実行すると、次のような一般的なエラーを検出して解決できます。
- モジュールの不足
- 構文エラー
- 論理エラー
Runbook のエラーストリームを調査します。

これらのストリームで特定のメッセージを確認し、この記事に記載されているエラーと比較します。
必要なモジュールがお使いのノードと Automation ワークスペースにあることを確認します。

Runbook でモジュールをインポートする場合は、「モジュールをインポートする」の手順を使用して、それらがお使いの Automation アカウントで使用可能であることを確認します。「Azure Automation の Azure PowerShell モジュールを更新する」の手順に従って、PowerShell モジュールを最新バージョンに更新します。トラブルシューティングの詳細については、モジュールのトラブルシューティングに関する記述を参照してください。
Runbook が中断されたか、予期せず失敗した場合:
- Webhook を更新する (期限切れの Webhook を使用して Runbook を開始しようとしている場合)。
- ジョブの状態を確認して、現在の Runbook の状態と、この問題について考えられるいくつかの原因を特定する。
- 新たな出力を Runbook に追加して、Runbook の中断前に何が発生したかを特定する。
- ジョブによってスローされる例外を処理する。
Runbook ジョブまたは Hybrid Runbook Worker 上の環境が応答しない場合に、この手順を実行します。

Azure Automation ではなく、Hybrid Runbook Worker で Runbook を実行している場合は、ハイブリッド worker 自体のトラブルシューティングが必要になることがあります。

シナリオ: 西ヨーロッパリージョンで新しい Automation ジョブを作成できない

問題

新しい Automation ジョブを作成するときに、ジョブ作成が遅延したり失敗したりする可能性があります。スケジュールされたジョブは自動的に廃止され、ポータルから実行されたジョブは、エラーが発生した場合は廃止できます。

原因

これは、西ヨーロッパリージョンで Automation サービスを使用するお客様の Runbook からの負荷が高いためです。

解決方法

要件と環境に従って実行できる場合は、次の操作を実行して、失敗する可能性を減らします。

通常、ジョブの作成に正時 (12:00、1:00、2:00 など) または正時半を使っている場合は、ジョブの開始時刻を正時または正時半の 5 分前または 5 分後にずらすことをお勧めします。これは、ほとんどのお客様は正時にジョブを実行するのでサービスの負荷が大幅に増加しますが、他のタイムスロットでは負荷は比較的低くなるためです。

シナリオ: Runbook が失敗し、"this.Client.SubscriptionId cannot be null. (this.Client.SubscriptionId を null にすることはできません。)" というエラーメッセージが表示される

問題

マネージド ID Connect-AzAccount -Identity を使用する Runbook が Azure オブジェクトの管理を試行すると、正常に動作せず、エラー this.Client.SubscriptionId cannot be null. がログに記録されます。

get-azvm : 'this.Client.SubscriptionId' cannot be null. At line:5 char:1 + get-azvm + ~~~~~~~~ + CategoryInfo : CloseError: (:) [Get-AzVM], ValidationException + FullyQualifiedErrorId : Microsoft.Azure.Commands.Compute.GetAzureVMCommand

原因

これは、マネージド ID (または Runbook で使用されているその他のアカウント) に、サブスクリプションにアクセスするためのアクセス許可が付与されていない場合に発生することがあります。

解決方法

マネージド ID (または Runbook で使用されているその他のアカウント) に、サブスクリプションの適切なロールメンバーシップを付与してください。詳細情報

Azure ロールの割り当てを示すスクリーンショット。

シナリオ: Azure Storage、Azure Key Vault、または Azure SQL へのブロックされたアクセス

このシナリオでは、Azure Storage を使用します。ただし、この情報は、Azure Key Vault と Azure SQL にも同じように適用できます。

問題

Runbook から Azure Storage にアクセスしようとすると、次のメッセージのようなエラーが発生します: The remote server returned an error: (403) Forbidden. HTTP Status Code: 403 - HTTP Error Message: This request is not authorized to perform this operation.

原因

Azure Storage で Azure Firewall が有効になっています。

解決方法

Azure Storage、Azure Key Vault、または Azure SQL で Azure Firewall を有効にすると、それらのサービスの Azure Automation Runbook からのアクセスがブロックされます。信頼された Microsoft サービスを許可するファイアウォール例外が有効になっている場合でも、Automation は信頼されたサービスの一覧に含まれないため、アクセスはブロックされます。ファイアウォールが有効になっている場合、Hybrid Runbook Worker と仮想ネットワークサービスエンドポイントを使用しないとアクセスできません。

シナリオ: Runbook が "No permission (アクセス許可なし)" または "Forbidden 403 (禁止 403)" エラーで失敗する

問題

Runbook が、"No permission (アクセス許可なし)" または "Forbidden 403 (禁止 403)" エラー、あるいはそれと同等のエラーで失敗します。

原因

実行アカウントの Azure リソースに対するアクセス許可が、現在使用している Automation アカウントと同じでない可能性があります。

解決方法

ご自身の実行アカウントに、お使いのスクリプトで使用されているリソースにアクセスするためのアクセス許可があることを確認してください。

問題

Connect-AzAccount コマンドレットを使用すると、次のいずれかのエラーが表示されます。

Unknown_user_type: Unknown User Type

No certificate was found in the certificate store with thumbprint

原因

これらのエラーは、資格情報資産名が有効でない場合に発生します。 Automation 資格情報資産の設定に使用したユーザー名とパスワードが有効でない場合にも発生する可能性があります。

解決方法

問題を特定するには、次の手順に従います。

特殊文字が使用されていないことを確認します。これらの特殊文字には、Azure に接続するために使用している Automation 資格情報資産名の \@ 文字が含まれます。
ローカルの PowerShell ISE エディターで、Azure Automation 資格情報に格納されているユーザー名とパスワードを使用できるかどうかを確認します。 PowerShell ISE で、次のコマンドレットを実行します。
```
$Cred = Get-Credential
#Using Azure Service Management
Add-AzureAccount -Credential $Cred
#Using Azure Resource Manager
Connect-AzAccount -Credential $Cred
```
ローカルで認証に失敗する場合、Microsoft Entra 資格情報が適切に設定されていません。 Microsoft Entra アカウントを正しく設定するには、Microsoft Entra ID を使用した Azure への認証に関する記事を参照してください。

エラーが一時的なものであると思われる場合は、認証をより堅牢にするために認証ルーチンに再試行ロジックを追加してみてください。

$logonAttempt = 0
$logonResult = $False

while(!($connectionResult) -And ($logonAttempt -le 10))
{
    $LogonAttempt++
    #Logging in to Azure...
    $connectionResult = Connect-AzAccount `
    Start-Sleep -Seconds 30
    if($connectionResult)
    {
       $logonResult = $True 
    }
}

問題

Runbook を実行すると、次のエラーが表示されます。

Run Login-AzureRMAccount to login.

原因

このエラーは、実行アカウントを使用していないとき、または実行アカウントの有効期限が切れたときに発生することがあります。

このエラーには、次の 2 つの主要な原因があります。

さまざまなバージョンの AzureRM または Az モジュールがあります。
別のサブスクリプションのリソースにアクセスしようとしています。

解決方法

1 つの AzureRM または Az モジュールを更新した後でこのエラーが発生する場合は、すべてのモジュールを同じバージョンに更新します。

別のサブスクリプションのリソースにアクセスしようとしている場合は、次の手順に従ってアクセス許可を構成します。

Automation 実行アカウントに移動し、アプリケーション ID とサムプリントをコピーします。
Automation アカウントがホスト "されていない" サブスクリプションの [アクセス制御] に移動し、新しいロールの割り当てを追加します。
前に収集したアプリケーション ID を追加します。 [共同作成者] のアクセス許可を選択します。
サブスクリプションの名前をコピーします。

次の Runbook コードを使用して、Automation アカウントから他のサブスクリプションへのアクセス許可をテストできるようになります。 <CertificateThumbprint> を、手順 1. でコピーした値に置き換えます。 "<SubscriptionName>" を、手順 4. でコピーした値に置き換えます。

$Conn = Get-AutomationConnection -Name AzureRunAsConnection
Connect-AzAccount -ServicePrincipal -Tenant $Conn.TenantID -ApplicationId $Conn.ApplicationID -CertificateThumbprint "<CertificateThumbprint>"
#Select the subscription you want to work with
Select-AzSubscription -SubscriptionName '<YourSubscriptionNameGoesHere>'

#Test and get outputs of the subscriptions you granted access.
$subscriptions = Get-AzSubscription
foreach($subscription in $subscriptions)
{
    Set-AzContext $subscription
    Write-Output $subscription.Name
}

シナリオ: Azure サブスクリプションが見つかりません

問題

Select-AzureSubscription、Select-AzureRMSubscription、または Select-AzSubscription コマンドレットを使用すると、次のエラーが表示されます。

The subscription named <subscription name> cannot be found.

Error

このエラーは、次の場合に発生する可能性があります。

サブスクリプション名が有効ではない。
サブスクリプションの詳細を取得しようとしている Microsoft Entra ユーザーは、サブスクリプションの管理者として構成されていません。
そのコマンドレットが使用できない。
コンテキスト切り替えが発生した。

解決方法

コンテキスト切り替えについては、「Azure Automation でのコンテキスト切り替え」を参照してください。

シナリオ: 複数のサブスクリプションを処理するときに Runbook が失敗する

問題

Runbook を実行したときに、Runbook が Azure リソースを管理できません。

原因

Runbook が、実行中に正しいコンテキストを使用していません。 Runbook が誤って間違ったサブスクリプションにアクセスしようとしたことが原因である可能性があります。

次のようなエラーが表示されることがあります。

Get-AzVM : The client '<client-id>' with object id '<object-id> does not have authorization to perform action 'Microsoft.Compute/virtualMachines/read' over scope '/subscriptions/<subcriptionIdOfSubscriptionWichDoesntContainTheVM>/resourceGroups/REsourceGroupName/providers/Microsoft.Compute/virtualMachines/VMName '.
   ErrorCode: AuthorizationFailed
   StatusCode: 403
   ReasonPhrase: Forbidden Operation
   ID : <AGuidRepresentingTheOperation> At line:51 char:7 + $vm = Get-AzVM -ResourceGroupName $ResourceGroupName -Name $UNBV... +

次のようなエラーが表示されることもあります。

Get-AzureRmResource : Resource group "SomeResourceGroupName" could not be found.
... resources = Get-AzResource -ResourceGroupName $group.ResourceGro ...
                 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : CloseError: (:) [Get-AzResource], CloudException
    + FullyQualifiedErrorId : Microsoft.Azure.Commands.ResourceManager.Cmdlets.Implementation.GetAzureResourceCmdlet

解決方法

誤って間違ったサブスクリプションにアクセスしようとするのを防ぐために、「Azure Automation でのコンテキスト切り替え」を参照してください。

シナリオ:多要素認証が有効になっているために Azure に対する認証が失敗する

問題

Azure のユーザー名とパスワードで Azure に対して認証するときに、次のエラーを受け取ります。

Add-AzureAccount: AADSTS50079: Strong authentication enrollment (proof-up) is required

原因

Azure アカウントに多要素認証がある場合、Microsoft Entra ユーザーを使用して Azure に対する認証を行うことはできません。代わりに、証明書またはサービスプリンシパルを使用して認証する必要があります。

解決方法

Azure Resource Manager コマンドレットでサービスプリンシパルを使用する場合は、Azure portal を使用するサービスプリンシパルの作成および Azure Resource Manager でのサービスプリンシパルの認証に関するページを参照してください。

シナリオ:Runbook が "A task was canceled" (タスクが取り消されました) というエラーメッセージで失敗する

問題

Runbook が、次の例のようなエラーで失敗します。

Exception: A task was cancelled.

原因

以前のバージョンの Azure モジュールを使用すると、このエラーが発生する可能性があります。

解決方法

このエラーは、Azure モジュールを最新バージョンに更新することで解決できます。

Automation アカウントで、 [モジュール] を選択し、 [Azure モジュールの更新] を選択します。
更新には約 15 分かかります。完了したら、失敗した Runbook を再実行します。

モジュールの更新の詳細については、「Azure Automation で Azure モジュールを更新する」を参照してください。

シナリオ:コマンドレット、関数、またはスクリプトの名前として用語が認識されない

問題

Runbook が、次の例のようなエラーで失敗します。

The term 'Connect-AzAccount' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if the path was included verify that the path is correct and try again.

原因

このエラーは、次の理由で発生する可能性があります。

コマンドレットを含むモジュールが、Automation アカウントにインポートされていない。
コマンドレットを含むモジュールはインポートされているが、最新ではない。

解決方法

このエラーを解決するには、次のいずれかのタスクを実行します。

Azure モジュールの場合は、Automation アカウントでモジュールを更新する方法について、「Azure Automation の Azure PowerShell モジュールを更新する方法」を参照してください。
Azure 以外のモジュールの場合は、モジュールが Automation アカウントにインポートされていることを確認してください。

シナリオ: Azure Automation の PnP PowerShell Runbook でコマンドレットが失敗する

問題

PnP PowerShell で生成されたオブジェクトが Runbook から Azure Automation の出力に直接書き込まれると、コマンドレットの出力をオートメーションにストリームバックすることができません。

原因

この問題は、戻りオブジェクトをキャッチせずに、add-pnplistitem などの PnP PowerShell コマンドレットを呼び出す Runbook を Azure Automation で処理する場合に最もよく発生します。

解決方法

スクリプトを編集して戻り値を変数に割り当て、コマンドレットでオブジェクト全部が標準出力に書き出されないようにします。次に示すように、スクリプトを使って出力ストリームをコマンドレットにリダイレクトできます。

  $null = add-pnplistitem

スクリプトを使ってコマンドレットの出力を解析する場合は、単に出力をストリーミングするのではなく、スクリプトで出力を変数に格納し、変数を操作する必要があります。

$SomeVariable = add-pnplistitem ....
if ($SomeVariable.someproperty -eq ....

シナリオ: Runbook の実行時にコマンドレットが認識されない

問題

Runbook ジョブがエラーで失敗します。

<cmdlet name>: The term <cmdlet name> is not recognized as the name of a cmdlet, function, script file, or operable program.

原因

このエラーは、Runbook で使用しているコマンドレットを PowerShell エンジンが見つけられないときに発生します。コマンドレットを含むモジュールがアカウントにないか、Runbook 名に名前の競合があるか、あるいはコマンドレットが別のモジュールにも存在していて Automation で名前を解決できない可能性があります。

解決方法

問題を解決するには、次のいずれかの解決策を使用します。

コマンドレット名を正しく入力したことを確認します。
確実に、コマンドレットが Automation アカウントに存在し、競合がないようにします。コマンドレットの存在を確認するには、Runbook を編集モードで開き、ライブラリで見つけるコマンドレットを検索するか、Get-Command <CommandName> を実行します。コマンドレットがアカウントで利用できることと他のコマンドレットや Runbook と名前が競合しないことを確認したら、コマンドレットをキャンバスに追加します。お使いの Runbook に設定されている有効なパラメーターを使用していることを確認してください。
名前が競合し、コマンドレットが 2 つの異なるモジュールで利用できる場合、コマンドレットの完全修飾名を利用することで、問題を解決します。たとえば、ModuleName\CmdletName を使用できます。
ハイブリッド worker グループでオンプレミスの Runbook を実行する場合は、ハイブリッド worker をホストするマシンにモジュールとコマンドレットが確実にインストールされているようにします。

シナリオ: Add-AzAccount の呼び出し時にオブジェクト参照が正しくない

問題

Connect-AzAccount コマンドレットのエイリアスである Add-AzAccount を使用すると、次のエラーが表示されます。

Add-AzAccount : Object reference not set to an instance of an object

原因

このエラーは、Add-AzAccount を呼び出して Automation アカウントを追加する前に Runbook で適切な手順が実行されなかった場合に発生する可能性があります。必要な手順の一例として、実行アカウントでのサインインが挙げられます。 Runbook で使用する正しい操作については、「Azure Automation での Runbook の実行」をご覧ください。

シナリオ:オブジェクト参照がオブジェクトインスタンスに設定されていない

問題

Wait パラメーターを使用して子 Runbook を呼び出したときに、出力ストリームにオブジェクトが含まれていると、次のエラーが表示されます。

Object reference not set to an instance of an object

原因

ストリームにオブジェクトが含まれている場合、Start-AzAutomationRunbook で出力ストリームが正しく処理されません。

解決方法

ポーリングロジックを実装し、Get-AzAutomationJobOutput コマンドレットを使用して出力を取得します。このロジックのサンプルは次のように定義されます。

$AutomationAccountName = "ContosoAutomationAccount"
$RunbookName = "ChildRunbookExample"
$ResourceGroupName = "ContosoRG"

function IsJobTerminalState([string]$Status) {
  $TerminalStates = @("Completed", "Failed", "Stopped", "Suspended")
  return $Status -in $TerminalStates
}

$StartAzAutomationRunbookParameters = @{
  Name = $RunbookName
  AutomationAccountName = $AutomationAccountName
  ResourceGroupName = $ResourceGroupName
}
$Job = Start-AzAutomationRunbook @StartAzAutomationRunBookParameters
$PollingSeconds = 5
$MaxTimeout = New-TimeSpan -Hours 3 | Select-Object -ExpandProperty TotalSeconds
$WaitTime = 0
while(-NOT (IsJobTerminalState $Job.Status) -and $WaitTime -lt $MaxTimeout) {
   Start-Sleep -Seconds $PollingSeconds
   $WaitTime += $PollingSeconds
   $Job = $Job | Get-AzAutomationJob
}

$Job | Get-AzAutomationJobOutput | Get-AzAutomationJobOutputRecord | Select-Object -ExpandProperty Value

シナリオ: 逆シリアル化されたオブジェクトであるため、Runbook が失敗する

問題

Runbook がエラーで失敗します。

Cannot bind parameter <ParameterName>.

Cannot convert the <ParameterType> value of type Deserialized <ParameterType> to type <ParameterType>.

原因

Runbook が PowerShell ワークフローの場合、ワークフローが中断された場合に Runbook の状態を維持できるように、複雑なオブジェクトが逆シリアル化形式で保存されます。

解決方法

この問題を解決するには、次のいずれかの解決策を使用します。

コマンドレット間で複雑なオブジェクトをパイプ処理する場合、これらのコマンドレットを InlineScript アクティビティでラップします。
オブジェクト全体を渡すのではなく、複雑なオブジェクトから、必要な名前または値を渡します。
PowerShell ワークフロー Runbook ではなく PowerShell Runbook を使用します。

シナリオ: Webhook を呼び出すときに 400 Bad Request 状態が発生する

問題

Azure Automation Runbook の Webhook を呼び出そうとすると、次のエラーが表示されます。

400 Bad Request : This webhook has expired or is disabled

原因

呼び出そうとしている Webhook が、無効または期限切れです。

解決方法

Webhook が無効な場合は、Azure portal から再度有効にすることができます。 Webhook の有効期限が切れている場合は、削除してから再作成する必要があります。 Webhook がまだ期限切れでない場合にのみ、Webhook を更新できます。

シナリオ:429:The request rate is currently too large (現在、要求率が大きすぎます)

問題

Get-AzAutomationJobOutput コマンドレットを実行すると、次のエラーメッセージを受け取ります。

429: The request rate is currently too large. Please try again

原因

このエラーは、多数の詳細ストリームがある Runbook からジョブ出力を取得するときに発生する可能性があります。

解決方法

このエラーを解決するには、次のいずれかの操作を行います。

Runbook を編集し、出力されるジョブストリームの数を減らします。
コマンドレットを実行するときに取得されるストリーム数を減らします。これを行うために、Get-AzAutomationJobOutput コマンドレットの Stream パラメーターに値を設定して、出力ストリームのみを取得できます。

シナリオ: 割り当てられたクォータを超えたために Runbook ジョブが失敗する

問題

Runbook ジョブがエラーで失敗します。

The quota for the monthly total job run time has been reached for this subscription

原因

ジョブの実行がアカウントの 500 分の無料クォータを超えるとこのエラーが発生します。このクォータは、すべての種類のジョブ実行タスクに適用されます。これらのタスクには、ジョブのテスト、ポータルからのジョブの開始、Webhook を使用したジョブの実行、Azure portal またはデータセンターを使用して実行するジョブのスケジュール設定などがあります。 Automation の料金については、「Automation の料金」を参照してください。

解決方法

毎月 500 分を超える処理を使用する場合は、サブスクリプションを Free レベルから Basic レベルに変更します。

Azure サブスクリプションにサインインします。
アップグレードする Automation アカウントを選択します。
[設定] を選択し、[価格] を選択します。
ページの下部にある [有効] を選択して、アカウントを Basic レベルにアップグレードします。

シナリオ: 1 MB を超える Runbook 出力ストリーム

問題

Azure サンドボックス内で実行されている Runbook が次のエラーで失敗します。

The runbook job failed due to a job stream being larger than 1MB, this is the limit supported by an Azure Automation sandbox.

原因

このエラーは、Runbook による例外データの出力ストリームへの書き込みが過剰に試行されると発生します。

解決方法

ジョブ出力ストリームでは 1 MB の制限があります。 Runbook で、try および catch ブロックを使用して、実行可能ファイルまたはサブプロセスへの呼び出しを確実に囲むようにします。操作で例外がスローされる場合は、コードによってその例外から Automation 変数にメッセージを書き込みます。この手法により、メッセージがジョブ出力ストリームに書き込まれなくなります。 Hybrid Runbook Worker ジョブを実行すると、出力ストリームが 1 MB に切り捨てられ、エラーメッセージは表示されません。

シナリオ: Runbook ジョブの開始が 3 回試行されましたが、毎回開始に失敗する

問題

Runbook が次のエラーで失敗します。

The job was tried three times but it failed

原因

このエラーは、次のいずれかの問題が原因で発生します。

メモリの制限。 400 MB を超えるメモリを使用すると、ジョブが失敗する可能性があります。サンドボックスに割り当てられるメモリの制限については、Automation サービスの制限に関するセクションを参照してください。
ネットワークソケット。 Azure サンドボックスの同時ネットワークソケット数は 1,000 に制限されています。詳細については、 Automation サービスの制限に関するページを参照してください。
モジュールに互換性がない。 モジュールの依存関係が正しくない可能性があります。この場合、Runbook では通常、Command not found または Cannot bind parameter メッセージが返されます。
サンドボックスで Active Directory による認証が行われない。 Runbook で、Azure サンドボックス内で実行されている実行可能ファイルまたはサブプロセスを呼び出そうとしました。 Azure Active Directory 認証ライブラリ (ADAL) を使用して Microsoft Entra ID で認証するように Runbook を構成することはサポートされていません。

解決方法

メモリの制限、ネットワークソケット。 メモリの制限内で問題を解決するために推奨される方法としては、複数の Runbook 間でワークロードを分割する、メモリ内のデータの処理量を減らす、Runbook からの不要な出力を書き込まない、PowerShell Workflow Runbook に書き込むチェックポイントの数を検討する、などがあります。 $myVar.clear などの clear メソッドを使用して変数をクリアし、[GC]::Collect を使用してガベージコレクションをすぐに実行します。これにより、実行時の Runbook のメモリ専有領域が小さくなります。
モジュールに互換性がない。 「Azure Automation の Azure PowerShell モジュールを更新する方法」の手順に従って Azure モジュールを更新します。
サンドボックスで Active Directory による認証が行われない。 Runbook を使用して Microsoft Entra ID に対して認証を行う場合は、Automation アカウントで Azure AD モジュールを使用できることを確認します。 Runbook によって自動化されるタスクを実行するために必要なアクセス許可を、必ず実行アカウントに付与してください。

Azure サンドボックスで実行されている実行可能ファイルまたはサブプロセスを Runbook で呼び出すことができない場合は、Hybrid Runbook Worker で Runbook を使用します。ハイブリッド worker には、Azure サンドボックスに存在するようなメモリとネットワークの制限はありません。

シナリオ: PowerShell ジョブが失敗し、「メソッドを呼び出すことができません」というエラーメッセージが表示される

問題

Azure で実行されている Runbook で PowerShell ジョブを開始すると、次のエラーメッセージが表示されます。

Exception was thrown - Cannot invoke method. Method invocation is supported only on core types in this language mode.

原因

このエラーは、Azure サンドボックスで実行されている Runbook を、完全言語モードで実行できないことを示している可能性があります。

解決方法

このエラーを解決するには、次の 2 つの方法があります。

Start-Job を使用する代わりに Start-AzAutomationRunbook を使用して、Runbook を開始します。
Hybrid Runbook Worker で Runbook を実行してみます。

この動作や、Azure Automation Runbook の他の動作の詳細については、「Azure Automation での Runbook の実行」をご覧ください。

シナリオ:実行時間の長い Runbook が完了しない

問題

Runbook が 3 時間の実行の後、停止状態になります。このエラーが表示されることもあります。

The job was evicted and subsequently reached a Stopped state. The job cannot continue running.

これは、Azure Automation 内のプロセスのフェアシェア監視のための、Azure サンドボックスでの設計による動作です。プロセスの実行時間が 3 時間を超えた場合、フェアシェアによって自動的に Runbook が停止されます。フェアシェアの時間の制限を超える Runbook の状態は、Runbook の種類によって異なります。 PowerShell および Python Runbook は、停止状態に設定されます。 PowerShell Workflow Runbook は、失敗に設定されます。

原因

Runbook が、Azure サンドボックスのフェアシェアによって許可されている 3 時間の制限を超えて実行されました。

解決方法

推奨される解決策の 1 つは、Hybrid Runbook Worker で Runbook を実行することです。ハイブリッド worker には、Azure サンドボックスに存在するフェアシェアによる 3 時間の Runbook 制限は適用されません。予期しないローカルインフラストラクチャの問題が発生した場合の再起動動作をサポートするには、Hybrid Runbook Worker 上で実行される Runbook を開発する必要があります。

もう 1 つの解決策は、子 Runbook を作成して Runbook を最適化することです。 Runbook で、複数のリソースに対して同じ関数をループ処理する場合 (複数のデータベースに対するデータベース処理などで)、関数を子 Runbook に移動することができます。各子 Runbook は、別のプロセスで並列に実行されます。この動作によって、親 Runbook の完了までにかかる合計時間は減ります。

子 Runbook のシナリオを実現する PowerShell コマンドレットは次のとおりです。

Start-AzAutomationRunbook。このコマンドレットを使用すると、Runbook を起動し、パラメーターを Runbook に渡すことができます。
Get-AzAutomationJob。子 Runbook の完了後に実行する必要がある操作がある場合は、このコマンドレットを使用して、各子のジョブの状態を確認できます。

シナリオ:ジョブストリームで get_SerializationSettings メソッドに関するエラーが発生する

問題

Runbook のジョブストリームで、次のエラーが表示されます。

Connect-AzAccount : Method 'get_SerializationSettings' in type
'Microsoft.Azure.Management.Internal.Resources.ResourceManagementClient' from assembly
'Microsoft.Azure.Commands.ResourceManager.Common, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35'
does not have an implementation.
At line:16 char:1
+ Connect-AzAccount -ServicePrincipal -Tenant $Conn.TenantID -Appl ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (:) [Connect-AzAccount], TypeLoadException
    + FullyQualifiedErrorId : System.TypeLoadException,Microsoft.Azure.Commands.Profile.ConnectAzAccountCommand

原因

このエラーは、Runbook 内で AzureRM モジュールから Az モジュールへの不完全な移行を使用した場合に発生する可能性があります。この状況が原因で、Azure Automation で Runbook ジョブが AzureRM モジュールのみを使用して開始された後、Az モジュールのみを使用して別のジョブが開始され、サンドボックスのクラッシュにつながる可能性があります。

解決方法

Az と AzureRM のコマンドレットを同じ Runbook で使用することはお勧めできません。これらのモジュールの正しい使用方法について詳しくは、「Az モジュールへの移行」をご覧ください。

シナリオ: Runbook またはアプリケーションに Azure サンドボックスを使用しているときにアクセスが拒否される

問題

Runbook またはアプリケーションを Azure サンドボックスで実行しようとすると、環境によってアクセスが拒否されます。

原因

この問題は、Azure サンドボックスですべてのアウトプロセス COM サーバーへのアクセスが阻止されることが原因で発生することがあります。たとえば、サンドボックスアプリケーションまたは Runbook では、Windows Management Instrumentation (WMI) や Windows インストーラーサービス (msiserver.exe) を呼び出すことはできません。

解決方法

Azure サンドボックスの使用について詳しくは、「Runbook の実行環境」をご覧ください。

シナリオ: Runbook 内で Key Vault を使用する場合の無効な禁止状態コード

問題

Azure Automation Runbook を介して Azure Key Vault にアクセスしようとすると、次のエラーが表示されます。

Operation returned an invalid status code 'Forbidden'

原因

この問題の原因としては、次のようなことが考えられます。

実行アカウントを使用していない。
権限が不足しています。

解決方法

実行アカウントを使用していない

「手順 5 - Azure リソースを管理するための認証を追加する」に従って、Key Vault へのアクセスに実行アカウントを使用するようにします。

アクセス許可が不十分です

Key Vault へのアクセス許可を追加して、Key Vault にアクセスするための十分なアクセス許可が実行アカウントに付与されるようにします。

シナリオ: Runbook が "パラメーターの長さ超過" というエラーで失敗する

問題

Runbook でパラメーターが使用されており、次のエラーで失敗します。

Total Length of Runbook Parameter names and values exceeds the limit of 30,000 characters. To avoid this issue, use Automation Variables to pass values to runbook.

原因

Python 2.7、Python 3.8、および PowerShell 7.1 Runbook で提供できるすべてのパラメーターの文字数には制限があります。すべてのパラメーター名とパラメーター値の合計長は、30,000 文字を超えることはできません。

解決方法

この問題を解決するには、Azure Automation 変数を使用して Runbook に値を渡すことができます。または、パラメーター名とパラメーター値の文字数を減らして、合計長が 30,000 文字を超えないようにすることもできます。

推奨されるドキュメント

次のステップ

お客様の問題がここになかった場合、または問題を解決できない場合は、次のいずれかのチャネルでサポートを受けてください。

Azure フォーラムを通じて Azure エキスパートから回答を得ることができます。
@AzureSupport (カスタマーエクスペリエンスを向上させるための Microsoft Azure の公式アカウント) に連絡する。回答、サポート、エキスパートについて、Azure サポートがお客様を Azure コミュニティにご案内します。
さらにヘルプが必要であれば、Azure サポートインシデントを送信できます。 Azure サポートのサイトに移動して、[サポートの要求] を選択します。

Share via

Runbook の問題のトラブルシューティング

グラフィカル PowerShell Runbook でインポートされた既定以外のモジュールのコマンドレットは使用できなくなりました

問題点

原因

解決方法

Start-AzAutomationRunbook が "runbookName does not match expected pattern" というエラー メッセージで失敗する

問題

原因

回避策

解決方法

Runbook の問題を診断する

シナリオ: 西ヨーロッパ リージョンで新しい Automation ジョブを作成できない

問題

原因

解決方法

シナリオ: Runbook が失敗し、"this.Client.SubscriptionId cannot be null. (this.Client.SubscriptionId を null にすることはできません。)" というエラー メッセージが表示される

問題

原因

解決方法

シナリオ: Azure Storage、Azure Key Vault、または Azure SQL へのブロックされたアクセス

問題

原因

解決方法

シナリオ: Runbook が "No permission (アクセス許可なし)" または "Forbidden 403 (禁止 403)" エラーで失敗する

問題

原因

解決方法

シナリオ:Azure アカウントにサインインできない

問題

原因

解決方法

シナリオ:Login-AzureRMAccount を実行してログインする

問題

原因

解決方法

シナリオ: Azure サブスクリプションが見つかりません

問題

Error

解決方法

シナリオ: 複数のサブスクリプションを処理するときに Runbook が失敗する

問題

原因

解決方法

シナリオ:多要素認証が有効になっているために Azure に対する認証が失敗する

問題

原因

解決方法

シナリオ:Runbook が "A task was canceled" (タスクが取り消されました) というエラー メッセージで失敗する

問題

原因

解決方法

シナリオ:コマンドレット、関数、またはスクリプトの名前として用語が認識されない

問題

原因

解決方法

シナリオ: Azure Automation の PnP PowerShell Runbook でコマンドレットが失敗する

問題

原因

解決方法

シナリオ: Runbook の実行時にコマンドレットが認識されない

問題

原因

解決方法

シナリオ: Add-AzAccount の呼び出し時にオブジェクト参照が正しくない

問題

原因

シナリオ:オブジェクト参照がオブジェクト インスタンスに設定されていない

問題

原因

解決方法

シナリオ: 逆シリアル化されたオブジェクトであるため、Runbook が失敗する

問題

原因

解決方法

シナリオ: Webhook を呼び出すときに 400 Bad Request 状態が発生する

問題

原因

解決方法

シナリオ:429:The request rate is currently too large (現在、要求率が大きすぎます)

Start-AzAutomationRunbook が "runbookName does not match expected pattern" というエラーメッセージで失敗する

シナリオ: 西ヨーロッパリージョンで新しい Automation ジョブを作成できない

シナリオ: Runbook が失敗し、"this.Client.SubscriptionId cannot be null. (this.Client.SubscriptionId を null にすることはできません。)" というエラーメッセージが表示される

シナリオ:Runbook が "A task was canceled" (タスクが取り消されました) というエラーメッセージで失敗する

シナリオ:オブジェクト参照がオブジェクトインスタンスに設定されていない

シナリオ: PowerShell ジョブが失敗し、「メソッドを呼び出すことができません」というエラーメッセージが表示される

シナリオ:ジョブストリームで get_SerializationSettings メソッドに関するエラーが発生する