Installare PowerShell AZ Module for Azure Stack HubInstall PowerShell Az module for Azure Stack Hub

Questo articolo illustra come installare i moduli Azure PowerShell AZ e Administrator Azure Stack Hub con PowerShellGet.This article explains how to install the Azure PowerShell Az and compatible Azure Stack Hub administrator modules using PowerShellGet. I moduli AZ possono essere installati nelle piattaforme Windows, macOS e Linux.The Az modules can be installed on Windows, macOS, and Linux platforms.

È anche possibile eseguire il comando AZ modules for Azure Stack Hub in un contenitore docker.You can also run the Az modules for Azure Stack Hub in a Docker container. Per istruzioni, vedere usare Docker per eseguire PowerShell per Hub Azure stack.For instructions, see Use Docker to run PowerShell for Azure Stack Hub.

Se si vuole installare il modulo AzureRM (PowerShell Resource Modules) per Azure Stack Hub, vedere Install PowerShell AzureRM Module for Azure stack Hub.If you would like to install PowerShell Resource Modules (AzureRM) module for Azure Stack Hub, see Install PowerShell AzureRM module for Azure Stack Hub.

Importante

Probabilmente non saranno disponibili nuove versioni del modulo moduli risorse di Azure.There will likely not be new Azure Resource Modules module releases. I moduli dei moduli delle risorse di Azure sono supportati solo per le correzioni critiche.The Azure Resource Modules modules are under support for critical fixes only. In futuro verranno rilasciate solo le versioni AZ per Azure Stack Hub.Going forward there will only be Az releases for Azure Stack Hub.

È possibile usare i profili API per specificare gli endpoint compatibili per i provider di risorse dell'hub Azure stack.You can use API profiles to specify the compatible endpoints for the Azure Stack Hub resource providers.

I profili API consentono di gestire le differenze di versione tra Azure e l'hub Azure Stack.API profiles provide a way to manage version differences between Azure and Azure Stack Hub. Un profilo della versione dell'API è un set di moduli di Azure Resource Manager PowerShell con versioni API specifiche.An API version profile is a set of Azure Resource Manager PowerShell modules with specific API versions. Ogni piattaforma cloud include un set di profili di versione API supportati.Each cloud platform has a set of supported API version profiles. Ad esempio, Azure Stack Hub supporta una versione specifica del profilo, ad esempio 2019-03-01-Hybrid.For example, Azure Stack Hub supports a specific profile version such as 2019-03-01-hybrid. Quando si installa un profilo, vengono installati i moduli Azure Resource Manager PowerShell che corrispondono al profilo specificato.When you install a profile, the Azure Resource Manager PowerShell modules that correspond to the specified profile are installed.

È possibile installare i moduli di PowerShell AZ compatibili con Azure Stack Hub in scenari connessi a Internet, parzialmente connessi o disconnessi.You can install Azure Stack Hub compatible PowerShell Az modules in Internet-connected, partially connected, or disconnected scenarios. Questo articolo illustra le istruzioni dettagliate per questi scenari.This article walks you through the detailed instructions for these scenarios.

1. verificare i prerequisiti1. Verify your prerequisites

AZ Modules è supportato nell'hub Azure Stack con aggiornamento 2002 o versione successiva e con gli hotfix correnti installati.Az modules are supported on Azure Stack Hub with Update 2002 or later and with the current hotfixes installed. Per ulteriori informazioni, vedere le Note sulla versione dell'Hub Azure stack .Please see the Azure Stack Hub release notes for more information.

Il Azure PowerShell AZ Modules funziona con PowerShell 5,1 o versione successiva in Windows o PowerShell Core 6. x e versioni successive su tutte le piattaforme.The Azure PowerShell Az modules work with PowerShell 5.1 or higher on Windows, or PowerShell Core 6.x and later on all platforms. È necessario installare la versione più recente di PowerShell Core disponibile per il sistema operativo in uso.You should install the latest version of PowerShell Core available for your operating system. Azure PowerShell non prevede requisiti aggiuntivi quando vengono eseguiti in PowerShell core.Azure PowerShell has no additional requirements when run on PowerShell Core.

Per controllare la versione di PowerShell, eseguire il comando:To check your PowerShell version, run the command:

$PSVersionTable.PSVersion

Prerequisiti per WindowsPrerequisites for Windows

Per usare Azure PowerShell in PowerShell 5.1 in Windows:To use Azure PowerShell in PowerShell 5.1 on Windows:

  1. Se necessario, eseguire l'aggiornamento a Windows PowerShell 5.1.Update to Windows PowerShell 5.1 if needed. Se si usa Windows 10, PowerShell 5.1 è già installato.If you're on Windows 10, you already have PowerShell 5.1 installed.
  2. Installare .NET Framework 4.7.2 o versioni successive.Install .NET Framework 4.7.2 or later.
  3. Assicurarsi di avere la versione più recente di PowerShellGet.Make sure you have the latest version of PowerShellGet. Eseguire Install-Module PowerShellGet -MinimumVersion 2.2.3 -Force.Run Install-Module PowerShellGet -MinimumVersion 2.2.3 -Force.

2. prerequisiti per Linux e Mac2. Prerequisites for Linux and Mac

È necessario PowerShell Core 6. x o versione successiva.PowerShell Core 6.x or later version is needed. Segui il collegamento per istruzioniFollow the link for instructions

3. disinstallare le versioni esistenti dei moduli di PowerShell per hub Azure Stack3. Uninstall existing versions of the Azure Stack Hub PowerShell modules

Prima di installare la versione richiesta, assicurarsi di disinstallare i moduli Azure Stack Hub Azure Resource Manager o AZ PowerShell installati in precedenza.Before installing the required version, make sure that you uninstall any previously installed Azure Stack Hub Azure Resource Manager or Az PowerShell modules. Disinstallare i moduli usando uno dei due metodi seguenti:Uninstall the modules by using one of the following two methods:

  1. Per disinstallare i moduli Azure Resource Manager e AZ PowerShell esistenti, chiudere tutte le sessioni di PowerShell attive ed eseguire i cmdlet seguenti:To uninstall the existing Azure Resource Manager and Az PowerShell modules, close all the active PowerShell sessions, and run the following cmdlets:

    Get-Module -Name Azure* -ListAvailable | Uninstall-Module -Force -Verbose -ErrorAction Continue
    Get-Module -Name Azs.* -ListAvailable | Uninstall-Module -Force -Verbose -ErrorAction Continue
    Get-Module -Name Az.* -ListAvailable | Uninstall-Module -Force -Verbose -ErrorAction Continue
    

    Se viene rilevato un errore, ad esempio ' il modulo è già in uso ', chiudere le sessioni di PowerShell che usano i moduli ed eseguire di nuovo lo script precedente.If you hit an error such as 'The module is already in use', close the PowerShell sessions that are using the modules and rerun the above script.

  2. Eliminare tutte le cartelle che iniziano con Azure Az o Azs. dalle C:\Program Files\WindowsPowerShell\Modules C:\Users\{yourusername}\Documents\WindowsPowerShell\Modules cartelle e.Delete all the folders that start with Azure, Az or Azs. from the C:\Program Files\WindowsPowerShell\Modules and C:\Users\{yourusername}\Documents\WindowsPowerShell\Modules folders. L'eliminazione di queste cartelle comporta la rimozione di eventuali moduli di PowerShell esistenti.Deleting these folders removes any existing PowerShell modules.

4. connesso: installa con connettività Internet4. Connected: Install with internet connectivity

Il Azure Stack AZ Module funzionerà Azure Stack Hub 2002 o versione successiva.The Azure Stack Az module will work Azure Stack Hub 2002 or later. Inoltre, il Azure Stack AZ Module funzionerà con PowerShell 5,1 o versione successiva in un computer Windows o PowerShell 6. x o versione successiva in una piattaforma Linux o macOS.In addition, the Azure Stack Az module will work with PowerShell 5.1 or greater on a Windows machine, or PowerShell 6.x or greater on a Linux or macOS platform. Il metodo di installazione preferito prevede l'uso dei cmdlet PowerShellGet.Using the PowerShellGet cmdlets is the preferred installation method. Questo metodo funziona allo stesso modo sulle piattaforme supportate.This method works the same on the supported platforms.

Eseguire il comando seguente da una sessione di PowerShell:Run the following command from a PowerShell session:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Install-Module -Name Az.BootStrapper -Force -AllowPrerelease
Install-AzProfile -Profile 2019-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 2.0.2-preview -AllowPrerelease

Nota

Il modulo Azure Stack Hub versione 2.0.0 è una modifica sostanziale.Azure Stack Hub module version 2.0.0 is a breaking change. Per informazioni dettagliate, vedere la pagina relativa alla migrazione da AzureRM a Azure PowerShell AZ nell'Hub Azure stack .Refer to the Migrate from AzureRM to Azure PowerShell Az in Azure Stack Hub for details.

Avviso

Non è possibile installare contemporaneamente i moduli Azure Resource Manager (AzureRM) e AZ Modules per PowerShell 5,1 per Windows.You can't have both the Azure Resource Manager (AzureRM) and Az modules installed for PowerShell 5.1 for Windows at the same time. Se è necessario lasciare Azure Resource Manager disponibile nel sistema, installare il modulo AZ per PowerShell Core 6. x o versione successiva.If you need to keep Azure Resource Manager available on your system, install the Az module for PowerShell Core 6.x or later. A questo scopo, installare PowerShell Core 6.x or versioni successive e quindi seguire queste istruzioni in un terminale di PowerShell Core.To do this, install PowerShell Core 6.x or later and then follow these instructions in a PowerShell Core terminal.

5. disconnesso: installazione senza connessione Internet5. Disconnected: Install without internet connection

In uno scenario disconnesso, è necessario prima di tutto scaricare i moduli di PowerShell in un computer con connettività Internet.In a disconnected scenario, you first download the PowerShell modules to a machine that has internet connectivity. Quindi, trasferirli al Azure Stack Development Kit (Gabriele) per l'installazione.Then, you transfer them to the Azure Stack Development Kit (ASDK) for installation.

Accedere a un computer con connettività Internet e usare gli script seguenti per scaricare i pacchetti di Azure Resource Manager e Azure Stack Hub, a seconda della versione dell'hub Azure Stack.Sign in to a computer with internet connectivity and use the following scripts to download the Azure Resource Manager and Azure Stack Hub packages, depending on your version of Azure Stack Hub.

L'installazione prevede cinque passaggi:Installation has five steps:

  1. Installare Azure Stack PowerShell Hub in un computer connesso.Install Azure Stack Hub PowerShell to a connected machine.
  2. Abilitare funzionalità di archiviazione aggiuntive.Enable additional storage features.
  3. Trasportare i pacchetti di PowerShell nella workstation disconnessa.Transport the PowerShell packages to your disconnected workstation.
  4. Eseguire manualmente il bootstrap del provider NuGet nella workstation disconnessa.Manually bootstrap the NuGet provider on your disconnected workstation.
  5. Confermare l'installazione di PowerShell.Confirm the installation of PowerShell.

Installare Azure Stack PowerShell per hubInstall Azure Stack Hub PowerShell

Hub Azure Stack 2002 o versione successiva.Azure Stack Hub 2002 or later.

È possibile usare Azure Resource Manager o AZ modules.You could either use Azure Resource Manager or Az modules. Per Azure Resource Manager, vedere le istruzioni in installare il modulo AzureRM di PowerShell.For Azure Resource Manager, see the instructions at Install PowerShell AzureRM module. Il codice seguente consente di salvare i moduli da un repository online attendibile https://www.powershellgallery.com/ .The following code saves modules from trustworthy online repository https://www.powershellgallery.com/.

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Install-module -Name PowerShellGet -MinimumVersion 2.2.3 -Force
Import-Module -Name PackageManagement -ErrorAction Stop

$savedModulesPath = "<Path that is used to save the packages>"
Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name Az -Path $savedModulesPath -Force -RequiredVersion 0.10.0-preview
Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureStack -Path $savedModulesPath -Force -RequiredVersion 2.0.2-preview

Nota

Nei computer senza una connessione Internet, è consigliabile eseguire il cmdlet seguente per disabilitare la raccolta dei dati di telemetria.On machines without an internet connection, we recommend executing the following cmdlet for disabling the telemetry data collection. È possibile che si verifichi un calo delle prestazioni dei cmdlet senza disabilitare la raccolta dei dati di telemetria.You may experience a performance degradation of the cmdlets without disabling the telemetry data collection. Questa operazione è applicabile solo ai computer senza connessioni InternetThis is applicable only for the machines without internet connections

Disable-AzDataCollection

Aggiungere i pacchetti alla workstationAdd your packages to your workstation

  1. Copiare i pacchetti scaricati in un dispositivo USB.Copy the downloaded packages to a USB device.

  2. Accedere alla workstation disconnessa e copiare i pacchetti dal dispositivo USB in un percorso della workstation.Sign in to the disconnected workstation and copy the packages from the USB device to a location on the workstation.

  3. Eseguire manualmente il bootstrap del provider NuGet nella workstation disconnessa.Manually bootstrap the NuGet provider on your disconnected workstation. Per istruzioni, vedere bootstrap manuale del provider NuGet in un computer che non è connesso a Internet.For instructions, see Manually bootstrapping the NuGet provider on a machine that isn't connected to the internet.

  4. Registrare questo percorso come repository predefinito e installare i AzureRM moduli e AzureStack da questo repository:Register this location as the default repository and install the AzureRM and AzureStack modules from this repository:

    # requires -Version 5
    # requires -RunAsAdministrator
    # requires -Module PowerShellGet
    # requires -Module PackageManagement
    
    $SourceLocation = "<Location on the development kit that contains the PowerShell packages>"
    $RepoName = "MyNuGetSource"
    
    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
    
    Register-PSRepository -Name $RepoName -SourceLocation $SourceLocation -InstallationPolicy Trusted
    
    Install-Module -Name AzureStack -Repository $RepoName -RequiredVersion 2.0.2-preview -AllowPrerelease -Scope AllUsers
    
    Install-Module -Name Az -Repository $RepoName -RequiredVersion 0.10.0-preview -AllowPrerelease -Scope AllUsers
    

Verificare l'installazione di PowerShellConfirm the installation of PowerShell

Verificare l'installazione eseguendo il comando seguente:Confirm the installation by running the following command:

Get-Module -Name "Az*" -ListAvailable
Get-Module -Name "Azs*" -ListAvailable

6. configurare PowerShell per l'uso di un server proxy6. Configure PowerShell to use a proxy server

Negli scenari in cui è necessario un server proxy per accedere a Internet, è necessario innanzitutto configurare PowerShell per l'uso di un server proxy esistente:In scenarios that require a proxy server to access the internet, you first configure PowerShell to use an existing proxy server:

  1. Apri un prompt di PowerShell con privilegi elevati.Open an elevated PowerShell prompt.

  2. Eseguire i comandi seguenti:Run the following commands:

    #To use Windows credentials for proxy authentication
    [System.Net.WebRequest]::DefaultWebProxy.Credentials = [System.Net.CredentialCache]::DefaultCredentials
    
    #Alternatively, to prompt for separate credentials that can be used for #proxy authentication
    [System.Net.WebRequest]::DefaultWebProxy.Credentials = Get-Credential
    

7. usare il modulo AZ7. Use the Az module

È possibile usare i cmdlet e gli esempi di codice basati su Azure Resource Manager.You can use the cmdlets and code samples based on Azure Resource Manager. Tuttavia, sarà necessario modificare il nome dei moduli e dei cmdlet.However, you will want to change the name of the modules and cmdlets. I nomi dei moduli sono stati modificati in modo che AzureRM e Azure diventino e Az lo stesso per i cmdlet.The module names have been changed so that AzureRM and Azure become Az, and the same for cmdlets. Il modulo, ad esempio, AzureRM.Compute è stato rinominato in Az.Compute . New-AzureRMVMFor example, the AzureRM.Compute module has been renamed to Az.Compute. New-AzureRMVM è diventato New-AzVM e Get-AzureStorageBlob è ora Get-AzStorageBlob.has become New-AzVM, and Get-AzureStorageBlob is now Get-AzStorageBlob.

Per informazioni più dettagliate e istruzioni per lo spostare lo script AzurRM in AZ e le modifiche di rilievo nel modulo AZ del Azure Stack Hub, vedere eseguire la migrazione da AzureRM a Azure PowerShell AZ.For a more thorough discussion and guidance for moving AzurRM script to Az and breaking changes in Azure Stack Hub's Az module, see Migrate from AzureRM to Azure PowerShell Az.

Problemi notiKnown issues

Errore generato durante l'installazione di AZ ModulesError thrown when installing the Az modules

  • Applicabile: questo problema si applica a 2002 e versioni successiveApplicable: This issue applies to 2002 and later
  • Motivo: quando si installa il modulo, viene generato un errore.Cause: When installing the module, an error is thrown. Il messaggio di errore inizia: Register-PacakgeSource : A parameter cannot be found that matches parameter name. 'PackageManagementProvider'. o il messaggio di errore può includere il testo seguente: PackageManagement\Install-Package : Cannot convert value "2.0.1-preview" to type "System.Version". Error: "Input string was not in a correct format."The error message begins: Register-PacakgeSource : A parameter cannot be found that matches parameter name. 'PackageManagementProvider'. Or the error message may include the following text: PackageManagement\Install-Package : Cannot convert value "2.0.1-preview" to type "System.Version". Error: "Input string was not in a correct format."
  • Correzione: eseguire il cmdlet seguente nella stessa sessione:Remediation: Run the following cmdlet in the same session:
    Install-Module PowershellGet -MinimumumVersion 2.3.0 -Force
    Chiudere la sessione e avviare una nuova sessione di PowerShell con privilegi elevati.Close your session and start a new elevated PowerShell session.
  • Occorrenza: comuneOccurrence: Common

Quando si installa AZ Module falsely genera un errore di diritti di amministratoreWhen installing Az module falsely throws Admin rights required error

  • Applicabile: questo problema si applica a 2002 e versioni successiveApplicable: This issue applies to 2002 and later
  • Motivo: quando si installa il modulo da un prompt con privilegi elevati, viene generato un errore.Cause: When installing the module from an elevated prompt, an error is thrown. L'errore indica Administrator rights required .The error says, Administrator rights required.
  • Correzione: chiudere la sessione e avviare una nuova sessione di PowerShell con privilegi elevati.Remediation: Close your session and start a new elevated PowerShell session. Assicurarsi che non esista un AZ.Make sure there isn't an existing Az. Modulo degli account caricato nella sessione.Accounts module loaded in the session.
  • Occorrenza: comuneOccurrence: Common

Passaggi successiviNext steps