Zainstaluj program PowerShell AZ module dla Azure Stack HubInstall PowerShell Az module for Azure Stack Hub

W tym artykule wyjaśniono, jak zainstalować Azure PowerShell AZ i Compatible Azure Stack module Administrator Hub za pomocą PowerShellGet.This article explains how to install the Azure PowerShell Az and compatible Azure Stack Hub administrator modules using PowerShellGet. AZ modules można zainstalować na platformach Windows, macOS i Linux.The Az modules can be installed on Windows, macOS, and Linux platforms.

Można również uruchomić AZ modules for Azure Stack Hub w kontenerze platformy Docker.You can also run the Az modules for Azure Stack Hub in a Docker container. Aby uzyskać instrukcje, zobacz Używanie platformy Docker do uruchamiania programu PowerShell dla Azure Stack Hub.For instructions, see Use Docker to run PowerShell for Azure Stack Hub.

Jeśli chcesz zainstalować moduł modułów zasobów programu PowerShell (AzureRM) dla centrum Azure Stack, zobacz Install PowerShell AzureRM module for Azure Stack Hub.If you would like to install PowerShell Resource Modules (AzureRM) module for Azure Stack Hub, see Install PowerShell AzureRM module for Azure Stack Hub.

Ważne

Prawdopodobnie nie będą dostępne nowe wersje modułów modułów zasobów platformy Azure.There will likely not be new Azure Resource Modules module releases. Moduły modułów zasobów platformy Azure obsługują tylko poprawki krytyczne.The Azure Resource Modules modules are under support for critical fixes only. Po przejściu do przodu będą dostępne tylko AZ releases dla centrum Azure Stack.Going forward there will only be Az releases for Azure Stack Hub.

Profile interfejsu API umożliwiają określanie zgodnych punktów końcowych dla dostawców zasobów centrum Azure Stack.You can use API profiles to specify the compatible endpoints for the Azure Stack Hub resource providers.

Profile interfejsu API umożliwiają zarządzanie różnicami wersji między platformą Azure i usługą Azure Stack Hub.API profiles provide a way to manage version differences between Azure and Azure Stack Hub. Profil wersji interfejsu API to zestaw Azure Resource Manager modułów programu PowerShell z określonymi wersjami interfejsu API.An API version profile is a set of Azure Resource Manager PowerShell modules with specific API versions. Każda platforma w chmurze ma zestaw obsługiwanych profili wersji interfejsu API.Each cloud platform has a set of supported API version profiles. Na przykład Azure Stack Hub obsługuje określoną wersję profilu, taką jak 2019-03-01-hybrydowe.For example, Azure Stack Hub supports a specific profile version such as 2019-03-01-hybrid. Podczas instalacji profilu są instalowane Azure Resource Manager moduły programu PowerShell odpowiadające określonemu profilowi.When you install a profile, the Azure Resource Manager PowerShell modules that correspond to the specified profile are installed.

Można zainstalować Azure Stack centrum zgodne z usługą PowerShell AZ modułów w przypadku scenariuszy połączonych z Internetem, częściowo połączonych lub rozłączonych.You can install Azure Stack Hub compatible PowerShell Az modules in Internet-connected, partially connected, or disconnected scenarios. W tym artykule omówiono szczegółowe instrukcje dotyczące tych scenariuszy.This article walks you through the detailed instructions for these scenarios.

1. Sprawdź wymagania wstępne1. Verify your prerequisites

Program AZ modules jest obsługiwany w centrum Azure Stack z aktualizacją 2002 lub nowszą i z zainstalowanymi bieżącymi poprawkami.Az modules are supported on Azure Stack Hub with Update 2002 or later and with the current hotfixes installed. Więcej informacji można znaleźć w informacjach o wersji centrum Azure Stack .Please see the Azure Stack Hub release notes for more information.

Azure PowerShell AZ modules współpracuje z programem PowerShell 5,1 lub nowszym w systemie Windows lub w programie PowerShell Core 6. x lub nowszym na wszystkich platformach.The Azure PowerShell Az modules work with PowerShell 5.1 or higher on Windows, or PowerShell Core 6.x and later on all platforms. Należy zainstalować najnowszą wersję programu PowerShell Core dostępną dla danego systemu operacyjnego.You should install the latest version of PowerShell Core available for your operating system. Azure PowerShell nie ma dodatkowych wymagań w przypadku uruchamiania w programie PowerShell Core.Azure PowerShell has no additional requirements when run on PowerShell Core.

Aby sprawdzić używaną wersję programu PowerShell, uruchom polecenie:To check your PowerShell version, run the command:

$PSVersionTable.PSVersion

Wymagania wstępne dotyczące systemu WindowsPrerequisites for Windows

Aby użyć programu Azure PowerShell w programie PowerShell 5.1 w systemie Windows:To use Azure PowerShell in PowerShell 5.1 on Windows:

  1. Jeśli to konieczne, przeprowadź aktualizację do programu Windows PowerShell 5.1.Update to Windows PowerShell 5.1 if needed. Jeśli używasz systemu Windows 10, masz już zainstalowany program PowerShell 5.1.If you're on Windows 10, you already have PowerShell 5.1 installed.
  2. Zainstaluj program .NET Framework 4.7.2 lub nowszy.Install .NET Framework 4.7.2 or later.
  3. Upewnij się, że masz najnowszą wersję modułu PowerShellGet.Make sure you have the latest version of PowerShellGet. Uruchom polecenie Install-Module PowerShellGet -MinimumVersion 2.2.3 -Force.Run Install-Module PowerShellGet -MinimumVersion 2.2.3 -Force.

2. wymagania wstępne dla systemów Linux i Mac2. Prerequisites for Linux and Mac

Wymagany jest program PowerShell Core w wersji 6. x lub nowszej.PowerShell Core 6.x or later version is needed. Aby uzyskać instrukcje, postępuj zgodnie z linkiemFollow the link for instructions

3. Odinstaluj istniejące wersje modułów Azure Stack centrum programu PowerShell3. Uninstall existing versions of the Azure Stack Hub PowerShell modules

Przed zainstalowaniem wymaganej wersji upewnij się, że odinstalowano wszystkie wcześniej zainstalowane Azure Stack centrum Azure Resource Manager lub AZ PowerShell modules.Before installing the required version, make sure that you uninstall any previously installed Azure Stack Hub Azure Resource Manager or Az PowerShell modules. Odinstaluj moduły przy użyciu jednej z następujących dwóch metod:Uninstall the modules by using one of the following two methods:

  1. Aby odinstalować istniejące Azure Resource Manager i AZ PowerShell modules, zamknij wszystkie aktywne sesje programu PowerShell i uruchom następujące polecenia cmdlet:To uninstall the existing Azure Resource Manager and Az PowerShell modules, close all the active PowerShell sessions, and run the following cmdlets:

    Get-Module -Name Azure* -ListAvailable | Uninstall-Module -Force -Verbose -ErrorAction Continue
    Get-Module -Name Azs.* -ListAvailable | Uninstall-Module -Force -Verbose -ErrorAction Continue
    Get-Module -Name Az.* -ListAvailable | Uninstall-Module -Force -Verbose -ErrorAction Continue
    

    Jeśli wystąpi błąd, taki jak "moduł jest już używany", Zamknij sesje programu PowerShell korzystające z modułów i ponownie uruchom Powyższy skrypt.If you hit an error such as 'The module is already in use', close the PowerShell sessions that are using the modules and rerun the above script.

  2. Usuń wszystkie foldery, które zaczynają Azure się Az od, lub Azs. z C:\Program Files\WindowsPowerShell\Modules C:\Users\{yourusername}\Documents\WindowsPowerShell\Modules folderów i.Delete all the folders that start with Azure, Az or Azs. from the C:\Program Files\WindowsPowerShell\Modules and C:\Users\{yourusername}\Documents\WindowsPowerShell\Modules folders. Usunięcie tych folderów spowoduje usunięcie wszystkich istniejących modułów programu PowerShell.Deleting these folders removes any existing PowerShell modules.

4. połączono: Instalowanie z łącznością z Internetem4. Connected: Install with internet connectivity

Azure Stack AZ module będzie działał Azure Stack Hub 2002 lub nowszej.The Azure Stack Az module will work Azure Stack Hub 2002 or later. Ponadto Azure Stack AZ module będzie działał z programem PowerShell 5,1 lub nowszym na komputerze z systemem Windows lub programem PowerShell 6. x lub nowszym na platformie Linux lub macOS.In addition, the Azure Stack Az module will work with PowerShell 5.1 or greater on a Windows machine, or PowerShell 6.x or greater on a Linux or macOS platform. Użycie poleceń cmdlet PowerShellGet jest preferowaną metodą instalacji.Using the PowerShellGet cmdlets is the preferred installation method. Ta metoda działa tak samo na obsługiwanych platformach.This method works the same on the supported platforms.

Uruchom następujące polecenie z sesji programu PowerShell:Run the following command from a PowerShell session:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Install-Module -Name Az.BootStrapper -Force -AllowPrerelease
Install-AzProfile -Profile 2019-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 2.0.2-preview -AllowPrerelease

Uwaga

2.0.0 w wersji modułu centrum Azure Stack jest istotną zmianą.Azure Stack Hub module version 2.0.0 is a breaking change. Aby uzyskać szczegółowe informacje, zapoznaj się z tematem Migrowanie z AzureRM do Azure PowerShell AZ in Azure Stack Hub .Refer to the Migrate from AzureRM to Azure PowerShell Az in Azure Stack Hub for details.

Ostrzeżenie

W tym samym czasie nie można mieć zarówno Azure Resource Manager (AzureRM), jak i AZ modułów zainstalowanych dla programu PowerShell 5,1 dla systemu Windows.You can't have both the Azure Resource Manager (AzureRM) and Az modules installed for PowerShell 5.1 for Windows at the same time. Jeśli musisz utrzymywać Azure Resource Manager dostępne w systemie, Zainstaluj polecenie AZ module dla programu PowerShell Core 6. x lub nowszego.If you need to keep Azure Resource Manager available on your system, install the Az module for PowerShell Core 6.x or later. Aby to zrobić, zainstaluj program PowerShell Core w wersji 6.x lub nowszej, a następnie wykonaj następujące instrukcje w terminalu programu PowerShell Core.To do this, install PowerShell Core 6.x or later and then follow these instructions in a PowerShell Core terminal.

5. Rozłączono: Zainstaluj bez połączenia internetowego5. Disconnected: Install without internet connection

W scenariuszu rozłączonym należy najpierw pobrać moduły programu PowerShell na maszynę z połączeniem internetowym.In a disconnected scenario, you first download the PowerShell modules to a machine that has internet connectivity. Następnie należy przenieść je do Azure Stack Development Kit (ASDK) w celu instalacji.Then, you transfer them to the Azure Stack Development Kit (ASDK) for installation.

Zaloguj się na komputerze z łącznością internetową i użyj następujących skryptów do pobrania pakietów Azure Resource Manager i Azure Stack Hub, w zależności od używanej wersji centrum Azure Stack.Sign in to a computer with internet connectivity and use the following scripts to download the Azure Resource Manager and Azure Stack Hub packages, depending on your version of Azure Stack Hub.

Instalacja ma pięć kroków:Installation has five steps:

  1. Zainstaluj Azure Stack centrum programu PowerShell na połączonej maszynie.Install Azure Stack Hub PowerShell to a connected machine.
  2. Włącz dodatkowe funkcje magazynu.Enable additional storage features.
  3. Transport pakietów programu PowerShell do rozłączonej stacji roboczej.Transport the PowerShell packages to your disconnected workstation.
  4. Ręcznie załadowania dostawcy NuGet na odłączonej stacji roboczej.Manually bootstrap the NuGet provider on your disconnected workstation.
  5. Potwierdź instalację programu PowerShell.Confirm the installation of PowerShell.

Instalowanie programu PowerShell Azure Stack HubInstall Azure Stack Hub PowerShell

Azure Stack Hub 2002 lub nowszej.Azure Stack Hub 2002 or later.

Można użyć Azure Resource Manager lub AZ modules.You could either use Azure Resource Manager or Az modules. Aby uzyskać Azure Resource Manager, zapoznaj się z instrukcjami w artykule Instalowanie modułu PowerShell AzureRM.For Azure Resource Manager, see the instructions at Install PowerShell AzureRM module. Poniższy kod zapisuje moduły z wiarygodnego repozytorium online https://www.powershellgallery.com/ .The following code saves modules from trustworthy online repository https://www.powershellgallery.com/.

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Install-module -Name PowerShellGet -MinimumVersion 2.2.3 -Force
Import-Module -Name PackageManagement -ErrorAction Stop

$savedModulesPath = "<Path that is used to save the packages>"
Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name Az -Path $savedModulesPath -Force -RequiredVersion 0.10.0-preview
Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureStack -Path $savedModulesPath -Force -RequiredVersion 2.0.2-preview

Uwaga

Na komputerach bez połączenia internetowego zalecamy wykonanie następującego polecenia cmdlet w celu wyłączenia zbierania danych telemetrii.On machines without an internet connection, we recommend executing the following cmdlet for disabling the telemetry data collection. Może wystąpić spadek wydajności dla poleceń cmdlet bez wyłączania zbierania danych telemetrii.You may experience a performance degradation of the cmdlets without disabling the telemetry data collection. Ma to zastosowanie tylko w przypadku maszyn bez połączeń internetowychThis is applicable only for the machines without internet connections

Disable-AzDataCollection

Dodawanie pakietów do stacji roboczejAdd your packages to your workstation

  1. Skopiuj pobrane pakiety na urządzenie USB.Copy the downloaded packages to a USB device.

  2. Zaloguj się na odłączonej stacji roboczej i skopiuj pakiety z urządzenia USB do lokalizacji na stacji roboczej.Sign in to the disconnected workstation and copy the packages from the USB device to a location on the workstation.

  3. Ręcznie załadowania dostawcy NuGet na odłączonej stacji roboczej.Manually bootstrap the NuGet provider on your disconnected workstation. Aby uzyskać instrukcje, zobacz Ręczne inicjowanie dostawcy NuGet na komputerze, który nie jest połączony z Internetem.For instructions, see Manually bootstrapping the NuGet provider on a machine that isn't connected to the internet.

  4. Zarejestruj tę lokalizację jako repozytorium domyślne i zainstaluj AzureRM AzureStack Moduły i z tego repozytorium:Register this location as the default repository and install the AzureRM and AzureStack modules from this repository:

    # requires -Version 5
    # requires -RunAsAdministrator
    # requires -Module PowerShellGet
    # requires -Module PackageManagement
    
    $SourceLocation = "<Location on the development kit that contains the PowerShell packages>"
    $RepoName = "MyNuGetSource"
    
    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
    
    Register-PSRepository -Name $RepoName -SourceLocation $SourceLocation -InstallationPolicy Trusted
    
    Install-Module -Name AzureStack -Repository $RepoName -RequiredVersion 2.0.2-preview -AllowPrerelease -Scope AllUsers
    
    Install-Module -Name Az -Repository $RepoName -RequiredVersion 0.10.0-preview -AllowPrerelease -Scope AllUsers
    

Potwierdzanie instalacji programu PowerShellConfirm the installation of PowerShell

Potwierdź instalację, uruchamiając następujące polecenie:Confirm the installation by running the following command:

Get-Module -Name "Az*" -ListAvailable
Get-Module -Name "Azs*" -ListAvailable

6. Skonfiguruj program PowerShell do korzystania z serwera proxy6. Configure PowerShell to use a proxy server

W scenariuszach, które wymagają serwera proxy w celu uzyskania dostępu do Internetu, należy najpierw skonfigurować program PowerShell do korzystania z istniejącego serwera proxy:In scenarios that require a proxy server to access the internet, you first configure PowerShell to use an existing proxy server:

  1. Otwórz wiersz polecenia programu PowerShell z podwyższonym poziomem uprawnień.Open an elevated PowerShell prompt.

  2. Uruchom następujące polecenia:Run the following commands:

    #To use Windows credentials for proxy authentication
    [System.Net.WebRequest]::DefaultWebProxy.Credentials = [System.Net.CredentialCache]::DefaultCredentials
    
    #Alternatively, to prompt for separate credentials that can be used for #proxy authentication
    [System.Net.WebRequest]::DefaultWebProxy.Credentials = Get-Credential
    

7. Użyj AZ module7. Use the Az module

Możesz użyć poleceń cmdlet i przykładów kodu na podstawie Azure Resource Manager.You can use the cmdlets and code samples based on Azure Resource Manager. Należy jednak zmienić nazwę modułów i poleceń cmdlet.However, you will want to change the name of the modules and cmdlets. Nazwy modułów zostały zmienione w taki sposób, aby AzureRM platforma Azure stała się i taka Az sama dla poleceń cmdlet.The module names have been changed so that AzureRM and Azure become Az, and the same for cmdlets. Na przykład AzureRM.Compute Nazwa modułu została zmieniona na Az.Compute . New-AzureRMVMFor example, the AzureRM.Compute module has been renamed to Az.Compute. New-AzureRMVM stało się poleceniem New-AzVM, a polecenie Get-AzureStorageBlob to teraz polecenie Get-AzStorageBlob.has become New-AzVM, and Get-AzureStorageBlob is now Get-AzStorageBlob.

Aby uzyskać bardziej szczegółowe omówienie i wskazówki dotyczące przesuwania skryptu AzurRM do AZ i łamania zmian w elemencie AZ module centrum Azure Stack, zobacz Migrowanie z AzureRM do Azure PowerShell AZ.For a more thorough discussion and guidance for moving AzurRM script to Az and breaking changes in Azure Stack Hub's Az module, see Migrate from AzureRM to Azure PowerShell Az.

Znane problemyKnown issues

Wystąpił błąd podczas instalowania modułu AZ modulesError thrown when installing the Az modules

  • Dotyczy: ten problem dotyczy 2002 i nowszychApplicable: This issue applies to 2002 and later
  • Przyczyna: podczas instalowania modułu zostanie zgłoszony błąd.Cause: When installing the module, an error is thrown. Zostanie wyświetlony komunikat o błędzie: Register-PacakgeSource : A parameter cannot be found that matches parameter name. 'PackageManagementProvider'. lub komunikat o błędzie może zawierać następujący tekst: PackageManagement\Install-Package : Cannot convert value "2.0.1-preview" to type "System.Version". Error: "Input string was not in a correct format."The error message begins: Register-PacakgeSource : A parameter cannot be found that matches parameter name. 'PackageManagementProvider'. Or the error message may include the following text: PackageManagement\Install-Package : Cannot convert value "2.0.1-preview" to type "System.Version". Error: "Input string was not in a correct format."
  • Korygowanie: Uruchom następujące polecenie cmdlet w tej samej sesji:Remediation: Run the following cmdlet in the same session:
    Install-Module PowershellGet -MinimumumVersion 2.3.0 -Force
    Zamknij sesję i uruchom nową sesję programu PowerShell z podwyższonym poziomem uprawnień.Close your session and start a new elevated PowerShell session.
  • Wystąpienie: wspólneOccurrence: Common

Podczas instalowania AZ module nie zgłasza błędów wymaganych praw administratoraWhen installing Az module falsely throws Admin rights required error

  • Dotyczy: ten problem dotyczy 2002 i nowszychApplicable: This issue applies to 2002 and later
  • Przyczyna: podczas instalowania modułu z poziomu monitu o podniesionych uprawnieniach zostanie zgłoszony błąd.Cause: When installing the module from an elevated prompt, an error is thrown. Wystąpił błąd Administrator rights required .The error says, Administrator rights required.
  • Korygowanie: Zamknij sesję i Rozpocznij nową sesję programu PowerShell z podwyższonym poziomem uprawnień.Remediation: Close your session and start a new elevated PowerShell session. Upewnij się, że nie ma istniejącego elementu AZ.Make sure there isn't an existing Az. Moduł kont załadowany w sesji.Accounts module loaded in the session.
  • Wystąpienie: wspólneOccurrence: Common

Następne krokiNext steps