Azure Flex PowerShell函数中PSWSMan无法使用的问题求助

针对你遇到的Linux Flex计划下PowerShell函数执行WinRM脚本的问题，以下是实际可落地的解决方法：

核心解决思路：自定义容器镜像（推荐） #

Linux Flex计划基于容器运行，运行时无法获取root权限执行Install-WSMan，且托管依赖无法处理系统级模块初始化，因此必须通过自定义镜像提前完成PSWSMan安装和WSMan配置：

1. 准备Dockerfile
   基于官方Azure PowerShell函数镜像构建，示例内容：

# 基础镜像，选择对应PowerShell版本的函数镜像
FROM mcr.microsoft.com/azure-functions/powershell:4-python3.10

# 切换到root用户执行系统级操作
USER root

# 安装PSWSMan所需的系统依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    curl \
    gnupg \
    apt-transport-https \
    libssl-dev \
    && rm -rf /var/lib/apt/lists/*

# 安装PSWSMan模块并初始化WSMan
RUN pwsh -Command "Install-Module -Name PSWSMan -Confirm:\$False -Force -Scope AllUsers"
RUN pwsh -Command "Install-WSMan -Force"

# 切换回函数运行的非root用户
USER app

# 设置函数应用的环境变量（可选，根据你的需求调整）
ENV AzureWebJobsScriptRoot=/home/site/wwwroot \
    AzureFunctionsJobHost__Logging__Console__IsEnabled=true

2. 构建并推送镜像

• 构建镜像：docker build -t <你的ACR名称>.azurecr.io/flex-pwsh-winrm:v1 .
• 登录Azure容器注册表：az acr login --name <你的ACR名称>
• 推送镜像：docker push <你的ACR名称>.azurecr.io/flex-pwsh-winrm:v1

3. 配置Flex函数应用使用自定义镜像
   在Azure门户中找到你的Flex函数应用，进入「容器设置」，选择「自定义容器」，填入ACR中的镜像地址，配置好注册表凭据后保存，函数应用会重启并使用自定义镜像。

解决无Kudu控制台的问题 #

Linux Flex计划确实没有Kudu，但可以通过以下方式访问终端：

• Azure CLI连接容器：找到Flex函数对应的容器实例（在资源组中可找到），执行命令：

  az container exec --resource-group <你的资源组名> --name <容器实例名> --exec-command "/bin/bash"
  

• 自定义镜像中启用SSH：在Dockerfile中添加SSH配置，这样可以通过Azure门户的「SSH」功能直接连接：

  # 在root用户阶段添加
  RUN apt-get install -y openssh-server \
      && echo "root:Docker!" | chpasswd \
      && sed -i 's/#PermitRootLogin prohibit-password/PermitRootLogin yes/' /etc/ssh/sshd_config \
      && service ssh start
  EXPOSE 2222
  

  然后在函数应用的「容器设置」中添加环境变量SSH_PORT=2222，即可在门户中通过SSH连接。

关于托管依赖无效的说明 #

Linux PowerShell函数的requirements.psd1托管依赖仅负责下载模块文件，但PSWSMan需要系统级依赖（如libssl）和root权限执行Install-WSMan初始化，因此单纯放置模块文件无法生效，必须通过自定义镜像提前完成所有依赖配置。

替代方案：使用启动脚本（仅应急，不推荐） #

如果暂时无法构建自定义镜像，可以尝试在函数应用的「应用设置」中添加WEBSITE_RUN_FROM_PACKAGE=0，然后在home/site/wwwroot下添加startup.sh脚本（需要通过Azure存储浏览器或CLI上传），脚本内容：

#!/bin/bash
# 切换到root执行初始化（部分环境可能允许，但不保证兼容性）
sudo pwsh -Command "Install-Module -Name PSWSMan -Confirm:\$False -Force -Scope AllUsers"
sudo pwsh -Command "Install-WSMan -Force"
# 启动函数宿主
func start

但该方案依赖环境允许sudo，且冷启动延迟极高，仅作为临时测试使用。

内容的提问来源于stack exchange，提问作者Alex Asirvatham