Installera Azure CLI på Azure Stack hubbInstall Azure CLI on Azure Stack Hub

Du kan installera Azure CLI för att hantera Azure Stack hubb med en Windows-eller Linux-dator.You can install the Azure CLI to manage Azure Stack Hub with a Windows or Linux machines. Den här artikeln vägleder dig genom stegen för att installera och konfigurera Azure CLI.This article walks you through the steps of installing and setting up Azure CLI.

Installera Azure CLIInstall Azure CLI

  1. Logga in på din utvecklings arbets Station och installera CLI.Sign in to your development workstation and install CLI. Azure Stack Hub kräver version 2,0 eller senare av Azure CLI.Azure Stack Hub requires version 2.0 or later of Azure CLI.

  2. Du kan installera CLI genom att följa stegen som beskrivs i artikeln Installera Azure CLI .You can install the CLI by using the steps described in the Install the Azure CLI article.

  3. Du kan kontrol lera om installationen lyckades genom att öppna en terminal-eller kommando tolks fönster och köra följande kommando:To verify whether the installation was successful, open a terminal or command prompt window and run the following command:

    az --version
    

    Du bör se versionen av Azure CLI och andra beroende bibliotek som är installerade på datorn.You should see the version of Azure CLI and other dependent libraries that are installed on your computer.

    Azure CLI på Azure Stack hubbens python-plats

  4. Anteckna CLI: s python-plats.Make a note of the CLI's Python location. Om du kör ASDK måste du använda den här platsen för att lägga till ditt certifikat.If you're running the ASDK, you need to use this location to add your certificate. Instruktioner för hur du konfigurerar certifikat för att installera CLI på ASDK finns i Konfigurera certifikat för Azure CLI på 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.

Anslut med Azure CLIConnect with Azure CLI

Det här avsnittet beskriver hur du konfigurerar CLI om du använder Azure AD som identitets hanterings tjänst och använder CLI på en Windows-dator.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.

Anslut till Azure Stack hubbConnect to Azure Stack Hub

  1. Om du använder ASDK litar du på certifikat utfärdarens rot certifikat för Azure Stack Hub.If you are using the ASDK, trust the Azure Stack Hub CA root certificate. Instruktioner finns i lita på certifikatet.For instruction, see Trust the certificate.

  2. Registrera din Azure Stack Hub-miljö genom att köra az cloud register kommandot.Register your Azure Stack Hub environment by running the az cloud register command.

  3. Registrera din miljö.Register your environment. Använd följande parametrar när du kör az cloud register :Use the following parameters when running az cloud register:

    VärdeValue ExempelExample BeskrivningDescription
    MiljönamnEnvironment name AzureStackUserAzureStackUser Används AzureStackUser för användar miljön.Use AzureStackUser for the user environment. Om du är operator anger du AzureStackAdmin .If you're operator, specify AzureStackAdmin.
    Resource Manager-slutpunktResource Manager endpoint https://management.contoso.onmicrosoft.com ResourceManagerUrl i ASDK är: https://management.local.azurestack.external/ ResourceManagerUrl i integrerade system är: https://management.<region>.<fqdn>/ om du har en fråga om den integrerade system slut punkten kontaktar du moln operatören.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.
    Lagrings slut punktStorage endpoint local.contoso.onmicrosoft.comlocal.contoso.onmicrosoft.com local.azurestack.external är för ASDK.local.azurestack.external is for the ASDK. För ett integrerat system använder du en slut punkt för ditt system.For an integrated system, use an endpoint for your system.
    Suffix för nyckel valvKeyvault suffix . vault.contoso.onmicrosoft.com.vault.contoso.onmicrosoft.com .vault.local.azurestack.external är för ASDK..vault.local.azurestack.external is for the ASDK. För ett integrerat system använder du en slut punkt för ditt system.For an integrated system, use an endpoint for your system.
    Resurs-ID för Endpoint Active Directory-GrafEndpoint active directory graph resource ID https://graph.windows.net/ Resurs-ID:t för Azure 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/"
    

    Du hittar en referens för register kommandot i referens dokumentationen för Azure CLI.You can find a reference for the register command in the Azure CLI reference documentation.

  4. Ange den aktiva miljön med hjälp av följande kommandon.Set the active environment by using the following commands.

    az cloud set -n <environmentname>
    
  5. Uppdatera din miljö konfiguration så att den använder den Azure Stack Hub Specific API-versionen.Update your environment configuration to use the Azure Stack Hub specific API version profile. Kör följande kommando för att uppdatera konfigurationen:To update the configuration, run the following command:

    az cloud update --profile 2019-03-01-hybrid
    
  6. Logga in på din Azure Stack Hub-miljö med hjälp av az login kommandot.Sign in to your Azure Stack Hub environment by using the az login command.

    Du kan logga in på Azure Stack Hub-miljön med hjälp av dina autentiseringsuppgifter, eller med ett tjänst huvud namn (SPN) som du fått av din moln operatör.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.

    • Logga in som en användare:Sign in as a user:

      Du kan antingen ange användar namn och lösen ord direkt i az login kommandot eller autentisera med hjälp av en webbläsare.You can either specify the username and password directly within the az login command, or authenticate by using a browser. Du måste göra det senare om ditt konto har Multi-Factor Authentication aktiverat: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
      

      Anteckning

      Om ditt användar konto har Multi-Factor Authentication aktiverat använder du az login kommandot utan att ange -u parametern.If your user account has multi-factor authentication enabled, use the az login command without providing the -u parameter. Genom att köra det här kommandot får du en URL och en kod som du måste använda för att autentisera.Running this command gives you a URL and a code that you must use to authenticate.

    • Logga in som tjänstens huvud namn:Sign in as a service principal:

      Innan du loggar in skapar du ett huvud namn för tjänsten via Azure Portal eller CLI och tilldelar den en roll.Before you sign in, create a service principal through the Azure portal or CLI and assign it a role. Logga nu in med följande kommando: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. Kontrol lera att din miljö är korrekt inställd och att din miljö är det aktiva molnet.Verify that your environment is set correctly and that your environment is the active cloud.

        az cloud list --output table
    

Du bör se att din miljö finns i listan och att IsActive är true .You should see that your environment is listed and IsActive is true. Ett exempel: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

Testa anslutningenTest the connectivity

Med allt konfigurerat använder du CLI för att skapa resurser inom Azure Stack Hub.With everything set up, use CLI to create resources within Azure Stack Hub. Du kan till exempel skapa en resurs grupp för en app och lägga till en virtuell dator.For example, you can create a resource group for an app and add a VM. Använd följande kommando för att skapa en resurs grupp med namnet "MyResourceGroup":Use the following command to create a resource group named "MyResourceGroup":

az group create -n MyResourceGroup -l local

Om resurs gruppen har skapats, kommer föregående kommando att mata ut följande egenskaper för den nyligen skapade resursen:If the resource group is created successfully, the previous command outputs the following properties of the newly created resource:

Skapa utdata för resurs grupp

Nästa stegNext steps