排查 Runbook 问题

Artículo
06/18/2024

本文描述可能会发生的各种 Runbook 问题及其解决方法。有关常规信息，请参阅在 Azure 自动化中执行 Runbook。

不再可以在图形 PowerShell Runbook 中使用导入的非默认模块中的 cmdlet

问题

导入 PowerShell 模块时，你将无法在图形 PowerShell Runbook 中使用其 cmdlet。

原因

为了改进 PowerShell Runbook 的安全状况，该服务不再处理模块清单文件以导出 cmdlet 和函数。这意味着在创作图形 PowerShell Runbook 时无法使用它们。

解决方法

这对现有 Runbook 的执行没有影响。对于使用非默认 PowerShell 模块的新 Runbook，我们建议使用文本 Runbook 而不是图形 PowerShell Runbook 来解决此问题。你可以使用适用于 VScode 的 Azure 自动化扩展来创作和编辑 PowerShell Runbook，它利用 GitHub Copilot 来简化 Runbook 创作体验。

Start-AzAutomationRunbook 失败并显示“runbookName 与预期的模式不匹配”错误消息

问题

运行 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]*$'

原因

Az.Automation 模块 1.9.0 版中引入的代码会验证要启动的 runbook 的名称，并错误地将名称中包含多个“-”字符或一个“_”字符的 runbook 标记为无效。

解决方法

建议将模块还原到 1.8.0 版本。

解决方法

目前，我们正在努力部署修补程序来解决此问题。

诊断 Runbook 问题

如果在 Azure 自动化中执行 Runbook 期间遇到错误，可使用以下步骤来帮助诊断问题：

确保 Runbook 脚本在本地计算机上执行成功。

有关语言参考和学习模块，请参阅 PowerShell 文档或 Python 文档。在本地运行脚本即可发现并解决常见错误，例如：
- 缺少模块
- 语法错误
- 逻辑错误
调查 runbook 错误流。

查看这些流中的特定消息，并将其与本文中所述的错误进行比较。
确保节点和自动化工作区具有所需的模块。

如果 Runbook 导入任何模块，请使用导入模块中的步骤来验证这些模块是否可供自动化帐户使用。按照更新 Azure 自动化中的 Azure PowerShell 模块中的说明将 PowerShell 模块更新到最新版本。有关更多的故障排除信息，请参阅排查模块问题。
如果 Runbook 暂停或意外失败：
- 如果尝试用来启动 Runbook 的 Webhook 已过期，请续订 Webhook。
- 检查作业状态，确定当前 Runbook 状态以及导致问题的一些可能原因。
- 将更多输出添加到 Runbook，以确定 Runbook 在暂停之前发生了什么情况。
- 处理由作业引发的任何异常。
如果混合 Runbook 辅助角色中的 Runbook 作业或环境无响应，请执行此步骤。

如果在混合 Runbook 辅助角色而不是 Azure 自动化中运行 Runbook 作业，可能需要排查混合辅助角色本身的问题。

场景：Runbook 失败，并出现错误消息“this.Client.SubscriptionId 不可为 NULL。“

问题

你的 Runbook 使用托管标识 Connect-AzAccount -Environment AzureChinaCloud -Identity，该标识尝试管理 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

原因

在托管标识（或 Runbook 中使用的其他帐户）尚未被授予任何访问订阅的权限时，可能会发生这种情况。

解决方法

请在订阅中向该托管标识（或 Runbook 中使用的其他帐户）授予相应的角色成员身份。了解详细信息

显示 Azure 角色分配的屏幕截图。

场景：阻止访问 Azure 存储、Azure Key Vault 或 Azure SQL

此场景使用 Azure 存储作为示例。但是，该信息同样适用于 Azure Key Vault 和 Azure SQL。

问题

尝试从 Runbook 访问 Azure 存储会导致类似于以下消息的错误：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 存储上的 Azure 防火墙。

解决方案

在 Azure 存储、Azure Key Vault 或 Azure SQL 上启用 Azure 防火墙会阻止从 Azure 自动化 runbook 访问这些服务。即使启用了允许受信任 Microsoft 服务的防火墙例外，访问也将被阻止，因为自动化不是受信任服务列表的一部分。启用防火墙后，只能使用混合 Runbook 辅助角色和虚拟网络服务终结点进行访问。

场景：Runbook 失败并出现“无权限”或“禁止 403”错误

问题

Runbook 失败并出现“无权限”或“禁止 403”错误或者类似的错误。

原因

运行方式帐户对 Azure 资源的权限可能与当前自动化帐户的权限不同。

解决方法

确保运行方式帐户有权访问脚本中使用的任何资源。

问题

使用 Connect-AzAccount cmdlet 时遇到以下错误之一：

Unknown_user_type: Unknown User Type

No certificate was found in the certificate store with thumbprint

原因

如果凭据资产名称无效，将发生这些错误。如果用于设置自动化凭据资产的用户名和密码无效，也可能会发生这些错误。

解决方法

若要确定问题所在，请执行以下步骤：

确保没有包含任何特殊字符。这些字符包括用于连接 Azure 的自动化凭据资产名称中的 \@ 字符。

查看是否能够在本地 PowerShell ISE 编辑器中使用存储在 Azure 自动化凭据中的用户名和密码。在 PowerShell ISE 中运行以下 cmdlet。

$Cred = Get-Credential
#Using Azure Service Management
Add-AzureAccount -Environment AzureChinaCloud -Credential $Cred  
#Using Azure Resource Manager
Connect-AzAccount -Environment AzureChinaCloud -Credential $Cred

如果该错误看上去是暂时性的，请尝试向身份验证例程添加重试逻辑，使身份验证更加可靠。

$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.

原因

如果使用的不是运行方式帐户或者运行方式帐户已过期，则可能会发生此错误。

此错误有两个主要原因：

使用了不同版本的 AzureRM 或 Az 模块。
正在尝试访问单独订阅中的资源。

解决方法

如果在更新一个 AzureRM 或 Az 模块后遇到此错误，请将所有模块更新为同一版本。

如果你正在尝试访问其他订阅中的资源，请执行以下步骤来配置权限：

转到自动化运行方式帐户，并复制“应用程序 ID”和“指纹”。
访问未托管自动化帐户的订阅的“访问控制”，并添加新的角色分配。
添加前面收集的“应用程序 ID”。选择“参与者”权限。
复制该订阅的名称。

现在，可以使用以下 Runbook 代码来测试从自动化帐户访问其他订阅的权限。请将 <CertificateThumbprint> 替换为在步骤 1 中复制的值。请将 "<SubscriptionName>" 替换为在步骤 4 中复制的值。

$Conn = Get-AutomationConnection -Name AzureRunAsConnection
Connect-AzAccount -Environment AzureChinaCloud -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 cmdlet 时遇到以下错误：

The subscription named <subscription name> cannot be found.

错误

如果存在以下情况，则可能会发生此错误：

订阅名称无效。
尝试获取订阅详细信息的 Microsoft Entra 用户未配置为订阅的管理员。
cmdlet 不可用。
发生上下文切换。

解决方法

有关上下文切换，请参阅 Azure 自动化中的上下文切换。

场景：处理多个订阅时，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 自动化中的上下文切换。

场景：无法在 Azure 中进行身份验证，因为已启用多重身份验证

问题

使用 Azure 用户名和密码在 Azure 中进行身份验证时遇到以下错误：

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

原因

如果对 Azure 帐户设置了多重身份验证，则无法使用 Microsoft Entra 用户向 Azure 进行身份验证。而必须使用证书或服务主体进行身份验证。

解决方法

若要在 Azure 资源管理器 cmdlet 中使用服务主体，请参阅使用 Azure 门户创建服务主体和使用 Azure 资源管理器对服务主体进行身份验证。

场景：Runbook 失败并出现“任务已取消”错误消息

问题

Runbook 失败，出现类似于以下示例的错误：

Exception: A task was cancelled.

原因

使用过时的 Azure 模块会导致此错误。

解决方法

可以通过将 Azure 模块更新到最新版本来解决此错误：

在自动化帐户中选择“模块”，然后选择“更新 Azure 模块”。
更新过程大约需要 15 分钟。完成后，请重新运行失败的 Runbook。

若要了解有关更新模块的详细信息，请参阅“在 Azure 自动化中更新 Azure 模块”。

场景：字词未识别为 cmdlet、函数或脚本的名称

问题

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.

原因

此错误可能是由以下原因造成的：

包含该 cmdlet 的模块未导入到自动化帐户中。
包含该 cmdlet 的模块已导入但已过时。

解决方法

执行以下任务之一来解决此错误：

对于 Azure 模块，请参阅如何更新 Azure 自动化中的 Azure PowerShell 模块，了解如何更新自动化帐户中的模块。
对于非 Azure 模块，请确保将模块导入到自动化帐户中。

方案：对 Azure 自动化中的 PnP PowerShell Runbook 运行 Cmdlet 失败

问题

当 Runbook 直接将 PnP PowerShell 生成的对象写入 Azure 自动化输出时，cmdlet 输出无法流式传输回自动化。

原因

此问题的最常见原因是 Azure 自动化在未捕获返回对象的情况下处理调用 PnP PowerShell cmdlet（例如 add-pnplistitem）的 Runbook。

解决方法

编辑脚本以将任何返回值分配到变量，使 cmdlet 不会尝试将整个对象写入标准输出。脚本可将输出流重定向到 cmdlet，如下所示。

  $null = add-pnplistitem

如果脚本分析 cmdlet 输出，该脚本必须将输出存储在某个变量中，然后操控变量，而不是仅流式传输输出。

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

场景：在执行 Runbook 时无法识别 Cmdlet

问题

Runbook 作业失败并显示错误：

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

原因

当 PowerShell 引擎找不到要在 runbook 中使用的 cmdlet 时，则会导致此错误。可能的原因是帐户中缺少包含该 cmdlet 的模块、与 Runbook 名称存在名称冲突，或者该 cmdlet 也存在于其他模块中，而自动化无法解析该名称。

解决方法

使用以下任一解决方法来解决问题。

确保输入的 cmdlet 名称正确。
确保 cmdlet 存在于自动化帐户中，且没有冲突。若要验证该 cmdlet 是否存在，请在编辑模式下打开一个 Runbook，并搜索希望在库中找到的 cmdlet，或者运行 Get-Command <CommandName>。验证该 cmdlet 可供帐户使用且与其他 cmdlet 或 Runbook 不存在名称冲突以后，可将该 cmdlet 添加到画布。确保使用的是 Runbook 中的有效参数集。
如果存在名称冲突且 cmdlet 可在两个不同的模块中使用，请使用 cmdlet 的完全限定名称来解决问题。例如，可以使用 ModuleName\CmdletName。
如果在本地执行混合辅助角色组中的 Runbook，请确保模块和 cmdlet 已安装在托管混合辅助角色的计算机上。

场景：调用 Add-AzAccount 时对象引用不正确

问题

使用 Add-AzAccount（Connect-AzAccount cmdlet 的别名）时遇到此错误：

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

原因

如果在调用 Add-AzAccount 来添加自动化帐户之前 Runbook 未执行正确的步骤，则可能会发生此错误。例如，必要的步骤之一是使用运行方式帐户登录。有关要在 Runbook 中使用的正确操作，请参阅在 Azure 自动化中执行 Runbook。

场景：对象引用未设置为某个对象的实例

问题

结合 Wait 参数调用子 Runbook 并且输出流包含对象时遇到以下错误：

Object reference not set to an instance of an object

原因

如果流包含对象，Start-AzAutomationRunbook 不会正常处理输出流。

解决方法

实现轮询逻辑，并使用 Get-AzAutomationJobOutput cmdlet 检索输出。下面定义了此逻辑的示例：

$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 状态。

解决方法

使用以下任一解决方案来解决此问题：

如果将复杂对象从一个 cmdlet 传送到另一个 cmdlet，请将这些 cmdlet 包装在 InlineScript 活动中。
传递复杂对象中你所需要的名称或值，不必传递整个对象。
使用 PowerShell Runbook，而不使用 PowerShell 工作流 Runbook。

场景：调用 Webhook 时显示“400 错误的请求”状态

问题

在尝试调用 Azure 自动化 Runbook 的 Webhook 时遇到以下错误：

400 Bad Request : This webhook has expired or is disabled

原因

尝试调用的 Webhook 已禁用，或者已过期。

解决方法

如果 Webhook 处于禁用状态，可以通过 Azure 门户重新启用它。如果 Webhook 已过期，必须将其删除，然后重新创建。如果尚未过期，只能续订 Webhook。

场景：429：当前的请求速率过大

问题

在运行 Get-AzAutomationJobOutput cmdlet 时收到以下错误消息：

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

原因

从包含多个详细流的 Runbook 中检索作业输出时，可能会发生此错误。

解决方法

执行以下操作之一来解决此错误：

编辑 Runbook，并减少它发出的作业流数量。
减少运行 cmdlet 时要检索的流数量。为此，可以设置 Get-AzAutomationJobOutput cmdlet 的 Stream 参数值，以仅检索输出流。

场景：Runbook 输出流大于 1 MB

问题

在 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 块包含对可执行文件或子进程的调用。如果操作引发异常，请让代码将该异常中的消息写入自动化变量中。此方法可防止将消息写入作业输出流中。对于执行的混合 Runbook 辅助角色作业，将显示截断为 1 MB 的输出流，且不显示任何错误消息。

场景：已尝试启动 Runbook 作业三次，但每次都失败

问题

Runbook 失败并出现以下错误：

The job was tried three times but it failed

原因

此错误是由以下问题之一造成的：

内存限制。 如果作业使用的内存超过 400 MB，则它可能会失败。自动化服务限制中阐述了分配给沙盒的内存限制。
网络套接字。 Azure 沙盒限制为 1000 个并发网络套接字。有关详细信息，请参阅自动化服务限制。
模块不兼容。 模块依赖关系可能不正确。在这种情况下，Runbook 通常会返回 Command not found 或 Cannot bind parameter 消息。
未为沙盒设置 Active Directory 身份验证。 Runbook 尝试调用在 Azure 沙盒中运行的可执行文件或子进程。不支持将 Runbook 配置为使用 Azure Active Directory 身份验证库 (ADAL) 通过 Microsoft Entra ID 进行身份验证。

解决方法

内存限制，网络套接字。 若要在内存限制内工作，建议的方法是在多个 Runbook 之间拆分工作负荷，在内存中处理更少的数据，避免从 Runbook 写入不必要的输出，并考虑将多少个检查点写入 PowerShell 工作流 Runbook。使用 clear 方法（例如 $myVar.clear）清除变量并使用 [GC]::Collect 立即运行垃圾回收。这将减少运行时期间 runbook 的内存占用情况。
模块不兼容。 遵循如何更新 Azure 自动化中的 Azure PowerShell 模块中的步骤更新 Azure 模块。
未为沙盒设置 Active Directory 身份验证。 使用 Runbook 向 Microsoft Entra ID 进行身份验证时，请确保 Azure AD 模块在自动化帐户中可用。确保为运行方式帐户授予所需的权限，使其能够执行 Runbook 自动执行的任务。

如果 Runbook 无法调用 Azure 沙盒中运行的可执行文件或子进程，请在混合 Runbook 辅助角色中使用 Runbook。混合辅助角色不受内存和网络限制，而 Azure 沙盒则受限于此限制。

场景：PowerShell 作业失败并出现“无法调用方法”错误消息

问题

某个 Runbook 在 Azure 中运行，而你在该 Runbook 中启动 PowerShell 作业时收到以下错误消息：

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

原因

此错误可能表示在 Azure 沙盒中运行的 Runbook 无法在“完整语言”模式下运行。

解决方法

可通过两种方法来解决此错误：

若要启动 Runbook，请不要使用 Start-Job，而要使用 Start-AzAutomationRunbook。
尝试在混合 Runbook 辅助角色中运行 Runbook。

若要详细了解 Azure 自动化 Runbook 的此行为和其他行为，请参阅在 Azure 自动化中执行 Runbook。

场景：长时间运行的 Runbook 无法完成

问题

运行三小时后，Runbook 显示处于“已停止”状态。此外，可能会遇到以下错误：

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

此行为是 Azure 沙盒的设计使然，因为 Azure 自动化中会对进程进行公平份额监视。如果进程的执行时间超过三小时，公平份额会自动停止 Runbook。超过公平份额时间限制的 Runbook 的状态因 Runbook 类型而异。 PowerShell 和 Python Runbook 设置为“已停止”状态。 PowerShell 工作流 Runbook 设置为“失败”。

原因

Runbook 运行时间超出了 Azure 沙盒中公平份额允许的三小时限制。

解决方法

建议的解决方案是在混合 Runbook 辅助角色上运行 runbook。混合辅助角色不受 Azure 沙盒的三小时公平份额 Runbook 限制。应开发在混合 Runbook 辅助角色上运行的 Runbook，以便在出现意外的本地基础结构问题时支持重启行为。

另一种解决方案是通过创建子 Runbook 来优化 Runbook。如果 Runbook 在多个资源上循环访问同一函数，例如在多个数据库上执行某个数据库操作，可将该函数移到子 Runbook。每个子 Runbook 在单独的进程中并行执行。此行为降低了完成父 runbook 所需的时间总量。

启用子 runbook 方案的 PowerShell cmdlet 是：

Start-AzAutomationRunbook。此 cmdlet 用于启动 Runbook 并将参数传递给该 Runbook。
Get-AzAutomationJob。如果在子 Runbook 完成后需要执行操作，可使用此 cmdlet 检查每个子 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 自动化仅使用 AzureRM 模块启动 Runbook 作业，然后仅使用 Az 模块启动另一个作业，从而导致沙盒崩溃。

解决方法

不建议在同一 Runbook 中使用 Az 和 AzureRM cmdlet。若要详细了解模块的正确用法，请参阅迁移到 Az 模块。

场景：对 Runbook 或应用程序使用 Azure 沙盒时出现“拒绝访问”

问题

当 Runbook 或应用程序尝试在 Azure 沙盒中运行时，环境将拒绝访问。

原因

之所以会出现此问题，是因为 Azure 沙盒会阻止访问所有的进程外 COM 服务器。例如，沙盒应用程序或 Runbook 无法调用 Windows Management Instrumentation (WMI) 或 Windows Installer 服务 (msiserver.exe)。

解决方法

若要详细了解如何使用 Azure 沙盒，请参阅 Runbook 执行环境。

方案：在 Runbook 中使用 Key Vault 时出现“无效且禁止”状态代码

问题

尝试通过 Azure 自动化 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 自动化变量将值传递给 runbook。或者，可以减少参数名称和参数值中的字符数，以确保总长度不超过 30000 个字符。

建议的文档

后续步骤

如果你的问题未在本文中列出，或者你无法解决自己的问题，请尝试通过以下渠道之一获取更多支持：

通过 Azure 论坛获取 Azure 专家的解答
如需更多帮助，可以提交 Azure 支持事件。转到 Azure 支持站点。

Compartir a través de

排查 Runbook 问题

不再可以在图形 PowerShell Runbook 中使用导入的非默认模块中的 cmdlet

问题

原因

解决方法

Start-AzAutomationRunbook 失败并显示“runbookName 与预期的模式不匹配”错误消息

问题

原因

解决方法

解决方法

诊断 Runbook 问题

场景：Runbook 失败，并出现错误消息“this.Client.SubscriptionId 不可为 NULL。“

问题

原因

解决方法

场景：阻止访问 Azure 存储、Azure Key Vault 或 Azure SQL

问题

原因

解决方案

场景：Runbook 失败并出现“无权限”或“禁止 403”错误

问题

原因

解决方法

场景：登录到 Azure 帐户失败

问题

原因

解决方法

场景：运行 Login-AzureRMAccount 进行登录

问题

原因

解决方法

场景：无法找到 Azure 订阅

问题

错误

解决方法

场景：处理多个订阅时，Runbook 失败

问题

原因

解决方法

场景：无法在 Azure 中进行身份验证，因为已启用多重身份验证

问题

原因

解决方法

场景：Runbook 失败并出现“任务已取消”错误消息

问题

原因

解决方法

场景：字词未识别为 cmdlet、函数或脚本的名称

问题

原因

解决方法

方案：对 Azure 自动化中的 PnP PowerShell Runbook 运行 Cmdlet 失败

问题

原因

解决方法

场景：在执行 Runbook 时无法识别 Cmdlet

问题

原因

解决方法

场景：调用 Add-AzAccount 时对象引用不正确

问题

原因

场景：对象引用未设置为某个对象的实例

问题

原因

解决方法

场景：Runbook 因反序列化的对象而失败

问题

原因

解决方法

场景：调用 Webhook 时显示“400 错误的请求”状态

问题

原因

解决方法

场景：429：当前的请求速率过大

问题

原因

解决方法

场景：Runbook 输出流大于 1 MB