如何在Azure Function中用PowerShell停止Azure PostgreSQL复制并解决Az命令报错

核心原因 #

默认创建的Azure Function PowerShell环境不会自动包含Az模块，因此调用Get-AzSubscription这类Az系列cmdlet会报错，而基础PowerShell命令不受影响。

解决步骤 #

1. 匹配PowerShell版本与Az模块兼容性 #

• 登录Azure门户，进入你的Function应用，在配置>常规设置中查看当前使用的PowerShell版本（如7.2、7.4）
• 确保后续安装的Az模块支持该版本（最新版Az模块通常兼容PowerShell 7.x系列）

2. 声明Az模块依赖 #

在Function项目的根目录创建requirements.psd1文件，列出你需要的Az模块（比如操作PostgreSQL需要Az.PostgreSql，账户管理需要Az.Accounts），示例内容如下：

@{
    'Az.Accounts' = 'latest'
    'Az.PostgreSql' = 'latest'
}

部署Function时，系统会自动根据这个文件安装指定的模块。

3. 配置托管身份实现无凭据登录 #

Function中无法使用交互式的Connect-AzAccount登录，需通过托管身份实现自动认证：

• 在Azure门户的Function应用>身份>系统分配中，开启状态并保存
• 给该托管身份分配对应权限：进入PostgreSQL服务器所在的资源组，在访问控制(IAM)中添加角色分配，比如授予Contributor角色（或更精细的PostgreSQL管理权限）
• 在Function代码中使用以下命令完成登录：

Connect-AzAccount -Identity

4. 停止PostgreSQL复制的示例代码 #

根据你的服务器类型（灵活服务器/单一服务器）选择对应cmdlet，示例代码如下：

using namespace System.Net

param($Request, $TriggerMetadata)

# 托管身份登录
Connect-AzAccount -Identity

# 指定目标订阅（多订阅场景下需要）
Set-AzContext -SubscriptionId "你的订阅ID"

# 停止灵活服务器的复制
Stop-AzPostgreSqlFlexibleServerReplica -ResourceGroupName "资源组名称" -ServerName "主服务器名称" -ReplicaName "副本服务器名称"

# 如果是单一服务器，替换为以下命令
# Stop-AzPostgreSqlServerReplica -ResourceGroupName "资源组名称" -ServerName "主服务器名称" -ReplicaName "副本服务器名称"

# 返回响应结果
Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
    StatusCode = [HttpStatusCode]::OK
    Body = @{ Status = "PostgreSQL复制已成功停止" }
})

5. 测试与验证 #

• 本地测试：先在本地PowerShell环境安装对应模块，执行命令Install-Module Az.Accounts, Az.PostgreSql -Force，运行代码确认逻辑正常
• 部署后：查看Function的运行日志，确认模块安装成功，测试运行函数检查是否仍存在cmdlet未识别的错误

内容的提问来源于stack exchange，提问作者Ramabadran Sampathkumar