Runbook の問題のトラブルシューティング
この記事では、発生する可能性がある 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 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 アカウントと同じでない可能性があります。
解決方法
ご自身の実行アカウントに、お使いのスクリプトで使用されているリソースにアクセスするためのアクセス許可があることを確認してください。
シナリオ:Azure アカウントにサインインできない
問題
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 } }
シナリオ:Login-AzureRMAccount を実行してログインする
問題
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/<subscriptionIdOfSubscriptionWhichDoesntContainTheVM>/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 サポートのサイトに移動して、[サポートの要求] を選択します。