Instalowanie interfejsu wiersza polecenia platformy Azure na Azure Stack HubInstall Azure CLI on Azure Stack Hub

Możesz zainstalować interfejs wiersza polecenia platformy Azure, aby zarządzać Azure Stack Hub z maszynami z systemem Windows lub Linux.You can install the Azure CLI to manage Azure Stack Hub with a Windows or Linux machines. W tym artykule przedstawiono kroki instalacji i konfigurowania interfejsu wiersza polecenia platformy Azure.This article walks you through the steps of installing and setting up Azure CLI.

Zainstaluj interfejs wiersza polecenia platformy AzureInstall Azure CLI

  1. Zaloguj się do stacji roboczej deweloperskiej i zainstaluj interfejs wiersza polecenia.Sign in to your development workstation and install CLI. Azure Stack Hub wymaga wersji 2,0 lub nowszej interfejsu wiersza polecenia platformy Azure.Azure Stack Hub requires version 2.0 or later of Azure CLI.

  2. Interfejs wiersza polecenia można zainstalować, wykonując kroki opisane w artykule Instalowanie interfejsu wiersza polecenia platformy Azure .You can install the CLI by using the steps described in the Install the Azure CLI article.

  3. Aby sprawdzić, czy instalacja zakończyła się pomyślnie, Otwórz terminal lub okno wiersza polecenia i uruchom następujące polecenie:To verify whether the installation was successful, open a terminal or command prompt window and run the following command:

    az --version
    

    Powinna zostać wyświetlona wersja interfejsu wiersza polecenia platformy Azure i innych zależnych bibliotek, które są zainstalowane na komputerze.You should see the version of Azure CLI and other dependent libraries that are installed on your computer.

    Interfejs wiersza polecenia platformy Azure w lokalizacji Azure Stack centrum Python

  4. Zanotuj lokalizację języka Python interfejsu wiersza polecenia.Make a note of the CLI's Python location. Jeśli używasz ASDK, musisz użyć tej lokalizacji, aby dodać certyfikat.If you're running the ASDK, you need to use this location to add your certificate. Aby uzyskać instrukcje dotyczące konfigurowania certyfikatów na potrzeby instalowania interfejsu wiersza polecenia na ASDK, zobacz Konfigurowanie certyfikatów dla interfejsu wiersza polecenia platformy Azure na 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.

Nawiązywanie połączenia z interfejsem wiersza polecenia platformy AzureConnect with Azure CLI

Ta sekcja przeprowadzi Cię przez proces konfigurowania interfejsu wiersza polecenia, jeśli korzystasz z usług Azure AD jako usługi zarządzania tożsamościami i korzystasz z interfejsu wiersza polecenia na komputerze z systemem 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.

Nawiązywanie połączenia z centrum Azure StackConnect to Azure Stack Hub

  1. Jeśli używasz ASDK, zaufaj certyfikatowi głównemu urzędu certyfikacji centrum Azure Stack.If you are using the ASDK, trust the Azure Stack Hub CA root certificate. Aby uzyskać instrukcje, zobacz temat ufanie certyfikatowi.For instruction, see Trust the certificate.

  2. Zarejestruj środowisko centrum Azure Stack, uruchamiając az cloud register polecenie.Register your Azure Stack Hub environment by running the az cloud register command.

  3. Zarejestruj swoje środowisko.Register your environment. Użyj następujących parametrów podczas uruchamiania az cloud register :Use the following parameters when running az cloud register:

    WartośćValue PrzykładExample OpisDescription
    Nazwa środowiskaEnvironment name AzureStackUserAzureStackUser Używany AzureStackUser dla środowiska użytkownika.Use AzureStackUser for the user environment. Jeśli jesteś operatorem, określ AzureStackAdmin .If you're operator, specify AzureStackAdmin.
    Menedżer zasobów punkt końcowyResource Manager endpoint https://management.contoso.onmicrosoft.com ResourceManagerUrl w ASDK to: https://management.contoso.onmicrosoft.com/ ResourceManagerUrl w systemach zintegrowanych to: https://management.<region>.<fqdn>/ Jeśli masz pytanie dotyczące zintegrowanego punktu końcowego systemu, skontaktuj się z operatorem chmury.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.
    Punkt końcowy magazynuStorage endpoint local.contoso.onmicrosoft.comlocal.contoso.onmicrosoft.com local.azurestack.external jest dla ASDK.local.azurestack.external is for the ASDK. W przypadku systemu zintegrowanego Użyj punktu końcowego dla systemu.For an integrated system, use an endpoint for your system.
    Sufiks magazynu kluczyKeyvault suffix . vault.contoso.onmicrosoft.com.vault.contoso.onmicrosoft.com .vault.local.azurestack.external jest dla ASDK..vault.local.azurestack.external is for the ASDK. W przypadku systemu zintegrowanego Użyj punktu końcowego dla systemu.For an integrated system, use an endpoint for your system.
    Identyfikator zasobu programu Graph w usłudze Active Directory punktu końcowegoEndpoint active directory graph resource ID https://graph.windows.net/ Identyfikator zasobu usługi 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/"
    

    Odwołanie do polecenia Register można znaleźć w dokumentacji dotyczącej interfejsu wiersza poleceń platformy Azure.You can find a reference for the register command in the Azure CLI reference documentation.

  4. Ustaw aktywne środowisko przy użyciu następujących poleceń.Set the active environment by using the following commands.

    az cloud set -n <environmentname>
    
  5. Zaktualizuj konfigurację środowiska, aby użyć profilu wersji interfejsu API określonego przez centrum Azure Stack.Update your environment configuration to use the Azure Stack Hub specific API version profile. Aby zaktualizować konfigurację, uruchom następujące polecenie:To update the configuration, run the following command:

    az cloud update --profile 2019-03-01-hybrid
    
  6. Zaloguj się do środowiska Azure Stack Hub przy użyciu az login polecenia.Sign in to your Azure Stack Hub environment by using the az login command.

    Możesz zalogować się do środowiska centrum Azure Stack przy użyciu poświadczeń użytkownika lub nazwy głównej usługi (SPN) udostępnionej przez operatora chmury.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.

    • Zaloguj się jako użytkownik:Sign in as a user:

      Możesz określić nazwę użytkownika i hasło bezpośrednio w az login poleceniu lub uwierzytelnić się za pomocą przeglądarki.You can either specify the username and password directly within the az login command, or authenticate by using a browser. Należy wykonać te czynności, jeśli konto ma włączone uwierzytelnianie wieloskładnikowe: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
      

      Uwaga

      Jeśli konto użytkownika ma włączone uwierzytelnianie wieloskładnikowe, użyj az login polecenia bez podawania -u parametru.If your user account has multi-factor authentication enabled, use the az login command without providing the -u parameter. Uruchomienie tego polecenia daje adres URL i kod, którego należy użyć do uwierzytelnienia.Running this command gives you a URL and a code that you must use to authenticate.

    • Zaloguj się jako nazwa główna usługi:Sign in as a service principal:

      Przed zalogowaniem się Utwórz jednostkę usługi za pomocą Azure Portal lub interfejsu wiersza polecenia i przypisz ją do roli.Before you sign in, create a service principal through the Azure portal or CLI and assign it a role. Teraz Zaloguj się przy użyciu następującego polecenia: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. Sprawdź, czy środowisko jest prawidłowo ustawione i czy środowisko jest chmurą aktywną.Verify that your environment is set correctly and that your environment is the active cloud.

        az cloud list --output table
    

Powinieneś zobaczyć, że Twoje środowisko jest wymienione i IsActive działa true .You should see that your environment is listed and IsActive is true. Na przykład: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

Testowanie połączeniaTest the connectivity

Ze wszystkimi konfiguracjami Użyj interfejsu wiersza polecenia do tworzenia zasobów w ramach Centrum Azure Stack.With everything set up, use CLI to create resources within Azure Stack Hub. Można na przykład utworzyć grupę zasobów dla aplikacji i dodać maszynę wirtualną.For example, you can create a resource group for an app and add a VM. Użyj następującego polecenia, aby utworzyć grupę zasobów o nazwie "Grupa zasobów":Use the following command to create a resource group named "MyResourceGroup":

az group create -n MyResourceGroup -l local

Jeśli grupa zasobów została utworzona pomyślnie, poprzednie polecenie wyświetla następujące właściwości nowo utworzonego zasobu:If the resource group is created successfully, the previous command outputs the following properties of the newly created resource:

Tworzenie danych wyjściowych w grupie zasobów

Następne krokiNext steps