Azure自动化：PowerShell父Runbook如何传递参数给Python子Runbook

核心问题原因 #

你当前使用的$params = @{"args"="Hello"}参数定义不符合Azure Automation的传参规则，Azure不会自动将args键的内容传入Python的sys.argv列表，参数需要和Python Runbook的参数定义一一对应。

推荐方案（命名参数传参，稳定性最高） #

步骤1：修改Python子Runbook，声明命名参数 #

在Python Runbook开头添加Azure Automation可识别的参数声明，示例代码如下：

<#
.PARAMETER greeting
    自定义传入的问候参数
#>
import sys

# 解析传入的命名参数
greeting = ""
for i in range(len(sys.argv)):
    if sys.argv[i] == "--greeting" and i + 1 < len(sys.argv):
        greeting = sys.argv[i+1]

print(f"接收到的参数值为: {greeting}")

步骤2：修改PowerShell父Runbook的调用逻辑 #

优先使用官方支持的Start-AzAutomationRunbook（AzureRm模块已废弃，存在已知传参bug），参数哈希表的键名必须和Python中声明的参数名完全匹配，大小写敏感：

# 定义参数，键名和Python声明的greeting完全一致
$params = @{
    "greeting" = "Hello"
}

# 调用子Runbook，-Wait参数可等待执行完成，方便调试查看结果
$runbookJob = Start-AzAutomationRunbook `
    -ResourceGroupName "你的资源组名称" `
    -AutomationAccountName "你的自动化账户名称" `
    -Name "Python子Runbook的名称" `
    -Parameters $params `
    -Wait

# 查看执行输出确认传参结果
Get-AzAutomationJobOutput `
    -ResourceGroupName "你的资源组名称" `
    -AutomationAccountName "你的自动化账户名称" `
    -Id $runbookJob.JobId

替代方案（位置参数传参） #

如果你不需要命名参数，直接通过sys.argv下标获取参数，可直接按参数位置定义哈希表，键名0对应sys.argv[1]（sys.argv[0]固定为脚本路径）：

# 0对应第一个位置参数
$params = @{
    "0" = "Hello"
}

# 调用逻辑和上述一致
$runbookJob = Start-AzAutomationRunbook `
    -ResourceGroupName "你的资源组名称" `
    -AutomationAccountName "你的自动化账户名称" `
    -Name "Python子Runbook的名称" `
    -Parameters $params `
    -Wait

常见踩坑说明 #

• 参数名大小写敏感，PowerShell侧的哈希表键名必须和Python侧的参数声明完全一致
• 测试阶段建议添加-Wait参数，避免异步执行看不到实时输出误以为传参失败
• 不要使用已废弃的AzureRm模块调用Runbook，存在未修复的传参兼容问题

内容的提问来源于stack exchange，提问作者Florian P.