Installare il modulo AzureRM di PowerShell per l'hub Azure StackInstall PowerShell AzureRM module for Azure Stack Hub

Azure PowerShell Azure Resource Manager (AzureRM) fornisce un set di cmdlet che usano il modello di Azure Resource Manager per la gestione delle risorse dell'hub Azure Stack.Azure PowerShell Azure Resource Manager (AzureRM) provides a set of cmdlets that use the Azure Resource Manager model for managing your Azure Stack Hub resources.

Importante

La pagina Web visualizzata si riferisce a una versione obsoleta di Azure PowerShell.You've reached a webpage for an outdated version of Azure PowerShell. Tutte le versioni del modulo di PowerShell Azure Resource Manager (AzureRM) non sono aggiornate, ma non sono supportate.All versions of the Azure Resource Manager (AzureRM) PowerShell module are outdated, but not out of support. Il modulo AZ PowerShell è ora il modulo di PowerShell consigliato per l'interazione con Azure e hub Azure Stack.The Az PowerShell module is now the recommended PowerShell module for interacting with Azure and Azure Stack Hub. Per iniziare a usare il modulo AZ PowerShell, vedere Install PowerShell AZ Preview Module for Azure stack Hub.To get started with the Az PowerShell module, see Install PowerShell Az preview module for Azure Stack Hub. Per informazioni su come eseguire la migrazione al modulo AZ PowerShell.To learn how to migrate to the Az PowerShell module. vedere eseguire la migrazione da AzureRM a Azure PowerShell AZ nell'Hub Azure stack.see Migrate from AzureRM to Azure PowerShell Az in Azure Stack Hub.

È anche necessario usare i profili API per specificare gli endpoint compatibili per i provider di risorse dell'hub Azure stack.You also need to 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 Azure Stack moduli di PowerShell compatibili con hub in scenari connessi a Internet, parzialmente connessi o disconnessi.You can install Azure Stack Hub compatible PowerShell 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.

È anche possibile eseguire i moduli Azure Resource Manager per Azure Stack Hub in un contenitore docker.You can also run the Azure Resource Manager 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.

1. verificare i prerequisiti1. Verify your prerequisites

Prima di iniziare a usare Azure Stack Hub e il modulo di Azure Resource Manager di PowerShell, è necessario disporre dei prerequisiti seguenti:Before you get started with Azure Stack Hub and the PowerShell Azure Resource Manager module, you must have the following prerequisites:

  • PowerShell versione 5,1PowerShell Version 5.1
    Per verificare la versione, eseguire $psversiontable. psversion e confrontare la versione principale .To check your version, run $PSVersionTable.PSVersion and compare the Major version. Se non si dispone di PowerShell 5,1, seguire la procedura di installazione di Windows PowerShell.If you don't have PowerShell 5.1, follow the Installing Windows PowerShell.

    Nota

    PowerShell 5,1 richiede un computer Windows.PowerShell 5.1 requires a Windows machine.

  • Eseguire PowerShell in un prompt dei comandi con privilegi elevati.Run PowerShell in an elevated command prompt.

  • Accesso PowerShell GalleryPowerShell Gallery access
    È necessario accedere al PowerShell Gallery.You need access to the PowerShell Gallery. La raccolta è il repository centrale per il contenuto di PowerShell.The gallery is the central repository for PowerShell content. Il modulo PowerShellGet contiene i cmdlet per l'individuazione, l'installazione, l'aggiornamento e la pubblicazione di elementi di PowerShell.The PowerShellGet module contains cmdlets for discovering, installing, updating, and publishing PowerShell artifacts. Esempi di questi elementi sono moduli, risorse DSC, capacità del ruolo e script da PowerShell Gallery e altri repository privati.Examples of these artifacts are modules, DSC resources, role capabilities, and scripts from the PowerShell Gallery and other private repositories. Se si usa PowerShell in uno scenario disconnesso, è necessario recuperare le risorse da un computer con una connessione a Internet e archiviarle in una posizione accessibile al computer disconnesso.If you're using PowerShell in a disconnected scenario, you must retrieve resources from a machine with a connection to the internet and store them in a location accessible to your disconnected machine.

Verificare se PSGallery è registrato come repository.Validate if PSGallery is registered as a repository.

Nota

Questo passaggio richiede l'accesso a Internet.This step requires internet access.

Aprire un prompt di PowerShell con privilegi elevati ed eseguire i cmdlet seguenti:Open an elevated PowerShell prompt, and run the following cmdlets:

Install-module -Name PowerShellGet -Force
Import-Module -Name PackageManagement -ErrorAction Stop
Get-PSRepository -Name "PSGallery"

Se il repository non è registrato, aprire una sessione di PowerShell con privilegi elevati ed eseguire il comando seguente:If the repository isn't registered, open an elevated PowerShell session and run the following command:

Register-PSRepository -Default
Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted

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 tutti gli hub Azure Stack installati in precedenza Azure Resource Manager moduli di PowerShell.Before installing the required version, make sure that you uninstall any previously installed Azure Stack Hub Azure Resource Manager 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: installare PowerShell per Azure Stack Hub con connettività Internet4. Connected: Install PowerShell for Azure Stack Hub with internet connectivity

Il profilo della versione dell'API e i moduli di PowerShell di Azure Stack Hub necessari dipendono dalla versione dell'hub Azure Stack in esecuzione.The API version profile and Azure Stack Hub PowerShell modules you require will depend on the version of Azure Stack Hub you're running.

Installare Azure Stack PowerShell per hubInstall Azure Stack Hub PowerShell

Eseguire lo script di PowerShell seguente per installare questi moduli nella workstation di sviluppo:Run the following PowerShell script to install these modules on your development workstation:

Per Azure Stack Hub 2002 o versione successiva:For Azure Stack Hub 2002 or later:

È possibile usare i moduli AzureRm utente o AZ Preview.You can use either user AzureRm modules or Az preview modules. Per l'uso dei moduli AZ è necessario Azure Stack Hub 2002 e l'hotfix più recente.The use of the Az modules requires Azure Stack Hub 2002 and the latest hotfix.

Per usare AZ Preview Modules, seguire le istruzioni disponibili in Install PowerShell AZ Module.To use Az preview modules, follow the instructions at Install PowerShell Az module.

# 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 Hub into the current PowerShell session.
Use-AzureRmProfile -Profile 2019-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.8.2

Per Azure Stack Hub 1910:For Azure Stack Hub 1910:

# 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 Hub into the current PowerShell session.
Use-AzureRmProfile -Profile 2019-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.8.0

Nota

  • Azure Stack versione del modulo dell'hub 1.8.0 è una versione di modifica di rilievo.Azure Stack Hub module version 1.8.0 is a breaking change release. Per informazioni dettagliate, vedere la Nota sulla versione .Refer to the release note for details.

Per Azure Stack Hub 1908 o versioni precedenti:For Azure Stack Hub 1908 or earlier:

# 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 Hub into the current PowerShell session.
Use-AzureRmProfile -Profile 2019-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.7.2

Nota

La versione del modulo Hub Azure Stack 1.7.2 è una versione di modifica di rilievo.The Azure Stack Hub module version 1.7.2 is a breaking change release. Per eseguire la migrazione da Azure Stack hub 1.6.0, consultare la Guida alla migrazione.To migrate from Azure Stack Hub 1.6.0, please refer to the migration guide.

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 "Azure*" -ListAvailable
Get-Module -Name "Azs*" -ListAvailable

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

5. disconnesso: installare PowerShell senza una connessione Internet5. Disconnected: Install PowerShell without an 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 i moduli Azure Resource Manager o AZ Preview.You could either use Azure Resource Manager or Az preview modules. Per AZ Modules, vedere istruzioni in Install PowerShell AZ Module.For Az modules, see instructions at Install PowerShell Az module.


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

$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 2.5.0
Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureStack -Path $Path -Force -RequiredVersion 1.8.2

Hub Azure Stack 1910.Azure Stack Hub 1910.

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

$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 2.5.0
Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureStack -Path $Path -Force -RequiredVersion 1.8.0

Nota

Azure Stack versione del modulo dell'hub 1.8.0 è una versione di modifica di rilievo.Azure Stack Hub module version 1.8.0 is a breaking change release. Per informazioni dettagliate, vedere la Nota sulla versione .Refer to the release note for details.

Per Azure Stack Hub 1908 o versioni precedenti:For Azure Stack Hub 1908 or earlier:

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

$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 2.5.0
Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureStack -Path $Path -Force -RequiredVersion 1.7.2

Nota

La versione del modulo Hub Azure Stack 1.7.1 è una modifica di rilievo.The Azure Stack Hub module version 1.7.1 is a breaking change. Per eseguire la migrazione da Azure Stack hub 1.6.0, consultare la Guida alla migrazione.To migrate from Azure Stack Hub 1.6.0 please refer to the migration guide.

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-AzureRmDataCollection

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 il Azure Resource Manager e i AzureStack moduli da questo repository:Register this location as the default repository and install the Azure Resource Manager 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"
    
    Register-PSRepository -Name $RepoName -SourceLocation $SourceLocation -InstallationPolicy Trusted
    
    Install-Module -Name AzureRM -Repository $RepoName
    
    Install-Module -Name AzureStack -Repository $RepoName
    

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 "Azure*" -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
    

Problema notoKnown issue

Errore get_SerializationSettings metodoMethod get_SerializationSettings error

  • Motivo: i moduli di PowerShell AZ Module e PowerShell Azure Resource Manager non sono compatibili.Cause: The PowerShell Az module and PowerShell Azure Resource Manager modules are not compatible.

    L'errore seguente indica che i moduli Azure Resource Manager e AZ Modules vengono caricati nella stessa sessione:The following error indicates that the Azure Resource Manager modules and Az modules are loaded in the same session:

    >  Method 'get_SerializationSettings' in type 'Microsoft.Azure.Management.Internal.Resources.ResourceManagementClient' from assembly 'Microsoft.Azure.Commands.ResourceManager.Common, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' does 
    not have an implementation.
    
  • Correzione: disinstallare i moduli in conflitto.Remediation: Uninstall the conflicting modules.

    Se si vuole usare i moduli di Azure Resource Manager, disinstallare i moduli AZ.If you would like to use the Azure Resource Manager modules, uninstall the Az modules. In alternativa, disinstallare il Azure Resource Manager se si desidera utilizzare il comando AZ modules.Or uninstall the Azure Resource Manager if you would like to use the Az modules. Chiudere la sessione di PowerShell e disinstallare i moduli AZ o Azure Resource Manager.Close your PowerShell session and uninstall either the Az or Azure Resource Manager modules.

    Per istruzioni, vedere disinstallare le versioni esistenti dei moduli di PowerShell per Hub Azure stack.You can find instructions at Uninstall existing versions of the Azure Stack Hub PowerShell modules.

Passaggi successiviNext steps