Instalace prostředí PowerShell AZ Module pro Azure Stack hubInstall PowerShell Az module for Azure Stack Hub

Tento článek vysvětluje, jak nainstalovat Azure PowerShell AZ a Compatible Azure Stack správce centra pomocí PowerShellGet.This article explains how to install the Azure PowerShell Az and compatible Azure Stack Hub administrator modules using PowerShellGet. Moduly AZ lze nainstalovat na platformy Windows, macOS a Linux.The Az modules can be installed on Windows, macOS, and Linux platforms.

Můžete také spustit příkaz AZ modules for Azure Stack hub v kontejneru Docker.You can also run the Az modules for Azure Stack Hub in a Docker container. Pokyny najdete v tématu použití Docker ke spuštění PowerShellu pro Azure Stack hub.For instructions, see Use Docker to run PowerShell for Azure Stack Hub.

Pokud chcete nainstalovat modul AzureRM (PowerShell Resource modules) pro centrum Azure Stack, přečtěte si téma Instalace modulu PowerShell AzureRM pro centrum Azure Stack.If you would like to install PowerShell Resource Modules (AzureRM) module for Azure Stack Hub, see Install PowerShell AzureRM module for Azure Stack Hub.

Důležité

Pravděpodobně nebudete mít k dispozici nové verze modulů prostředků Azure.There will likely not be new Azure Resource Modules module releases. Moduly modulů prostředků Azure jsou v rámci podpory jenom pro kritické opravy.The Azure Resource Modules modules are under support for critical fixes only. Až se vám pošle dál, bude se používat jenom AZ releases for Azure Stack hub.Going forward there will only be Az releases for Azure Stack Hub.

Profily rozhraní API můžete použít k určení kompatibilních koncových bodů pro poskytovatele prostředků služby Azure Stack hub.You can use API profiles to specify the compatible endpoints for the Azure Stack Hub resource providers.

Profily rozhraní API poskytují způsob, jak spravovat rozdíly mezi verzemi Azure a centra Azure Stack.API profiles provide a way to manage version differences between Azure and Azure Stack Hub. Profil verze rozhraní API je sada Azure Resource Managerch modulů PowerShellu s konkrétními verzemi rozhraní API.An API version profile is a set of Azure Resource Manager PowerShell modules with specific API versions. Každá cloudová platforma má sadu podporovaných profilů verze rozhraní API.Each cloud platform has a set of supported API version profiles. Například centrum Azure Stack podporuje konkrétní verzi profilu, například 2019-03-01-Hybrid.For example, Azure Stack Hub supports a specific profile version such as 2019-03-01-hybrid. Když nainstalujete profil, nainstalují se moduly Azure Resource Manager PowerShellu, které odpovídají zadanému profilu.When you install a profile, the Azure Resource Manager PowerShell modules that correspond to the specified profile are installed.

Prostředí PowerShellu kompatibilní s centrem Azure Stack AZ moduls můžete nainstalovat ve scénářích připojených k Internetu, částečně propojených nebo odpojených.You can install Azure Stack Hub compatible PowerShell Az modules in Internet-connected, partially connected, or disconnected scenarios. Tento článek vás provede podrobnými pokyny pro tyto scénáře.This article walks you through the detailed instructions for these scenarios.

1. ověřte požadavky.1. Verify your prerequisites

AZ modules se podporuje v Azure Stackovém centru s aktualizací Update 2002 nebo novějším a s nainstalovanými aktuálními opravami hotfix.Az modules are supported on Azure Stack Hub with Update 2002 or later and with the current hotfixes installed. Další informace najdete v poznámkách k verzi centra Azure Stack .Please see the Azure Stack Hub release notes for more information.

Azure PowerShell AZ modules Work s prostředím PowerShell 5,1 nebo vyšším ve Windows nebo PowerShell Core 6. x a novějším na všech platformách.The Azure PowerShell Az modules work with PowerShell 5.1 or higher on Windows, or PowerShell Core 6.x and later on all platforms. Měli byste nainstalovat nejnovější verzi prostředí PowerShell Core , která je k dispozici pro váš operační systém.You should install the latest version of PowerShell Core available for your operating system. Azure PowerShell nemá žádné další požadavky při spuštění v prostředí PowerShell Core.Azure PowerShell has no additional requirements when run on PowerShell Core.

Pokud chcete zkontrolovat verzi PowerShellu, spusťte následující příkaz:To check your PowerShell version, run the command:

$PSVersionTable.PSVersion

Předpoklady pro WindowsPrerequisites for Windows

Použití Azure PowerShellu v PowerShellu 5.1 ve Windows:To use Azure PowerShell in PowerShell 5.1 on Windows:

  1. V případě potřeby proveďte aktualizaci na Windows PowerShell 5.1.Update to Windows PowerShell 5.1 if needed. Pokud používáte Windows 10, máte už PowerShell 5.1 nainstalovaný.If you're on Windows 10, you already have PowerShell 5.1 installed.
  2. Nainstalujte si rozhraní .NET Framework 4.7.2 nebo novější.Install .NET Framework 4.7.2 or later.
  3. Ujistěte se, že máte nejnovější verzi modulu PowerShellGet.Make sure you have the latest version of PowerShellGet. Spusťte Install-Module PowerShellGet -MinimumVersion 2.2.3 -Force.Run Install-Module PowerShellGet -MinimumVersion 2.2.3 -Force.

2. předpoklady pro Linux a Mac2. Prerequisites for Linux and Mac

Je potřeba PowerShell Core 6. x nebo novější verze.PowerShell Core 6.x or later version is needed. Pokyny najdete na tomto odkazu .Follow the link for instructions

3. odinstalujte existující verze modulů prostředí PowerShell centra Azure Stack.3. Uninstall existing versions of the Azure Stack Hub PowerShell modules

Před instalací požadované verze se ujistěte, že jste odinstalovali všechny dříve nainstalované Azure Stack centra Azure Resource Manager nebo AZ PowerShell Module.Before installing the required version, make sure that you uninstall any previously installed Azure Stack Hub Azure Resource Manager or Az PowerShell modules. Moduly odinstalujte pomocí jedné z následujících dvou metod:Uninstall the modules by using one of the following two methods:

  1. Pokud chcete odinstalovat existující Azure Resource Manager a AZ PowerShell modules, zavřete všechny aktivní relace PowerShellu a spusťte následující rutiny: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
    

    Pokud se zobrazí chyba, například modul se už používá, zavřete relace PowerShellu, které moduly používají, a znovu spusťte výše uvedený skript.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. Odstraňte všechny složky, které začínají Azure na, Az nebo Azs. ze C:\Program Files\WindowsPowerShell\Modules složky a C:\Users\{yourusername}\Documents\WindowsPowerShell\Modules .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. Odstranění těchto složek odebere všechny existující moduly prostředí PowerShell.Deleting these folders removes any existing PowerShell modules.

4. připojeno: instalace s připojením k Internetu4. Connected: Install with internet connectivity

Azure Stack AZ Module bude pracovat Azure Stack hub 2002 nebo novější.The Azure Stack Az module will work Azure Stack Hub 2002 or later. Kromě toho Azure Stack AZ Module bude pracovat s prostředím PowerShell 5,1 nebo vyšším na počítači s Windows, nebo PowerShell 6. x nebo vyšší na platformě Linux nebo 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. Upřednostňovanou metodou instalace je použití rutin PowerShellGet.Using the PowerShellGet cmdlets is the preferred installation method. Tato metoda funguje stejně jako na podporovaných platformách.This method works the same on the supported platforms.

Z relace PowerShellu spusťte následující příkaz: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

Poznámka

2.0.0 pro modul centra Azure Stack je zásadní změna.Azure Stack Hub module version 2.0.0 is a breaking change. Podrobnosti najdete v tématu Migrace z AzureRM na adresu Azure PowerShell AZ in Azure Stack hub .Refer to the Migrate from AzureRM to Azure PowerShell Az in Azure Stack Hub for details.

Upozornění

V prostředí PowerShell 5,1 pro Windows nemůžete současně nainstalovat současně Azure Resource Manager (AzureRM) a AZ Module.You can't have both the Azure Resource Manager (AzureRM) and Az modules installed for PowerShell 5.1 for Windows at the same time. Pokud potřebujete zachovat Azure Resource Manager k dispozici v systému, nainstalujte modul AZ Module pro PowerShell Core 6. x nebo novější.If you need to keep Azure Resource Manager available on your system, install the Az module for PowerShell Core 6.x or later. Pokud to chcete provést, nainstalujte PowerShell Core 6. x nebo novější a pak postupujte podle těchto pokynů v terminálu PowerShell Core.To do this, install PowerShell Core 6.x or later and then follow these instructions in a PowerShell Core terminal.

5. odpojeno: instalace bez připojení k Internetu5. Disconnected: Install without internet connection

V odpojeném scénáři nejprve stáhnete moduly PowerShellu do počítače, který má připojení k Internetu.In a disconnected scenario, you first download the PowerShell modules to a machine that has internet connectivity. Pak je přenesete do Azure Stack Development Kit (ASDK) pro instalaci.Then, you transfer them to the Azure Stack Development Kit (ASDK) for installation.

Přihlaste se k počítači s připojením k Internetu a pomocí následujících skriptů Stáhněte balíčky Azure Resource Manager a Azure Stack centra v závislosti na vaší verzi centra 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.

Instalace má pět kroků:Installation has five steps:

  1. Instalace prostředí PowerShell centra Azure Stack do připojeného počítače.Install Azure Stack Hub PowerShell to a connected machine.
  2. Povolí další funkce úložiště.Enable additional storage features.
  3. Přenos balíčků PowerShellu na odpojenou pracovní stanici.Transport the PowerShell packages to your disconnected workstation.
  4. Ručně nabootstrap zprostředkovatele NuGet na odpojené pracovní stanici.Manually bootstrap the NuGet provider on your disconnected workstation.
  5. Potvrďte instalaci PowerShellu.Confirm the installation of PowerShell.

Nainstalovat Azure Stack centra PowerShellInstall Azure Stack Hub PowerShell

Azure Stack hub 2002 nebo novější.Azure Stack Hub 2002 or later.

Můžete buď použít Azure Resource Manager, nebo AZ Modules.You could either use Azure Resource Manager or Az modules. Azure Resource Manager najdete v pokynech v tématu install PowerShell AzureRM Module.For Azure Resource Manager, see the instructions at Install PowerShell AzureRM module. Následující kód ukládá moduly z důvěryhodného online úložiště 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

Poznámka

V počítačích bez připojení k Internetu doporučujeme pro zakázání shromažďování dat telemetrie spustit následující rutinu.On machines without an internet connection, we recommend executing the following cmdlet for disabling the telemetry data collection. Může dojít ke snížení výkonu rutin bez zakázání shromažďování dat telemetrie.You may experience a performance degradation of the cmdlets without disabling the telemetry data collection. To platí jenom pro počítače bez připojení k Internetu.This is applicable only for the machines without internet connections

Disable-AzDataCollection

Přidání balíčků do pracovní staniceAdd your packages to your workstation

  1. Stažené balíčky zkopírujte do zařízení USB.Copy the downloaded packages to a USB device.

  2. Přihlaste se k odpojené pracovní stanici a zkopírujte balíčky ze zařízení USB do umístění v pracovní stanici.Sign in to the disconnected workstation and copy the packages from the USB device to a location on the workstation.

  3. Ručně nabootstrap zprostředkovatele NuGet na odpojené pracovní stanici.Manually bootstrap the NuGet provider on your disconnected workstation. Pokyny najdete v tématu Ruční zavedení zprostředkovatele NuGet na počítači, který není připojený k Internetu.For instructions, see Manually bootstrapping the NuGet provider on a machine that isn't connected to the internet.

  4. Zaregistrujte toto umístění jako výchozí úložiště a nainstalujte AzureRM AzureStack moduly a z tohoto úložiště: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
    

Potvrzení instalace PowerShelluConfirm the installation of PowerShell

Potvrďte instalaci spuštěním následujícího příkazu:Confirm the installation by running the following command:

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

6. konfigurace PowerShellu pro použití proxy server6. Configure PowerShell to use a proxy server

Ve scénářích, které vyžadují proxy server pro přístup k Internetu, musíte nejprve nakonfigurovat prostředí PowerShell tak, aby používalo existující proxy server:In scenarios that require a proxy server to access the internet, you first configure PowerShell to use an existing proxy server:

  1. Otevřete příkazový řádek PowerShell se zvýšenými oprávněními.Open an elevated PowerShell prompt.

  2. Spusťte následující příkazy: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. použijte modul AZ Module7. Use the Az module

Můžete použít rutiny a ukázky kódu založené na Azure Resource Manager.You can use the cmdlets and code samples based on Azure Resource Manager. Nicméně budete chtít změnit název modulů a rutin.However, you will want to change the name of the modules and cmdlets. Názvy modulů se změnily tak, že AzureRM a Azure se stanou a Az jsou stejné pro rutiny.The module names have been changed so that AzureRM and Azure become Az, and the same for cmdlets. Například AzureRM.Compute modul byl přejmenován na Az.Compute . New-AzureRMVMFor example, the AzureRM.Compute module has been renamed to Az.Compute. New-AzureRMVM se změnilo na New-AzVM a Get-AzureStorageBlob je teď Get-AzStorageBlob.has become New-AzVM, and Get-AzureStorageBlob is now Get-AzStorageBlob.

Důkladnější diskuzi a pokyny pro přesunutí skriptu AzurRM k AZ a průlom Changes in the Azure Stack hub 's hub najdete v tématu migrace z AzureRM na 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.

Známé problémyKnown issues

Při instalaci AZ modules došlo k chybě.Error thrown when installing the Az modules

  • Platí: Tento problém se týká 2002 a novějších verzí.Applicable: This issue applies to 2002 and later
  • Příčina: při instalaci modulu je vyvolána chyba.Cause: When installing the module, an error is thrown. Spustí se chybová zpráva: Register-PacakgeSource : A parameter cannot be found that matches parameter name. 'PackageManagementProvider'. nebo chybová zpráva může obsahovat následující text: 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."
  • Náprava: ve stejné relaci spusťte následující rutinu:Remediation: Run the following cmdlet in the same session:
    Install-Module PowershellGet -MinimumumVersion 2.3.0 -Force
    Zavřete svou relaci a spusťte novou relaci PowerShellu se zvýšenými oprávněními.Close your session and start a new elevated PowerShell session.
  • Výskyt: běžnéOccurrence: Common

Při instalaci AZ Module false vyvolá chyba požadovaná oprávnění správce.When installing Az module falsely throws Admin rights required error

  • Platí: Tento problém se týká 2002 a novějších verzí.Applicable: This issue applies to 2002 and later
  • Příčina: při instalaci modulu z příkazového řádku se zvýšenými oprávněními se vyvolá chyba.Cause: When installing the module from an elevated prompt, an error is thrown. Chyba říká, Administrator rights required .The error says, Administrator rights required.
  • Náprava: zavřete relaci a spusťte novou relaci PowerShellu se zvýšenými oprávněními.Remediation: Close your session and start a new elevated PowerShell session. Ujistěte se, že neexistuje existující AZ.Make sure there isn't an existing Az. Modul Accounts byl načten v relaci.Accounts module loaded in the session.
  • Výskyt: běžnéOccurrence: Common

Další krokyNext steps