azuresdk/azure-powershell-core

Microsoft Azure PowerShell

https://github.com/Azure/azure-powershell

本镜像包含一套PowerShell cmdlet，供开发者和管理员开发、部署及管理Microsoft Azure应用程序。

• 有关如何构建和部署应用到Microsoft Azure的文档，请参阅Microsoft Azure文档中心。
• 有关开发者cmdlet的完整文档，请查看Azure PowerShell概述。
• 若需提出改进建议，请参与改进讨论(https://github.com/Azure/azure-powershell/issues/3692)%E3%80%82

核心功能

• 账户管理
  • 通过Microsoft Azure Active Directory使用Microsoft账户、组织账户或服务主体登录
  • 使用Save-AzureRmContext保存凭据到磁盘，使用Import-AzureRmContext加载已保存的凭据
• 环境管理
  • 获取不同的开箱即用Microsoft Azure环境
  • 添加/设置/删除自定义环境（如Azure Stack或Windows Azure Pack环境）
• ARM和RDFE中Azure服务的管理和数据平面cmdlet
  • 虚拟机
  • 应用服务（网站）
  • SQL数据库
  • 存储
  • 网络

有关cmdlet的详细描述和示例，请输入：

• Get-Help Azure 获取所有Azure PowerShell cmdlet
• Get-Help AzureRM 获取所有Azure Resource Manager (ARM) cmdlet
• Get-Help <cmdlet名称> 获取特定cmdlet的详细信息

使用场景

适用于管理以下环境中的Azure服务：

• Microsoft Azure全球环境
• Microsoft Azure中国区
• Microsoft Azure美国***环境
• Microsoft Azure德国环境
• Windows Azure Pack环境

配置说明

Docker部署示例

bash
docker run -it azuresdk/azure-powershell-core pwsh

登录与使用

Microsoft Azure全球环境

powershell
# 交互式登录 - 弹出对话框输入Azure凭据
Add-AzureRmAccount

# 非交互式登录 - 使用服务主体
Add-AzureRmAccount -ServicePrincipal -ApplicationId "http://my-app" -Credential $pscredential -TenantId $tenantid

# 管理服务/应用
New-AzureRmResourceGroup -Name myresourceGroup -Location "West US"

Microsoft Azure中国区

powershell
Add-AzureRmAccount -EnvironmentName AzureChinaCloud

# 管理服务/应用
New-AzureRmResourceGroup -Name myresourceGroup -Location "China East"

Microsoft Azure美国***环境

powershell
Add-AzureRmAccount -EnvironmentName AzureUSGovernment

# 管理服务/应用
New-AzureRmResourceGroup -Name myresourceGroup -Location "US Gov Virginia"

Microsoft Azure德国环境

powershell
Add-AzureRmAccount -EnvironmentName AzureGermanCloud

# 管理服务/应用
New-AzureRmResourceGroup -Name myresourceGroup -Location "Germany Central"

Windows Azure Pack

powershell
# 添加Windows Azure Pack环境到Azure PowerShell安装
# 需要以下信息：
# 1. 发布设置文件下载URL（必填）
# 2. 管理服务端点（可选）
# 3. 管理门户URL（可选）
# 4. 存储服务端点（可选）
Add-WAPackEnvironment -Name "MyWAPackEnv" `
    -PublishSettingsFileUrl "<发布设置文件下载URL>" `
    -ServiceEndpoint "<管理服务端点>" `
    -ManagementPortalUrl "<管理门户URL>" `
    -StorageEndpoint "<存储服务端点>"

# 下载包含订阅发布设置信息的文件
# 使用-Environment参数指定Windows Azure Pack环境
# 会打开浏览器窗口要求登录以获取文件
Get-WAPackPublishSettingsFile -Environment "MyWAPackEnv"

# 导入刚下载的文件
# 注意：文件包含订阅凭据，请勿公开（如提交到源代码控制）
Import-WAPackPublishSettingsFile "<文件位置>"

# 管理服务/应用
New-WAPackWebsite -Name mywebsite

查找cmdlet

所有cmdlet可分为三类：

1. ARM管理cmdlet使用AzureRm前缀（如New-AzureRmResourceGroup、Get-AzureRmVM）
2. 旧版RDFE管理cmdlet使用Azure前缀（如Get-AzureVM）
3. 在ARM或RDFE中工作的数据平面cmdlet使用Azure前缀（如Get-AzureBlob）

可使用以下cmdlet查找环境对应的所有cmdlet：

powershell
# 返回所有Azure Resource Manager (ARM) cmdlet
Get-Command *AzureRm*

# 返回所有Microsoft Azure cmdlet
Get-Command *Azure*

# 返回所有Windows Azure Pack cmdlet
Get-Command *WAPack*

若需将脚本从Microsoft Azure迁移到Windows Azure Pack或反之，只要使用的cmdlet属于第1类，即可平滑迁移。

帮助与反馈

若在使用代码时遇到问题，请访问Azure支持社区。

贡献代码或反馈

若想成为本项目的活跃贡献者，请遵循https://azure.github.io/guidelines/%E3%80%82

有关贡献本仓库的更多信息，请查看https://github.com/Azure/azure-powershell/blob/preview/CONTRIBUTING.md%E5%92%8Chttps://github.com/Azure/azure-powershell/wiki/Azure-Powershell-Developer-Guide%E6%96%87%E4%BB%B6%E5%A4%B9%E3%80%82

若遇到库的bug，请在项目的https://github.com/Azure/azure-powershell/issues%E6%8F%90%E4%BA%A4%E9%97%AE%E9%A2%98%E3%80%82

了解更多

• Microsoft Azure脚本中心

本项目采用Microsoft开源行为准则。更多信息请查看行为准则常见问题或联系***获取额外问题或意见。