Installare PowerShell per Azure StackInstall PowerShell for Azure Stack

Si applica a: Azure Stack integrate di sistemi Azure Stack Development KitApplies to: Azure Stack integrated systems and Azure Stack Development Kit

Moduli di Azure PowerShell compatibili Stack Azure necessarie per lavorare con lo Stack di Azure.Azure Stack compatible Azure PowerShell modules are required to work with Azure Stack. In questa guida sono illustrati i passaggi necessari per installare PowerShell per Azure Stack.In this guide, we walk you through the steps required to install PowerShell for Azure Stack. È possibile utilizzare i passaggi descritti in questo articolo del Kit di sviluppo dello Stack di Azure o da un client esterno basato su Windows, se si è connessi tramite VPN.You can use the steps described in this article either from the Azure Stack Development Kit, or from a Windows-based external client if you are connected through VPN.

In questo articolo contiene istruzioni dettagliate per installare PowerShell per Azure Stack.This article has detailed instructions to install PowerShell for Azure Stack. Tuttavia, se si desidera installare e configurare PowerShell rapidamente, è possibile utilizzare lo script fornito nel diventare operativi con PowerShell argomento.However, if you want to quickly install and configure PowerShell, you can use the script that is provided in the Get up and running with PowerShell topic.

Nota

Le operazioni seguenti richiedono PowerShell 5.0.The following steps require PowerShell 5.0. Per controllare la versione in uso, eseguire $PSVersionTable.PSVersion e confrontare la versione "Principale".To check your version, run $PSVersionTable.PSVersion and compare the "Major" version.

I comandi di PowerShell per lo Stack di Azure vengono installati tramite PowerShell Gallery.PowerShell commands for Azure Stack are installed through the PowerShell Gallery. Per registrare il repository PSGallery, aprire una sessione di PowerShell con privilegi elevata del kit di sviluppo o da un client esterno basato su Windows se si sono connessi tramite VPN ed eseguire il comando seguente:To register the PSGallery repository, open an elevated PowerShell session from the development kit or from a Windows-based external client if you are connected through VPN and run the following command:

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

Disinstallare le versioni esistenti di PowerShellUninstall existing versions of PowerShell

Prima di installare la versione richiesta, assicurarsi di disinstallare i moduli di PowerShell di Azure esistenti.Before installing the required version, make sure that you uninstall any existing Azure PowerShell modules. È possibile disinstallarle utilizzando uno dei due metodi seguenti:You can uninstall them by using one of the following two methods:

  • Per disinstallare i moduli di PowerShell esistenti, accedere al kit di sviluppo o per client basati su Windows esterno se si prevede di stabilire una connessione VPN.To uninstall the existing PowerShell modules, sign in to the development kit, or to the Windows-based external client if you are planning to establish a VPN connection. Chiudere tutte le sessioni attive di PowerShell ed eseguire il comando seguente:Close all the active PowerShell sessions and run the following command:

    Get-Module -ListAvailable | where-Object {$_.Name -like “Azure*”} | Uninstall-Module
    
  • Accedere al kit di sviluppo o per client basati su Windows esterno se si prevede di stabilire una connessione VPN.Sign in to the development kit, or to the Windows-based external client if you are planning to establish a VPN connection. Eliminare tutte le cartelle che iniziano con "Azure" dal C:\Program Files\WindowsPowerShell\Modules e C:\Users\AzureStackAdmin\Documents\WindowsPowerShell\Modules cartelle.Delete all the folders that start with "Azure" from the C:\Program Files\WindowsPowerShell\Modules and C:\Users\AzureStackAdmin\Documents\WindowsPowerShell\Modules folders. Eliminazione di queste cartelle rimuove tutti i moduli PowerShell esistenti dal ambiti utente "globali" e "AzureStackAdmin".Deleting these folders removes any existing PowerShell modules from the "AzureStackAdmin" and "global" user scopes.

Nelle sezioni seguenti vengono descritti i passaggi necessari per installare PowerShell per Azure Stack.The following sections describe the steps required to install PowerShell for Azure Stack. PowerShell può essere installato nello Stack di Azure che viene gestita in connessa, parzialmente connesso o in uno scenario disconnesso.PowerShell can be installed on Azure Stack that is operated in connected, partially connected, or in a disconnected scenario.

Installare PowerShell in uno scenario connesso (con connettività internet)Install PowerShell in a connected scenario (with internet connectivity)

Moduli di Azure Resource Manager compatibili Stack Azure vengono installati tramite i profili della versione API.Azure Stack compatible AzureRM modules are installed through API version profiles. Stack di Azure richiede il 2017-03-09-profilo profilo di versione API, che è disponibile per l'installazione del modulo AzureRM.Bootstrapper.Azure Stack requires the 2017-03-09-profile API version profile, which is available by installing the AzureRM.Bootstrapper module. Per ulteriori informazioni sui profili di versione API e i cmdlet forniti dall'utente, consultare il gestire i profili di versione API.To learn about API version profiles and the cmdlets provided by them, refer to the manage API version profiles. Oltre ai moduli di Azure Resource Manager, è inoltre necessario installare i moduli di Azure PowerShell specifici dello Stack.In addition to the AzureRM modules, you should also install the Azure Stack-specific PowerShell modules. Eseguire lo script di PowerShell seguente per installare i moduli nella workstation di sviluppo:Run the following PowerShell script to install these modules on your development workstation:

Importante

La versione del modulo PowerShell di Azure Resource Manager 1.2.11 viene fornito con un elenco di modifiche di rilievo.The release of the AzureRM 1.2.11 PowerShell module comes with a list of breaking changes. Eseguire l'aggiornamento dal 1.2.10 versione, vedere la Guida alla migrazione al https://aka.ms/azspowershellmigration.To upgrade from the 1.2.10 version, see the migration guide at https://aka.ms/azspowershellmigration.

# 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

Per verificare l'installazione, eseguire il comando seguente:To confirm the installation, run the following command:

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

Se l'installazione ha esito positivo, i moduli di Azure Resource Manager e AzureStack vengono visualizzati nell'output.If the installation is successful, the AzureRM and AzureStack modules are displayed in the output.

Installare PowerShell in un disconnesso o per uno scenario di connesso parziale (con connettività internet limitata)Install PowerShell in a disconnected or a partially connected scenario (with limited internet connectivity)

In uno scenario disconnesso, è necessario innanzitutto scaricare i moduli di PowerShell in un computer con connettività internet e quindi li trasferiscono al Kit di sviluppo dello Stack di Azure per l'installazione.In a disconnected scenario, you must first download the PowerShell modules to a machine that has internet connectivity, and then transfer them to the Azure Stack Development Kit for installation.

Importante

La versione del modulo PowerShell di Azure Resource Manager 1.2.11 viene fornito con un elenco di modifiche di rilievo.The release of the AzureRM 1.2.11 PowerShell module comes with a list of breaking changes. Eseguire l'aggiornamento dal 1.2.10 versione, vedere la Guida alla migrazione al https://aka.ms/azspowershellmigration.To upgrade from the 1.2.10 version, see the migration guide at https://aka.ms/azspowershellmigration.

  1. Accedere a un computer in cui si dispone di connettività internet e usare lo script seguente per il download di Azure Resource Manager e AzureStack pacchetti nel computer locale:Sign in to a computer where you have internet connectivity and use the following script to download the AzureRM, and AzureStack packages onto your local computer:

    $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. Copiare i pacchetti scaricati in un dispositivo USB.Copy the downloaded packages over to a USB device.

  3. Accedere al kit di sviluppo e copiare i pacchetti dal dispositivo USB in un percorso nel kit di sviluppo.Sign in to the development kit and copy the packages from the USB device to a location on the development kit.

  4. È ora necessario registrare questo percorso come il repository predefinito e installare i moduli di Azure Resource Manager e AzureStack da questo repository:Now you must register this location as the default repository and install the AzureRM and AzureStack modules from this repository:

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

Passaggi successiviNext steps