Gestire i profili di versione API in Azure StackManage API version profiles in Azure Stack

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

I profili della versione API consentono di gestire le differenze di versione tra Azure e Azure Stack.API version profiles provide a way to manage version differences between Azure and Azure Stack. Un profilo di versione API è un set di moduli AzureRM PowerShell con le versioni API specifiche.An API version profile is a set of AzureRM PowerShell modules with specific API versions. Ogni piattaforma cloud dispone di un set di profili di versione API supportati.Each cloud platform has a set of supported API version profiles. Ad esempio, Stack di Azure supporta una versione specifica del profilo con data di validità, ad esempio 2017-03-09-profilo, e Azure supporta il più recente profilo versione API.For example, Azure Stack supports a specific dated profile version such as 2017-03-09-profile, and Azure supports the latest API version profile. Quando si installa un profilo, vengono installati i moduli AzureRM PowerShell che corrispondono al profilo specificato.When you install a profile, the AzureRM PowerShell modules that correspond to the specified profile are installed.

Installare il modulo di PowerShell, è necessario utilizzare i profili della versione APIInstall the PowerShell module required to use API version profiles

Il AzureRM.Bootstrapper modulo che è disponibile tramite la raccolta di PowerShell fornisce cmdlet di PowerShell necessari per lavorare con i profili di versione API.The AzureRM.Bootstrapper module that is available through the PowerShell Gallery provides PowerShell cmdlets that are required to work with API version profiles. Usare il cmdlet seguente per installare il modulo AzureRM.Bootstrapper:Use the following cmdlet to install the AzureRM.Bootstrapper module:

Install-Module -Name AzureRm.BootStrapper

Il modulo AzureRM.Bootstrapper è in anteprima. dettagli e funzionalità sono soggette a modifiche.The AzureRM.Bootstrapper module is in preview; details and functionality are subject to change. Per scaricare e installare la versione più recente di questo modulo da PowerShell Gallery, eseguire il cmdlet seguente:To download and install the latest version of this module from the PowerShell Gallery, run the following cmdlet:

Update-Module -Name "AzureRm.BootStrapper"

Installare un profiloInstall a profile

Utilizzare il installazione AzureRmProfile cmdlet con il 2017-03-09-profilo profilo versione API per installare i moduli di Azure Resource Manager necessari dallo Stack di Azure.Use the Install-AzureRmProfile cmdlet with the 2017-03-09-profile API version profile to install the AzureRM modules required by Azure Stack. Si noti che i moduli di operatore dello Stack di Azure non vengono installati con questo profilo versione API e devono essere installati separatamente come specificato nel passaggio 3 del installare PowerShell per Azure Stack articolo.Note that the Azure Stack operator modules are not installed with this API version profile, and they should be installed separately as specified in the Step 3 of the Install PowerShell for Azure Stack article.

Install-AzureRMProfile -Profile 2017-03-09-profile

Installare e importare i moduli in un profiloInstall and import modules in a profile

Utilizzare il utilizzare AzureRmProfile cmdlet per installare e importare i moduli che sono associati a un profilo di versione API.Use the Use-AzureRmProfile cmdlet to install and import modules that are associated with an API version profile. È possibile importare solo un profilo di versione API in una sessione di PowerShell.You can import only one API version profile in a PowerShell session. Per importare un profilo di versione API diverso, è necessario aprire una nuova sessione di PowerShell.To import a different API version profile, you must open a new PowerShell session. Il cmdlet di uso AzureRMProfile esegue le seguenti attività:The Use-AzureRMProfile cmdlet runs the following tasks:

  1. Controlla se i moduli di PowerShell associati al profilo di versione API specificato vengono installati nell'ambito corrente.Checks if the PowerShell modules associated with the specified API version profile are installed in the current scope.
  2. Scarica e installa i moduli se non sono già installati.Downloads and installs the modules if they are not already installed.
  3. Importa i moduli nella sessione corrente di PowerShell.Imports the modules into the current PowerShell session.
# Installs and imports the specified API version profile into the current PowerShell session.
Use-AzureRmProfile -Profile 2017-03-09-profile -Scope CurrentUser

# Installs and imports the specified API version profile into the current PowerShell session without any prompts
Use-AzureRmProfile -Profile 2017-03-09-profile -Scope CurrentUser -Force

Per installare e importare i moduli di Azure Resource Manager selezionati da un profilo di versione API, eseguire il cmdlet di uso AzureRMProfile con il modulo parametro:To install and import selected AzureRM modules from an API version profile, run the Use-AzureRMProfile cmdlet with the Module parameter:

# Installs and imports the compute, Storage and Network modules from the specified API version profile into your current PowerShell session.
Use-AzureRmProfile -Profile 2017-03-09-profile -Module AzureRM.Compute, AzureRM.Storage, AzureRM.Network

Ottenere l'elenco dei profili installatiGet the installed profiles

Utilizzare il Get AzureRmProfile per ottenere l'elenco dei profili di versione API disponibili:Use the Get-AzureRmProfile cmdlet to get the list of available API version profiles:

# lists all API version profiles provided by the AzureRM.BootStrapper module.
Get-AzureRmProfile -ListAvailable 

# lists the API version profiles which are installed on your machine
Get-AzureRmProfile

Aggiornare i profiliUpdate profiles

Utilizzare il aggiornamento AzureRmProfile cmdlet per aggiornare i moduli in un profilo di versione API per la versione più recente dei moduli disponibili nel PSGallery.Use the Update-AzureRmProfile cmdlet to update the modules in an API version profile to the latest version of modules that are available in the PSGallery. È consigliabile per eseguire sempre il aggiornamento AzureRmProfile cmdlet in una nuova sessione di PowerShell per evitare conflitti durante l'importazione di moduli.It's recommended to always run the Update-AzureRmProfile cmdlet in a new PowerShell session to avoid conflicts when importing modules. Il cmdlet Update-AzureRmProfile esegue le seguenti attività:The Update-AzureRmProfile cmdlet runs the following tasks:

  1. Controlla se le versioni più recenti dei moduli installate nel profilo versione API specificato per l'ambito corrente.Checks if the latest versions of modules are installed in the given API version profile for the current scope.
  2. Viene richiesto di installare, se non sono già installati.Prompts you to install if they are not already installed.
  3. Installa e Importa i moduli aggiornati nella sessione di PowerShell corrente.Installs and imports the updated modules into the current PowerShell session.
Update-AzureRmProfile -Profile 2017-03-09-profile

Per rimuovere le versioni dei moduli installate in precedenza prima di aggiornare alla versione più recente disponibile, utilizzare il cmdlet Update-AzureRmProfile insieme al - RemovePreviousVersions parametro:To remove the previously installed versions of the modules before updating to the latest available version, use the Update-AzureRmProfile cmdlet along with the -RemovePreviousVersions parameter:

Update-AzureRmProfile -Profile 2017-03-09-profile -RemovePreviousVersions

Questo cmdlet esegue le seguenti attività:This cmdlet runs the following tasks:

  1. Controlla se le versioni più recenti dei moduli installate nel profilo versione API specificato per l'ambito corrente.Checks if the latest versions of modules are installed in the given API version profile for the current scope.
  2. Rimuove le versioni dei moduli dal profilo versione API corrente e nella sessione di PowerShell corrente.Removes the older versions of modules from the current API version profile and in the current PowerShell session.
  3. viene richiesto di installare la versione più recente.prompts you to install the latest version.
  4. Installa e Importa i moduli aggiornati nella sessione di PowerShell corrente.Installs and imports the updated modules into the current PowerShell session.

Disinstallare i profiliUninstall profiles

Utilizzare il Disinstalla AzureRmProfile cmdlet per disinstallare il profilo di versione API specificato.Use the Uninstall-AzureRmProfile cmdlet to uninstall the specified API version profile.

Uninstall-AzureRmProfile -Profile 2017-03-09-profile

Passaggi successiviNext steps