Azure CLI installeren op Azure Stack hubInstall Azure CLI on Azure Stack Hub

  • 12 minuten om te lezen

U kunt de Azure CLI installeren om Azure Stack hub te beheren met een Windows-of Linux-computer.You can install the Azure CLI to manage Azure Stack Hub with a Windows or Linux machines. Dit artikel begeleidt u stapsgewijs door de procedure voor het installeren en instellen van Azure CLI.This article walks you through the steps of installing and setting up Azure CLI.

Azure CLI installerenInstall Azure CLI

  1. Meld u aan bij uw ontwikkel werkstation en installeer CLI.Sign in to your development workstation and install CLI. Voor Azure Stack hub is versie 2,0 of hoger van Azure CLI vereist.Azure Stack Hub requires version 2.0 or later of Azure CLI.

  2. U kunt de CLI installeren met behulp van de stappen die worden beschreven in het artikel Azure cli installeren .You can install the CLI by using the steps described in the Install the Azure CLI article.

  3. Als u wilt controleren of de installatie is voltooid, opent u een Terminal-of opdracht prompt venster en voert u de volgende opdracht uit:To verify whether the installation was successful, open a terminal or command prompt window and run the following command:

    az --version

    U moet de versie van Azure CLI en andere afhankelijke bibliotheken zien die op uw computer zijn geïnstalleerd.You should see the version of Azure CLI and other dependent libraries that are installed on your computer.

    Locatie van Azure CLI op Azure Stack hub python

  4. Noteer de locatie van Python voor de CLI.Make a note of the CLI's Python location. Als u de ASDK uitvoert, moet u deze locatie gebruiken om uw certificaat toe te voegen.If you're running the ASDK, you need to use this location to add your certificate. Zie certificaten instellen voor Azure CLI op Azure stack Development Kitvoor instructies over het instellen van certificaten voor het installeren van de CLI op het ASDK.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.

Verbinding maken met Azure CLIConnect with Azure CLI

In deze sectie wordt uitgelegd hoe u CLI kunt instellen als u Azure AD als uw identiteits beheer service gebruikt en CLI gebruikt op een Windows-computer.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.

Verbinding maken met Azure Stack hubConnect to Azure Stack Hub

  1. Als u de ASDK gebruikt, vertrouwt u het CA-basis certificaat van de Azure Stack hub.If you are using the ASDK, trust the Azure Stack Hub CA root certificate. Zie het certificaat vertrouwenvoor instructies.For instruction, see Trust the certificate.

  2. Registreer uw Azure Stack hub-omgeving door de opdracht uit te voeren az cloud register .Register your Azure Stack Hub environment by running the az cloud register command.

  3. Registreer uw omgeving.Register your environment. Gebruik de volgende para meters bij het uitvoeren van az cloud register :Use the following parameters when running az cloud register:

    WaardeValue VoorbeeldExample BeschrijvingDescription
    OmgevingsnaamEnvironment name AzureStackUserAzureStackUser Gebruiken AzureStackUser voor de gebruikers omgeving.Use AzureStackUser for the user environment. Als u operator bent, geeft u op AzureStackAdmin .If you're operator, specify AzureStackAdmin.
    Resource Manager-eindpuntResource Manager endpoint https://management.contoso.onmicrosoft.com De ResourceManagerUrl in de ASDK is: https://management.contoso.onmicrosoft.com/ de ResourceManagerUrl in geïntegreerde systemen is: https://management.<region>.<fqdn>/ Als u een vraag hebt over het geïntegreerde systeem eindpunt, neemt u contact op met uw Cloud operator.The ResourceManagerUrl in the ASDK is: https://management.contoso.onmicrosoft.com/ The ResourceManagerUrl in integrated systems is: https://management.<region>.<fqdn>/ If you have a question about the integrated system endpoint, contact your cloud operator.
    OpslageindpuntStorage endpoint local.contoso.onmicrosoft.comlocal.contoso.onmicrosoft.com local.azurestack.external is voor de ASDK.local.azurestack.external is for the ASDK. Gebruik voor een geïntegreerd systeem een eind punt voor uw systeem.For an integrated system, use an endpoint for your system.
    Achtervoegsel voor sleutel kluisKeyvault suffix . vault.contoso.onmicrosoft.com.vault.contoso.onmicrosoft.com .vault.local.azurestack.external is voor de ASDK..vault.local.azurestack.external is for the ASDK. Gebruik voor een geïntegreerd systeem een eind punt voor uw systeem.For an integrated system, use an endpoint for your system.
    Resource-ID van de Active Directory-grafiek van het eind puntEndpoint active directory graph resource ID https://graph.windows.net/ De resource-id voor 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/"

    U vindt een verwijzing voor de registratie opdracht in de Azure cli-referentie documentatie.You can find a reference for the register command in the Azure CLI reference documentation.

  4. Stel de actieve omgeving in met behulp van de volgende opdrachten.Set the active environment by using the following commands.

    az cloud set -n <environmentname>

  5. Werk uw omgevings configuratie bij om het API-versie Profiel van de Azure Stack hub te gebruiken.Update your environment configuration to use the Azure Stack Hub specific API version profile. Voer de volgende opdracht uit om de configuratie bij te werken:To update the configuration, run the following command:

    az cloud update --profile 2019-03-01-hybrid

  6. Meld u aan bij uw Azure Stack hub-omgeving met behulp van de az login opdracht.Sign in to your Azure Stack Hub environment by using the az login command.

    U kunt zich aanmelden bij de Azure Stack hub-omgeving met behulp van uw gebruikers referenties of met een Service-Principal (SPN) die u hebt ontvangen van uw Cloud operator.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.

    • Meld u aan als een gebruiker:Sign in as a user:

      U kunt de gebruikersnaam en het wachtwoord rechtstreeks opgeven met de opdracht az login of verifiëren met behulp van een browser.You can either specify the username and password directly within the az login command, or authenticate by using a browser. U moet dit doen als voor uw account multi-factor Authentication is ingeschakeld: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

      Notitie

      Als voor uw gebruikers account multi-factor Authentication is ingeschakeld, gebruikt u de az login opdracht zonder de para meter op te geven -u .If your user account has multi-factor authentication enabled, use the az login command without providing the -u parameter. Als u deze opdracht uitvoert, hebt u een URL en een code die u moet gebruiken om te verifiëren.Running this command gives you a URL and a code that you must use to authenticate.

    • Aanmelden als service- Principal:Sign in as a service principal:

      Voordat u zich aanmeldt, maakt u een Service-Principal via de Azure Portal of CLI en wijst u deze toe aan een rol.Before you sign in, create a service principal through the Azure portal or CLI and assign it a role. Meld u nu aan met de volgende opdracht: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. Controleer of uw omgeving juist is ingesteld en of uw omgeving de actieve Cloud is.Verify that your environment is set correctly and that your environment is the active cloud.

        az cloud list --output table

U ziet dat uw omgeving wordt weer gegeven en IsActive is true .You should see that your environment is listed and IsActive is true. Bijvoorbeeld: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

De connectiviteit testenTest the connectivity

Als alles is ingesteld, gebruikt u CLI om resources te maken in Azure Stack hub.With everything set up, use CLI to create resources within Azure Stack Hub. U kunt bijvoorbeeld een resource groep voor een app maken en een virtuele machine toevoegen.For example, you can create a resource group for an app and add a VM. Gebruik de volgende opdracht om een resource groep te maken met de naam ' MyResourceGroup ':Use the following command to create a resource group named "MyResourceGroup":

az group create -n MyResourceGroup -l local

Als de resource groep is gemaakt, voert de vorige opdracht de volgende eigenschappen van de zojuist gemaakte resource uit:If the resource group is created successfully, the previous command outputs the following properties of the newly created resource:

De resource groep Create output

Volgende stappenNext steps