Installare l'interfaccia della riga di comando di Azure nell'hub Azure StackInstall Azure CLI on Azure Stack Hub

È possibile installare l'interfaccia della riga di comando di Azure per gestire Azure Stack Hub con computer Windows o Linux.You can install the Azure CLI to manage Azure Stack Hub with a Windows or Linux machines. Questo articolo illustra la procedura di installazione e configurazione dell'interfaccia della riga di comando di Azure.This article walks you through the steps of installing and setting up Azure CLI.

Installare l'interfaccia da riga di comando di AzureInstall Azure CLI

  1. Accedere alla workstation di sviluppo e installare l'interfaccia della riga di comando.Sign in to your development workstation and install CLI. Hub Azure Stack richiede la versione 2,0 o successiva dell'interfaccia della riga di comando di Azure.Azure Stack Hub requires version 2.0 or later of Azure CLI.

  2. È possibile installare l'interfaccia della riga di comando seguendo la procedura descritta nell'articolo installare l'interfaccia della riga di comando di Azure.You can install the CLI by using the steps described in the Install the Azure CLI article.

  3. Per verificare se l'installazione è stata completata, aprire un terminale o una finestra del prompt dei comandi ed eseguire il comando seguente:To verify whether the installation was successful, open a terminal or command prompt window and run the following command:

    az --version
    

    Verrà visualizzata la versione dell'interfaccia della riga di comando di Azure e altre librerie dipendenti installate nel computer.You should see the version of Azure CLI and other dependent libraries that are installed on your computer.

    INTERFACCIA della riga di comando di Azure in Azure Stack percorso Python

  4. Prendere nota del percorso Python dell'interfaccia della riga di comando.Make a note of the CLI's Python location. Se si sta eseguendo il Gabriele, è necessario usare questo percorso per aggiungere il certificato.If you're running the ASDK, you need to use this location to add your certificate. Per istruzioni sulla configurazione dei certificati per l'installazione dell'interfaccia della riga di comando in Gabriele, vedere Configurazione dei certificati per l'interfaccia della riga di comando di Azure in Azure stack Development Kit.For instructions on setting up certificates for installing the CLI on the ASDK, see Setting up certificates for Azure CLI on Azure Stack Development Kit.

Connettersi all'interfaccia della riga di comando di AzureConnect with Azure CLI

Questa sezione illustra la configurazione dell'interfaccia della riga di comando se si usa Azure AD come servizio di gestione delle identità e si usa l'interfaccia della riga di comando in un computer Windows.This section walks you through setting up CLI if you're using Azure AD as your identity management service, and are using CLI on a Windows machine.

Connettersi all'hub Azure StackConnect to Azure Stack Hub

  1. Se si usa Gabriele, considerare attendibile il certificato radice CA dell'hub Azure Stack.If you are using the ASDK, trust the Azure Stack Hub CA root certificate. Per istruzioni, vedere attendibilità del certificato.For instruction, see Trust the certificate.

  2. Registrare l'ambiente dell'hub Azure Stack eseguendo il az cloud register comando.Register your Azure Stack Hub environment by running the az cloud register command.

  3. Registrare l'ambiente.Register your environment. Quando si esegue, usare i parametri seguenti az cloud register :Use the following parameters when running az cloud register:

    ValoreValue EsempioExample DescrizioneDescription
    Nome ambienteEnvironment name AzureStackUserAzureStackUser Usare AzureStackUser per l'ambiente utente.Use AzureStackUser for the user environment. Se si è operatore, specificare AzureStackAdmin .If you're operator, specify AzureStackAdmin.
    L'endpoint di Resource ManagerResource Manager endpoint https://management.contoso.onmicrosoft.com Il ResourceManagerUrl in Gabriele è: https://management.local.azurestack.external/ il ResourceManagerUrl in sistemi integrati è: in https://management.<region>.<fqdn>/ caso di domande sull'endpoint di sistema integrato, contattare l'operatore cloud.The ResourceManagerUrl in the ASDK is: https://management.local.azurestack.external/ The ResourceManagerUrl in integrated systems is: https://management.<region>.<fqdn>/ If you have a question about the integrated system endpoint, contact your cloud operator.
    Endpoint di archiviazioneStorage endpoint local.contoso.onmicrosoft.comlocal.contoso.onmicrosoft.com local.azurestack.external è per Gabriele.local.azurestack.external is for the ASDK. Per un sistema integrato, usare un endpoint per il sistema.For an integrated system, use an endpoint for your system.
    Suffisso dell'insieme di credenziali delle credenzialiKeyvault suffix . vault.contoso.onmicrosoft.com.vault.contoso.onmicrosoft.com .vault.local.azurestack.external è per Gabriele..vault.local.azurestack.external is for the ASDK. Per un sistema integrato, usare un endpoint per il sistema.For an integrated system, use an endpoint for your system.
    ID risorsa grafico endpoint Active DirectoryEndpoint active directory graph resource ID https://graph.windows.net/ ID risorsa di Active Directory.The Active Directory resource ID.
    az cloud register `
        -n <environmentname> `
        --endpoint-resource-manager "https://management.<region>.<fqdn>" `
        --suffix-storage-endpoint "<fqdn>" `
        --suffix-keyvault-dns ".vault.<fqdn>" `
        --endpoint-active-directory-graph-resource-id "https://graph.windows.net/"
    

    È possibile trovare un riferimento per il comando Register nella documentazione di riferimento dell'interfaccia della riga di comando di Azure.You can find a reference for the register command in the Azure CLI reference documentation.

  4. Per impostare l'ambiente attivo, usare i comandi seguenti.Set the active environment by using the following commands.

    az cloud set -n <environmentname>
    
  5. Aggiornare la configurazione dell'ambiente per usare il profilo della versione API specifica dell'hub Azure Stack.Update your environment configuration to use the Azure Stack Hub specific API version profile. Per aggiornare la configurazione, eseguire il comando seguente:To update the configuration, run the following command:

    az cloud update --profile 2019-03-01-hybrid
    
  6. Accedere all'ambiente di Azure Stack hub usando il az login comando.Sign in to your Azure Stack Hub environment by using the az login command.

    È possibile accedere all'ambiente di Azure Stack hub usando le credenziali utente o con un' entità servizio (SPN) fornita dall'operatore cloud.You can sign in to the Azure Stack Hub environment using your user credentials, or with a service principal (SPN) provided to you by your cloud operator.

    • Accedere come utente:Sign in as a user:

      È possibile specificare il nome utente e una password direttamente all'interno del comando az login oppure eseguire l'autenticazione tramite un browser.You can either specify the username and password directly within the az login command, or authenticate by using a browser. È necessario eseguire quest'ultimo se per l'account è abilitata l'autenticazione a più fattori:You must do the latter if your account has multi-factor authentication enabled:

      az login -u "user@contoso.onmicrosoft.com" -p 'Password123!' --tenant contoso.onmicrosoft.com
      

      Nota

      Se per l'account utente è abilitata l'autenticazione a più fattori, usare il az login comando senza fornire il -u parametro.If your user account has multi-factor authentication enabled, use the az login command without providing the -u parameter. L'esecuzione di questo comando fornisce un URL e un codice che è necessario usare per l'autenticazione.Running this command gives you a URL and a code that you must use to authenticate.

    • Accedere come entità servizio:Sign in as a service principal:

      Prima di eseguire l'accesso, creare un'entità servizio tramite l'portale di Azure o l'interfaccia della riga di comando e assegnarle un ruolo.Before you sign in, create a service principal through the Azure portal or CLI and assign it a role. A questo punto, accedere usando il comando seguente:Now, sign in by using the following command:

      az login `
        --tenant <Azure Active Directory Tenant name. `
                  For example: myazurestack.onmicrosoft.com> `
      --service-principal `
        -u <Application Id of the Service Principal> `
        -p <Key generated for the Service Principal>
      
  7. Verificare che l'ambiente sia impostato correttamente e che l'ambiente sia attivo.Verify that your environment is set correctly and that your environment is the active cloud.

        az cloud list --output table
    

Si noterà che l'ambiente è elencato e che è inattivo true .You should see that your environment is listed and IsActive is true. Ad esempio:For example:

IsActive    Name               Profile
----------  -----------------  -----------------
False       AzureCloud         2019-03-01-hybrid
False       AzureChinaCloud    latest
False       AzureUSGovernment  latest
False       AzureGermanCloud   latest
True        AzureStackUser     2019-03-01-hybrid

Testare la connettivitàTest the connectivity

Con tutti gli elementi impostati, usare l'interfaccia della riga di comando per creare risorse all'interno Azure Stack Hub.With everything set up, use CLI to create resources within Azure Stack Hub. Ad esempio, è possibile creare un gruppo di risorse per un'app e aggiungere una macchina virtuale.For example, you can create a resource group for an app and add a VM. Usare il comando seguente per creare un gruppo di risorse denominato "MyResourceGroup":Use the following command to create a resource group named "MyResourceGroup":

az group create -n MyResourceGroup -l local

Se il gruppo di risorse viene creato correttamente, il comando precedente restituisce le seguenti proprietà della risorsa appena creata:If the resource group is created successfully, the previous command outputs the following properties of the newly created resource:

Creazione output del gruppo di risorse

Passaggi successiviNext steps