安装适用于 Azure Stack 的 PowerShell

需要安装与 Azure Stack 兼容的 Azure PowerShell 模块才能使用 Azure Stack。 本指南逐步演示安装适用于 Azure Stack 的 PowerShell 的步骤。 可以通过 Azure Stack 开发工具包或者基于 Windows 的外部客户端(如果已通过 VPN 建立连接)执行本文中所述的步骤。

本文提供有关安装适用于 Azure Stack 的 PowerShell 的详细说明。 但是,若要快速安装和配置 PowerShell,可以使用“通过 PowerShell 启动和运行”一文中提供的脚本。

Note

以下步骤需要 PowerShell 5.0。 若要检查版本,请运行 $PSVersionTable.PSVersion 并比较“Major”(主要)版本。

通过 PowerShell 库安装适用于 Azure Stack 的 PowerShell 命令。 若要注册 PSGallery 存储库,请通过开发工具包或者基于 Windows 的外部客户端(如果已通过 VPN 建立连接)打开权限提升的 PowerShell 会话,然后运行以下命令:

Set-PSRepository `
  -Name "PSGallery" `
  -InstallationPolicy Trusted

卸载现有的 PowerShell 版本

在安装所需版本之前,请务必卸载任何现有 Azure PowerShell 模块。 可使用以下两种方法之一卸载现有版本:

  • 若要卸载现有的 PowerShell 模块,请登录到开发工具包或基于 Windows 的外部客户端(如果打算建立 VPN 连接)。 关闭所有活动的 PowerShell 会话,然后运行以下命令:

    Get-Module -ListAvailable | where-Object {$_.Name -like “Azure*”} | Uninstall-Module
    
  • 登录到开发工具包或基于 Windows 的外部客户端(如果打算建立 VPN 连接)。 从 C:\Program Files (x86)\WindowsPowerShell\ModulesC:\Users\AzureStackAdmin\Documents\WindowsPowerShell\Modules 文件夹中删除以“Azure”开头的所有文件夹。 删除这些文件夹会从“AzureStackAdmin”和“global”用户范围中删除所有现有的 PowerShell 模块。

以下部分介绍安装适用于 Azure Stack 的 PowerShell 所要执行的步骤。 可在已建立连接、部分连接或断开连接的情况下,在 Azure Stack 上安装 PowerShell。

在已建立连接的情况下(已建立 Internet 连接)安装 PowerShell

通过 API 版本配置文件安装与 Azure Stack 兼容的 AzureRM 模块。 Azure Stack 需要 2017-03-09-profile API 版本配置文件(可通过安装 AzureRM.Bootstrapper 模块获取)。 有关 API 版本配置文件及其提供的 cmdlet 的详细信息,请参阅管理 API 版本配置文件。 除了 AzureRM 模块以外,还应安装 Azure Stack 特定的 Azure PowerShell 模块。 运行以下 PowerShell 脚本,在开发工作站上安装这些模块:

Important

AzureRM 1.2.11 PowerShell 模块版本随附了重大更改列表。

# Install the AzureRM.Bootstrapper module. Select Yes when prompted to install NuGet 
Install-Module `
  -Name AzureRm.BootStrapper

# Install and import the API Version Profile required by Azure Stack into the current PowerShell session.
Use-AzureRmProfile `
  -Profile 2017-03-09-profile -Force

Install-Module `
  -Name AzureStack `
  -RequiredVersion 1.2.11

若要确认安装,请运行以下命令:

Get-Module `
  -ListAvailable | where-Object {$_.Name -like “Azure*”}

如果安装成功,输出中会显示 AzureRM 和 Azure Stack 模块。

在断开连接或部分连接的情况下(Internet 连接受到限制)安装 PowerShell

在断开连接或部分连接的情况下,必须先将 PowerShell 模块下载到已建立 Internet 连接的计算机,然后将其传送到 Azure Stack 开发工具包进行安装。

Important

AzureRM 1.2.11 PowerShell 模块版本随附了重大更改列表。

  1. 登录到已建立 Internet 连接的计算机,使用以下脚本将 AzureRM 和 AzureStack 包下载到本地计算机:

    $Path = "<Path that is used to save the packages>"
    
    Save-Package `
      -ProviderName NuGet `
      -Source https://www.powershellgallery.com/api/v2 `
      -Name AzureRM `
      -Path $Path `
      -Force `
      -RequiredVersion 1.2.11
    
    Save-Package `
      -ProviderName NuGet `
      -Source https://www.powershellgallery.com/api/v2 `
      -Name AzureStack `
      -Path $Path `
      -Force `
      -RequiredVersion 1.2.11 
    
  2. 将下载的包复制到 USB 设备。

  3. 登录到开发工具包,将包从 USB 设备复制到开发工具包中的某个位置。

  4. 接下来,必须将此位置注册为默认存储库,并从此存储库安装 AzureRM 和 AzureStack 模块:

    $SourceLocation = "<Location on the development kit that contains the PowerShell packages>"
    $RepoName = "MyNuGetSource"
    
    Register-PSRepository `
      -Name $RepoName `
      -SourceLocation $SourceLocation `
      -InstallationPolicy Trusted
    
    ```powershell
    Install-Module AzureRM `
      -Repository $RepoName
    
    Install-Module AzureStack `
      -Repository $RepoName 
    

后续步骤