如何通过命令行为Azure虚拟机配置.NET 5.0运行环境？

核心适配原则 #

• 全流程零弹窗、零人工交互，完全适配虚拟机创建完成后后台自动触发的脚本执行环境
• 脚本具备幂等性，重复执行不会出现重复安装、文件覆盖冲突的问题
• 每个安装节点都带校验逻辑，安装失败直接抛出明确错误码，方便后续自动化流程定位问题

具体脚本实现步骤 #

• 第一步：初始化脚本运行环境，临时放开当前进程的脚本执行策略，避免系统默认的执行策略拦截安装动作，对应命令：
  Set-ExecutionPolicy Bypass -Scope Process -Force
• 第二步：调用微软官方提供的dotnet-install.ps1纯命令行工具完成无交互安装，关键参数配置：
• 安装类型指定为aspnetcore运行时，一次装齐.NET 5.0 Web应用运行所需的全部依赖，不需要额外安装SDK组件
• 锁定安装版本为5.0系列的最终补丁版本，避免拉取预览版带来的兼容性问题
• 指定固定安装路径，安装完成后自动写入系统全局环境变量，供后续启动的应用进程识别
• 第三步：安装结果校验
  运行校验命令dotnet --list-runtimes，检查输出结果中是否存在.NET 5.0版本的ASP.NET Core运行时条目；如果校验不通过，直接抛出错误终止脚本流程
  注意：如果安装完成后要在同一脚本进程内直接调用dotnet命令，需要手动把dotnet安装路径追加到当前进程的$env:Path变量中，否则会触发命令找不到的报错

常见踩坑提醒 #

• 不要照搬手动双击msi包的安装逻辑：msi安装包默认会弹出交互安装向导，在无桌面交互的虚拟机后台执行场景下，向导窗口无人操作会直接卡住整个部署流程，必须使用带静默参数的安装命令，或者纯命令行的无交互安装模式
• 注意匹配PowerShell进程架构：32位PowerShell进程会自动下载对应32位版本的运行时，要确保脚本以64位PowerShell进程运行，匹配64位服务器系统的架构需求
• 安装顺序要前置：必须在启动.NET应用之前完成运行时安装，不要等应用启动失败了再补装依赖，否则会出现环境变量未全局生效的问题

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