A PowerShell telepítése az Azure Stack hub modulhozInstall PowerShell Az module for Azure Stack Hub

Ez a cikk azt ismerteti, hogyan telepítheti az Azure PowerShell az és a kompatibilis Azure Stack hub rendszergazdai moduljait a PowerShellGet használatával.This article explains how to install the Azure PowerShell Az and compatible Azure Stack Hub administrator modules using PowerShellGet. Az az modulokat Windows, macOS és Linux platformokra lehet telepíteni.The Az modules can be installed on Windows, macOS, and Linux platforms.

A Docker-tárolóban futtathatja az az Azure Stack hub-hoz készült modulokat is.You can also run the Az modules for Azure Stack Hub in a Docker container. Útmutatásért lásd: a Docker használata a PowerShell Azure stack hubhoz való futtatásához.For instructions, see Use Docker to run PowerShell for Azure Stack Hub.

Ha Azure Stack hub PowerShell Resource modules (AzureRM) modulját szeretné telepíteni, tekintse meg a PowerShell-AzureRM modul telepítése Azure stack hub-hoz című témakört.If you would like to install PowerShell Resource Modules (AzureRM) module for Azure Stack Hub, see Install PowerShell AzureRM module for Azure Stack Hub.

Fontos

Valószínűleg nem lesznek új Azure Resource Module-modulok.There will likely not be new Azure Resource Modules module releases. Az Azure Resource Module modulok csak a kritikus javítások támogatását támogatják.The Azure Resource Modules modules are under support for critical fixes only. A továbbiakban csak az az releases for Azure Stack hub lesz.Going forward there will only be Az releases for Azure Stack Hub.

Az API- profilok segítségével megadhatja az Azure stack hub erőforrás-szolgáltatóhoz tartozó kompatibilis végpontokat.You can use API profiles to specify the compatible endpoints for the Azure Stack Hub resource providers.

Az API-profilok lehetőséget biztosítanak az Azure és a Azure Stack hub közötti verziók közötti különbségek kezelésére.API profiles provide a way to manage version differences between Azure and Azure Stack Hub. Az API-verzió profilja Azure Resource Manager PowerShell-modulok meghatározott API-verziókkal.An API version profile is a set of Azure Resource Manager PowerShell modules with specific API versions. Minden egyes felhőalapú platformon támogatott API-verzió-profilok szerepelnek.Each cloud platform has a set of supported API version profiles. Az Azure Stack hub például egy adott profil verzióját támogatja, például 2019-03-01-Hybrid.For example, Azure Stack Hub supports a specific profile version such as 2019-03-01-hybrid. Profil telepítésekor a rendszer telepíti a megadott profilhoz tartozó Azure Resource Manager PowerShell-modulokat.When you install a profile, the Azure Resource Manager PowerShell modules that correspond to the specified profile are installed.

Az Azure Stack hub-kompatibilis PowerShell az a modulok az internethez csatlakoztatott, részben csatlakoztatott vagy leválasztott forgatókönyvekben telepíthetők.You can install Azure Stack Hub compatible PowerShell Az modules in Internet-connected, partially connected, or disconnected scenarios. Ez a cikk részletesen ismerteti ezeket a forgatókönyveket.This article walks you through the detailed instructions for these scenarios.

1. Ellenőrizze az előfeltételeket1. Verify your prerequisites

Az az modulokat a 2002-es vagy újabb frissítéssel rendelkező Azure Stack hub támogatja, valamint a jelenleg telepített gyorsjavítások.Az modules are supported on Azure Stack Hub with Update 2002 or later and with the current hotfixes installed. További információért tekintse meg az Azure stack hub kibocsátási megjegyzéseit .Please see the Azure Stack Hub release notes for more information.

A Azure PowerShell az modulok a PowerShell 5,1-es vagy újabb verziójával működnek a Windowson, vagy a PowerShell Core 6. x-es és újabb verzióiban minden platformon.The Azure PowerShell Az modules work with PowerShell 5.1 or higher on Windows, or PowerShell Core 6.x and later on all platforms. Telepítenie kell a PowerShell Core legújabb verzióját az operációs rendszer számára.You should install the latest version of PowerShell Core available for your operating system. A Azure PowerShell nem rendelkezik további követelményekkel a PowerShell Core-on való futtatáskor.Azure PowerShell has no additional requirements when run on PowerShell Core.

A PowerShell verziójának megtekintéséhez futtassa az alábbi parancsot:To check your PowerShell version, run the command:

$PSVersionTable.PSVersion

A Windows előfeltételeiPrerequisites for Windows

Az Azure PowerShell használata PowerShell 5.1-ben Windows rendszeren:To use Azure PowerShell in PowerShell 5.1 on Windows:

  1. Frissítsen a Windows PowerShell 5.1-re, ha szükséges.Update to Windows PowerShell 5.1 if needed. Ha Windows 10 rendszert használ, már telepítve van a PowerShell 5.1.If you're on Windows 10, you already have PowerShell 5.1 installed.
  2. Telepítse a .NET-keretrendszer 4.7.2-es vagy újabb verzióját.Install .NET Framework 4.7.2 or later.
  3. Győződjön meg arról, hogy a PowerShellGet legújabb verziójával rendelkezik.Make sure you have the latest version of PowerShellGet. Futtassa az Install-Module PowerShellGet -MinimumVersion 2.2.3 -Force parancsot.Run Install-Module PowerShellGet -MinimumVersion 2.2.3 -Force.

2. a Linux és a Mac előfeltételei2. Prerequisites for Linux and Mac

A PowerShell Core 6. x vagy újabb verziója szükséges.PowerShell Core 6.x or later version is needed. Útmutatásért kövesse az alábbi hivatkozástFollow the link for instructions

3. távolítsa el az Azure Stack hub PowerShell-modulok meglévő verzióit3. Uninstall existing versions of the Azure Stack Hub PowerShell modules

A szükséges verzió telepítése előtt győződjön meg arról, hogy eltávolítja a korábban telepített Azure Stack hub Azure Resource Manager vagy az PowerShell modulokat.Before installing the required version, make sure that you uninstall any previously installed Azure Stack Hub Azure Resource Manager or Az PowerShell modules. Távolítsa el a modulokat a következő két módszer egyikének használatával:Uninstall the modules by using one of the following two methods:

  1. A meglévő Azure Resource Manager és az PowerShell-modulok eltávolításához zárjunk be minden aktív PowerShell-munkamenetet, és futtassa a következő parancsmagokat: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
    

    Ha olyan hibát talál, mint például a "a modul már használatban van", akkor a modulokat használó PowerShell-munkameneteket, majd futtassa újra a fenti szkriptet.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. Törölje az összes olyan mappát, amely a-val kezdődik Azure , Az vagy Azs. a C:\Program Files\WindowsPowerShell\Modules és a C:\Users\{yourusername}\Documents\WindowsPowerShell\Modules mappákból.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. A mappák törlése eltávolítja a meglévő PowerShell-modulokat.Deleting these folders removes any existing PowerShell modules.

4. csatlakoztatva: telepítés internetkapcsolattal4. Connected: Install with internet connectivity

Az Azure Stack az Module Azure Stack hub 2002-as vagy újabb verziójával fog működni.The Azure Stack Az module will work Azure Stack Hub 2002 or later. Emellett a Azure Stack az modul a PowerShell 5,1-es vagy újabb verzióját fogja működni Windows-gépen, vagy a PowerShell 6. x-es vagy újabb verzióját egy Linux-vagy macOS-platformon.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. Az előnyben részesített telepítési módszer a PowerShellGet-parancsmagok használata.Using the PowerShellGet cmdlets is the preferred installation method. Ez a módszer ugyanúgy működik a támogatott platformokon.This method works the same on the supported platforms.

Futtassa az alábbi parancsot egy PowerShell-munkamenetből: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

Megjegyzés

Azure Stack hub-modul 2.0.0-verziójának feltörési változása.Azure Stack Hub module version 2.0.0 is a breaking change. A részletekért tekintse meg az áttelepítés a AzureRM-ről Azure PowerShell az az Azure stack hub-ban című témakört.Refer to the Migrate from AzureRM to Azure PowerShell Az in Azure Stack Hub for details.

Figyelmeztetés

Egyszerre csak a Azure Resource Manager (AzureRM) és az az modulok vannak telepítve a PowerShell 5,1-hez.You can't have both the Azure Resource Manager (AzureRM) and Az modules installed for PowerShell 5.1 for Windows at the same time. Ha meg kell őriznie Azure Resource Manager a rendszeren elérhetőnek kell lennie, telepítse az az modult a PowerShell Core 6. x vagy újabb verzióra.If you need to keep Azure Resource Manager available on your system, install the Az module for PowerShell Core 6.x or later. Ehhez telepítse a PowerShell Core 6. x-es vagy újabb verzióját , majd kövesse ezeket az utasításokat egy PowerShell Core-terminálon.To do this, install PowerShell Core 6.x or later and then follow these instructions in a PowerShell Core terminal.

5. leválasztva: telepítés internetkapcsolat nélkül5. Disconnected: Install without internet connection

Leválasztott forgatókönyv esetén először töltse le a PowerShell-modulokat egy internetkapcsolattal rendelkező gépre.In a disconnected scenario, you first download the PowerShell modules to a machine that has internet connectivity. Ezután a telepítéshez továbbítja azokat a Azure Stack Development Kitba (ASDK).Then, you transfer them to the Azure Stack Development Kit (ASDK) for installation.

Jelentkezzen be egy internetkapcsolattal rendelkező számítógépre, és a következő parancsfájlok segítségével töltse le a Azure Resource Manager és Azure Stack hub-csomagokat az Azure Stack hub verziójától függően.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.

A telepítés öt lépésből áll:Installation has five steps:

  1. Telepítse Azure Stack hub PowerShellt egy csatlakoztatott gépre.Install Azure Stack Hub PowerShell to a connected machine.
  2. Engedélyezze a további tárolási funkciókat.Enable additional storage features.
  3. A PowerShell-csomagok átvitele a kapcsolat nélküli munkaállomásra.Transport the PowerShell packages to your disconnected workstation.
  4. Adja meg manuálisan a NuGet-szolgáltatót a kapcsolat nélküli munkaállomáson.Manually bootstrap the NuGet provider on your disconnected workstation.
  5. Erősítse meg a PowerShell telepítését.Confirm the installation of PowerShell.

Azure Stack hub PowerShell telepítéseInstall Azure Stack Hub PowerShell

Azure Stack hub 2002 vagy újabb.Azure Stack Hub 2002 or later.

Azure Resource Manager vagy az az modulokat is használhatja.You could either use Azure Resource Manager or Az modules. Azure Resource Manager esetében tekintse meg a PowerShell-AzureRM modul telepítésecímű témakör útmutatását.For Azure Resource Manager, see the instructions at Install PowerShell AzureRM module. A következő kód a megbízható online tárházból menti a modulokat 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

Megjegyzés

Internetkapcsolat nélküli gépeken a következő parancsmag futtatását javasoljuk a telemetria-adatgyűjtés letiltásához.On machines without an internet connection, we recommend executing the following cmdlet for disabling the telemetry data collection. A parancsmagok teljesítménybeli romlása a telemetria-adatgyűjtés letiltása nélkül is felmerülhet.You may experience a performance degradation of the cmdlets without disabling the telemetry data collection. Ez csak az internetkapcsolat nélküli gépek esetében érvényesThis is applicable only for the machines without internet connections

Disable-AzDataCollection

Csomagok hozzáadása a munkaállomáshozAdd your packages to your workstation

  1. Másolja a letöltött csomagokat egy USB-eszközre.Copy the downloaded packages to a USB device.

  2. Jelentkezzen be a kapcsolat nélküli munkaállomásra, és másolja a csomagokat az USB-eszközről a munkaállomás egyik helyére.Sign in to the disconnected workstation and copy the packages from the USB device to a location on the workstation.

  3. Adja meg manuálisan a NuGet-szolgáltatót a kapcsolat nélküli munkaállomáson.Manually bootstrap the NuGet provider on your disconnected workstation. Útmutatásért lásd: a NuGet-szolgáltató manuális betöltése olyan gépen, amely nem kapcsolódik az internethez.For instructions, see Manually bootstrapping the NuGet provider on a machine that isn't connected to the internet.

  4. Regisztrálja ezt a helyet alapértelmezett tárházként, és telepítse a AzureRM és a AzureStack modulokat ebből a tárházból: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
    

A PowerShell telepítésének megerősítéseConfirm the installation of PowerShell

A következő parancs futtatásával erősítse meg a telepítést:Confirm the installation by running the following command:

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

6. a PowerShell konfigurálása proxykiszolgáló használatára6. Configure PowerShell to use a proxy server

Olyan helyzetekben, amelyekhez proxykiszolgáló szükséges az internethez való hozzáféréshez, először konfigurálja a PowerShellt egy meglévő proxykiszolgáló használatára:In scenarios that require a proxy server to access the internet, you first configure PowerShell to use an existing proxy server:

  1. Nyisson meg egy rendszergazda jogú PowerShell-parancssort.Open an elevated PowerShell prompt.

  2. Futtassa az alábbi parancsot: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. használja az az modult7. Use the Az module

A parancsmagokat és a kód mintákat Azure Resource Manager alapján is használhatja.You can use the cmdlets and code samples based on Azure Resource Manager. Azonban módosítania kell a modulok és a parancsmagok nevét.However, you will want to change the name of the modules and cmdlets. A modul neve megváltozott, így az AzureRM Azure és Az a parancsmagok is megegyeznek.The module names have been changed so that AzureRM and Azure become Az, and the same for cmdlets. Például a AzureRM.Compute modul át lett nevezve a következőre: Az.Compute . New-AzureRMVMFor example, the AzureRM.Compute module has been renamed to Az.Compute. New-AzureRMVM New-AzVM lett, a Get-AzureStorageBlob pedig Get-AzStorageBlob.has become New-AzVM, and Get-AzureStorageBlob is now Get-AzStorageBlob.

A AzurRM-szkriptek az az-ba való áthelyezésével és a Azure Stack hub az az modulban történő módosításával kapcsolatos részletesebb megbeszélések és útmutatás: áttelepítés az AzureRM-ből Azure PowerShell az-ba.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.

Ismert problémákKnown issues

Hiba történt az az modulok telepítésekorError thrown when installing the Az modules

  • Alkalmazható: a probléma a 2002-es és újabb verziókra vonatkozikApplicable: This issue applies to 2002 and later
  • Ok: a modul telepítésekor hiba történik.Cause: When installing the module, an error is thrown. A hibaüzenet kezdete: Register-PacakgeSource : A parameter cannot be found that matches parameter name. 'PackageManagementProvider'. vagy a hibaüzenet a következő szöveget tartalmazhatja: 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."
  • Szervizelés: futtassa a következő parancsmagot ugyanabban a munkamenetben:Remediation: Run the following cmdlet in the same session:
    Install-Module PowershellGet -MinimumumVersion 2.3.0 -Force
    Zárjuk be a munkamenetet, és indítson el egy új emelt szintű PowerShell-munkamenetet.Close your session and start a new elevated PowerShell session.
  • Előfordulás: gyakoriOccurrence: Common

Ha az az modul telepítésekor hamisan dobja a rendszergazdai jogosultságokat, hiba történtWhen installing Az module falsely throws Admin rights required error

  • Alkalmazható: a probléma a 2002-es és újabb verziókra vonatkozikApplicable: This issue applies to 2002 and later
  • Ok: Ha a modult egy emelt szintű parancssorból telepíti, a rendszer hibát jelez.Cause: When installing the module from an elevated prompt, an error is thrown. A hiba a következőt mondja: Administrator rights required .The error says, Administrator rights required.
  • Szervizelés: zárd be a munkamenetet, és indítson el egy új, emelt szintű PowerShell-munkamenetet.Remediation: Close your session and start a new elevated PowerShell session. Győződjön meg arról, hogy nincs létező az.Make sure there isn't an existing Az. A munkamenetben betöltött fiókok modul.Accounts module loaded in the session.
  • Előfordulás: gyakoriOccurrence: Common

Következő lépésekNext steps