microsoft/azure-powershell

Azure PowerShell Docker 镜像文档

1. 镜像概述和主要用途

Azure PowerShell Docker 镜像是 Microsoft 官方提供的容器镜像，预装了 Azure PowerShell 模块。该镜像可直接运行独立的 Docker 容器，用于通过 PowerShell 命令行管理 Azure 资源，也可作为自定义部署的基础镜像使用。镜像标签对应 Az PowerShell 模块 的版本，且基于发布时最新的 https://hub.docker.com/_/microsoft-powershell 构建。

2. 核心功能和特性

核心功能

• 提供管理 Azure 资源的 PowerShell cmdlet 集，支持直接从 PowerShell 命令行操作 Azure 资源
• 基于 .NET Standard 开发，兼容 PowerShell 支持的版本（详见 PowerShell 支持生命周期）

特性

• 易于上手：设计简洁，便于学习和入门
• 自动化能力：提供强大的脚本自动化功能，适合批量操作和流程自动化
• 跨平台支持：支持多种 Linux 发行版（Alpine、Debian、Azure Linux、Ubuntu 等）及架构（amd64、arm64）
• 官方维护：微软官方构建和维护，确保与 Azure 服务的兼容性和安全性

3. 使用场景和适用范围

• 隔离环境管理：需在隔离容器环境中运行 Azure PowerShell 的场景
• 自动化部署：CI/CD 流程中通过脚本自动化 Azure 资源的创建、配置和管理
• 基础镜像构建：作为自定义 Azure 管理工具或应用的基础镜像
• 多平台需求：在不同 Linux 发行版或架构（如 arm64）上运行 Azure PowerShell 的场景

4. 镜像标签信息

主要标签

• https://github.com/Azure/azure-powershell/tree/main/docker/Dockerfile-ubuntu-20.04%EF%BC%9A%E5%8C%85%E5%90%AB%E6%9C%80%E6%96%B0%E7%A8%B3%E5%AE%9A%E7%89%88 Azure PowerShell 模块的镜像
  • 基础系统：Ubuntu 20.04
  • 拉取命令：docker pull mcr.microsoft.com/azure-powershell:latest

5. 使用方法和部署示例

基本使用

通过 docker run 命令直接运行容器，进入交互式 PowerShell 环境：

bash
# 运行指定版本的镜像（替换 <version> 为具体标签，如 latest、14.5.0-ubuntu-24.04 等）
docker run -it mcr.microsoft.com/azure-powershell:<version>

参数说明：

• -i：保持标准输入打开，支持交互
• -t：分配伪终端，提供命令行交互界面

Docker Compose 示例

创建 docker-compose.yml 文件，定义 Azure PowerShell 服务：

yaml
version: '3'
services:
  azure-powershell:
    image: mcr.microsoft.com/azure-powershell:latest
    stdin_open: true  # 对应 -i 参数
    tty: true         # 对应 -t 参数
    # 可选：挂载本地目录以持久化脚本或配置
    volumes:
      - ./scripts:/scripts

启动容器：

bash
docker-compose up -d
docker-compose exec azure-powershell pwsh  # 进入容器内的 PowerShell 环境

6. 配置说明

镜像配置详情请参考官方文档：Azure PowerShell Docker 镜像使用说明

7. 完整标签列表

Linux 镜像

所有可用标签列表可通过以下链接获取：[***]

8. 支持与反馈

支持

如遇镜像相关问题或疑问，请通过 GitHub Issue 联系。

反馈

如需提供反馈，请提交 Issue：反馈渠道

9. 许可证信息

• ***声明：容器许可证信息
• 详细许可证：https://github.com/Azure/azure-powershell/blob/main/LICENSE.txt