Azure资源管理工具Azure PowerShell介绍

什么是 Azure PowerShell？

Azure PowerShell 是一组模块，提供用于通过 Windows PowerShell 管理 Azure 的 cmdlet。你可以使用 cmdlet 来创建、测试、部署和管理通过 Azure 平台传送的解决方案和服务。在大多数情况下，这些 cmdlet 可用于执行在 Azure 经典管理门户中可以执行的任务，例如，创建和配置云服务、虚拟机、虚拟网络和 Web 应用。

版本控制的工作原理

Azure PowerShell 使用语义版本控制，这意味着如果版本 A > 版本 B，则版本 A 具有最新的 API。这还意味着主要版本的更改表示一个或多个 cmdlet 中有重大更改。例如，版本 1.7.0 是用于解决 Azure PowerShell 1.x 版本中重大更改问题的修补程序。

有关 Azure PowerShell 中语义版本控制实践的详细信息，请参阅语义版本控制规范：http://semver.org

若要获取最新的 API，应使用版本 2.x。但是，如果针对版本 1.x 编写了脚本，而且不希望吸收 2.x 发行说明中所述的版本 2.x 重大更改，则应安装 1.7.0。

如果已安装配置文件模块的最新版本，并随后加载依赖于它的某个模块的早期版本，则会导致版本不匹配。解决此问题的最简单方法是从最新的 .msi 安装。.msi 会自动清理模块的较旧版本。

并行安装模块版本

版本 2.1.0（以及 AzureStack 版本 1.2.6）是第一个设计为并行安装和使用的模块版本。Azure PowerShell 使用二进制模块，因此，必须打开新的 PowerShell 窗口并使用 Import-Module 来导入 AzureRM cmdlet 的特定版本：

Import-Module AzureRM – RequiredVersion 2.1.0

2.1.0 之前的版本（1.2.6 除外）不能与其他 Azure PowerShell 模块版本并行使用。使用类似如上的命令加载 Azure PowerShell 模块的早期版本时，会加载 AzureRM.Profile 模块的不兼容版本，导致 cmdlet 在每次执行 cmdlet 时要求登录，即使已登录也是如此。

解决此问题的最简单方法是从 WebPI 源或 .msi 安装最新的 Azure PowerShell，这会删除从库安装的模板的早期版本。

请注意，Azure 和 AzureRM 模块拥有共同的依赖项，因此，使用这两个模块时，如果要更新其中的一个模块，则应同时更新两个模块。Azure 模块的早期版本加载并行模块时与 AzureRM 模块的早期版本加载并行模块时遇到的问题一样。

步骤 1：安装

以下是安装 Azure PowerShell 的两种方法。你可以通过 WebPI 或 PowerShell 库进行安装：

从 WebPI 安装 Azure PowerShell

从 WebPI 安装 Azure PowerShell 1.0 和更高版本的方法与安装 0.9.x 版本是一样的。下载 Azure PowerShell 并开始安装。如果安装了 Azure PowerShell 0.9.x，将在升级期间卸载版本 0.9.x。如果从 PowerShell 库安装了 Azure PowerShell 模块，安装程序将在安装之前自动删除这些模块，以确保 Azure PowerShell 环境一致。

Note

如果之前从 PowerShell 库安装了 Azure 模块，安装程序将自动删除这些模块。这是为了防止混淆已安装的模块版本及其所在的位置。PowerShell 库模块通常安装在%ProgramFiles%\WindowsPowerShell\Modules 中。相反，WebPI 安装程序会在%ProgramFiles(x86)%\Microsoft SDKs\Azure\PowerShell 中安装 Azure 模块。如果在安装过程中发生错误，可以手动删除 %ProgramFiles%\WindowsPowerShell\Modules 文件夹中的 Azure* 文件夹，然后重试安装。

安装完成后，$env:PSModulePath 设置中应会有包含 Azure PowerShell cmdlet 的目录。

Note

从 WebPI 安装时，会发生一个有关 PowerShell $env:PSModulePath 的已知问题。如果计算机因系统更新或其他安装而需要重启，有可能会导致更新 $env:PSModulePath 不包含 Azure PowerShell 的安装路径。如果发生这种情况，当你在安装或升级之后尝试使用 Azure PowerShell cmdlet 时，可能会看到“cmdlet 无法识别”消息。如果发生这种情况，重启计算机应该可以解决该问题。

如果尝试加载或执行 cmdlet，会收到如下消息：

    PS C:\> Get-AzureRmResource

    Get-AzureRmResource : The term 'Get-AzureRmResource' is not recognized as the name of a cmdlet, function,

    script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is

    correct and try again.

    At line:1 char:1

    + Get-AzureRmResource

    + ~~~~~~~~~~~~~~~~~~~~~~~

        + CategoryInfo          : ObjectNotFound: (get-azurermresourcefork:String) [], CommandNotFoundException

        + FullyQualifiedErrorId : CommandNotFoundException

这可以通过以下方法更正：重新启动计算机，或者按照以下方式从 C:\Program Files\WindowsPowerShell\Modules\Azure\XXXX\ 导入 cmdlet（其中 XXXX 是所安装 PowerShell 的版本）：

import-module "C:\\Program Files\\WindowsPowerShell\\Modules\\Azure\\XXXX\\azure.psd1"

import-module "C:\\Program Files\\WindowsPowerShell\\Modules\\Azure\\XXXX\\expressroute\\expressroute.psd1"

从 PowerShell 库安装 Azure PowerShell

在提升的 Windows PowerShell 或 PowerShell 集成脚本环境 (ISE) 提示符下，使用以下命令从 PowerShell 库安装 Azure PowerShell 1.3.0 或更高版本：

# Install the Azure Resource Manager modules from the PowerShell Gallery

Install-Module AzureRM

# Install the Azure Service Management module from the PowerShell Gallery

Install-Module Azure

有关这些命令的详细信息

Install-Module AzureRM 为 Azure Resource Manager cmdlet 安装汇总模块。AzureRM 模块依赖于
每个 Azure Resource Manager 模块的特定版本范围。包含的版本范围可以确保在安装同一主要版本的 AzureRM 模块时，不包含重大的模块更改。安装 AzureRM 模块时，会从 PowerShell 库下载并安装先前未安装的所有 Azure Resource Manager 模块。有关 Azure PowerShell 模块所用的语义版本控制的详细信息，请参阅 semver.org。
Install-Module Azure 安装 Azure 模块。此模块是 Azure PowerShell 0.9.x 中的服务管理模块。这应该没有任何重要更改，而且可与前一版本的 Azure 模块互换。

步骤 2：启动

你可以通过标准的 Windows PowerShell 控制台或 PowerShell 集成脚本环境 (ISE) 运行 cmdlet。您用于打开控制台的方法取决于您正在运行的 Windows 的版本：

在至少运行 Windows 8 或 Windows Server 2012 的计算机上，您可以使用内置搜索。从“开始”屏幕，开始键入 power。此时将返回范围内的应用列表，包括 Windows PowerShell。若要打开控制台，请单击任一应用程序。（若要将应用固定到“开始”屏幕，请右键单击图标。）
在运行早于 Windows 8 或 Windows Server 2012 的版本的计算机上，请使用“开始”菜单。在“开始”菜单上，依次单击“所有程序”、“附件”、“Windows PowerShell”文件夹和“Windows PowerShell”。

也可以运行 Windows PowerShell ISE，使用菜单项和键盘快捷方式来执行可在 Windows PowerShell 控制台中执行的许多相同任务。若要使用 ISE，请在 Windows PowerShell 控制台、Cmd.exe 或“运行”框中，键入 powershell_ise.exe。

帮助入门的命令

# To make sure the Azure PowerShell module is available after you install

Get-Module –ListAvailable 

# To login to Azure Resource Manager

Login-AzureRmAccount -EnvironmentName AzureChinaCloud

# You can also use a specific Tenant if you would like a faster login experience

# Login-AzureRmAccount -EnvironmentName AzureChinaCloud -TenantId xxxx

# To view all subscriptions for your account

Get-AzureRmSubscription

# To select a default subscription for your current session

Get-AzureRmSubscription –SubscriptionName “your sub” | Select-AzureRmSubscription

# View your current Azure PowerShell session context

# This session state is only applicable to the current session and will not affect other sessions

Get-AzureRmContext

# To select the default storage context for your current session

Set-AzureRmCurrentStorageAccount –ResourceGroupName “your resource group” –StorageAccountName “your storage account name”

# View your current Azure PowerShell session context

# Note: the CurrentStorageAccount is now set in your session context

Get-AzureRmContext

# To list all of the blobs in all of your containers in all of your accounts

Get-AzureRmStorageAccount | Get-AzureStorageContainer | Get-AzureStorageBlob

步骤 3：连接

cmdlet 需要使用你的订阅来管理你的服务。如果你没有 Azure 订阅，可以购买一个。有关说明，请参阅如何购买 Azure。

键入 Login-AzureRmAccount -EnvironmentName AzureChinaCloud
键入与你的帐户关联的电子邮件地址和密码。Azure 将对凭据信息进行身份验证并保存，然后关闭该窗口。

--或者--

登录到你的工作帐户或学校帐户：

$cred = Get-Credential

Login-AzureRmAccount -EnvironmentName AzureChinaCloud -Credential $cred

Note

如果你的组织帐户有多个关联的租户，请指定 TenantId 参数：

$loadersubscription = Get-AzureRmSubscription -SubscriptionName $YourSubscriptionName -TenantId $YourAssociatedSubscriptionTenantId

查看帐户和订阅详细信息

可以拥有多个帐户和订阅以供 Azure PowerShell 使用。可以通过多次运行 Add-AzureRmAccount -EnvironmentName AzureChinaCloud 来添加多个帐户。

若要显示可用的 Azure 帐户，请键入 Get-AzureAccount。

若要显示 Azure 订阅，请键入 Get-AzureRmSubscription。

获取帮助##

这些资源提供特定 cmdlet 的帮助信息：

从控制台内，可以使用内置的帮助系统。Get-Help cmdlet 提供对此系统的访问。
要获得社区中的帮助信息，请尝试以下常见论坛：
- MSDN 上的 Azure 论坛
- CSDN

了解详细信息

若要详细了解如何使用 cmdlet，请参阅以下资源：

有关使用 Windows PowerShell 的基本说明，请参阅使用 Windows PowerShell。

有关cmdlet的参考信息, 请参阅 Azure 命令行参考.

立即访问http://market.azure.cn