PowerShell 'i Azure Stack Hub için Install az ModuleInstall PowerShell Az module for Azure Stack Hub

Bu makalede PowerShellGet kullanılarak Azure PowerShell az ve uyumlu Azure Stack hub yönetici modüllerinin nasıl yükleneceği açıklanır.This article explains how to install the Azure PowerShell Az and compatible Azure Stack Hub administrator modules using PowerShellGet. Az modüller Windows, macOS ve Linux platformları üzerine yüklenebilir.The Az modules can be installed on Windows, macOS, and Linux platforms.

Docker kapsayıcısında Azure Stack Hub için az modüller de çalıştırabilirsiniz.You can also run the Az modules for Azure Stack Hub in a Docker container. Yönergeler için bkz. Azure Stack hub 'ı Için PowerShell çalıştırmak Için Docker kullanma.For instructions, see Use Docker to run PowerShell for Azure Stack Hub.

Azure Stack Hub için PowerShell kaynak modülleri (AzureRM) modülünü yüklemek isterseniz, bkz. Azure Stack hub 'ı Için PowerShell AzureRM modülünü Install.If you would like to install PowerShell Resource Modules (AzureRM) module for Azure Stack Hub, see Install PowerShell AzureRM module for Azure Stack Hub.

Önemli

Büyük olasılıkla yeni Azure Kaynak modülleri modül yayınları olmayacak.There will likely not be new Azure Resource Modules module releases. Azure Kaynak modülleri modülleri yalnızca kritik düzeltmeleri destekler.The Azure Resource Modules modules are under support for critical fixes only. Bu işlem yalnızca Azure Stack Hub için az yayınlar olacaktır.Going forward there will only be Az releases for Azure Stack Hub.

Azure Stack hub kaynak sağlayıcıları için uyumlu uç noktaları belirtmek üzere API profillerini kullanabilirsiniz.You can use API profiles to specify the compatible endpoints for the Azure Stack Hub resource providers.

API profilleri, Azure ile Azure Stack hub arasındaki sürüm farklarını yönetmek için bir yol sağlar.API profiles provide a way to manage version differences between Azure and Azure Stack Hub. API sürümü profili, belirli API sürümleriyle Azure Resource Manager PowerShell modülleri kümesidir.An API version profile is a set of Azure Resource Manager PowerShell modules with specific API versions. Her bulut platformunda desteklenen bir API sürüm profili kümesi vardır.Each cloud platform has a set of supported API version profiles. Örneğin Azure Stack hub, 2019-03-01 karma gibi belirli bir profil sürümünü destekler.For example, Azure Stack Hub supports a specific profile version such as 2019-03-01-hybrid. Bir profil yüklediğinizde, belirtilen profile karşılık gelen Azure Resource Manager PowerShell modülleri yüklenir.When you install a profile, the Azure Resource Manager PowerShell modules that correspond to the specified profile are installed.

Internet 'e bağlı, kısmen bağlı veya bağlantısı kesik senaryolarda Azure Stack hub ile uyumlu PowerShell az modüllerini yükleyebilirsiniz.You can install Azure Stack Hub compatible PowerShell Az modules in Internet-connected, partially connected, or disconnected scenarios. Bu makalede, bu senaryolara yönelik ayrıntılı yönergeler adım adım açıklanmaktadır.This article walks you through the detailed instructions for these scenarios.

1. ön koşulları doğrulayın1. Verify your prerequisites

Az modüller güncelleştirme 2002 veya sonraki sürümleri ile Azure Stack hub 'da ve geçerli düzeltmeler yüklüyken desteklenir.Az modules are supported on Azure Stack Hub with Update 2002 or later and with the current hotfixes installed. Daha fazla bilgi için lütfen Azure Stack hub sürüm notlarına bakın.Please see the Azure Stack Hub release notes for more information.

Azure PowerShell az modül Windows üzerinde PowerShell 5,1 veya üzeri ya da tüm platformlarda PowerShell Core 6. x ve üzeri ile çalışır.The Azure PowerShell Az modules work with PowerShell 5.1 or higher on Windows, or PowerShell Core 6.x and later on all platforms. İşletim sisteminiz için kullanılabilen PowerShell Core 'un en son sürümünü yüklemelisiniz.You should install the latest version of PowerShell Core available for your operating system. Azure PowerShell, PowerShell Core üzerinde çalıştırıldığında ek gereksinimlere sahip değildir.Azure PowerShell has no additional requirements when run on PowerShell Core.

PowerShell sürümünüzü denetlemek için şu komutu çalıştırın:To check your PowerShell version, run the command:

$PSVersionTable.PSVersion

Windows önkoşullarıPrerequisites for Windows

Azure PowerShell’i Windows üzerinde PowerShell 5.1’de kullanmak için:To use Azure PowerShell in PowerShell 5.1 on Windows:

  1. Gerekirse Windows PowerShell 5.1'e güncelleştirin.Update to Windows PowerShell 5.1 if needed. Windows 10 kullanıyorsanız, zaten PowerShell 5.1 yüklüdür.If you're on Windows 10, you already have PowerShell 5.1 installed.
  2. .NET Framework 4.7.2 veya sonraki sürümünü yükleyin.Install .NET Framework 4.7.2 or later.
  3. En son PowerShellGet sürümünü kullandığınızdan emin olun.Make sure you have the latest version of PowerShellGet. Install-Module PowerShellGet -MinimumVersion 2.2.3 -Force öğesini çalıştırın.Run Install-Module PowerShellGet -MinimumVersion 2.2.3 -Force.

2. Linux ve Mac için Önkoşullar2. Prerequisites for Linux and Mac

PowerShell Core 6. x veya üzeri sürümü gerekir.PowerShell Core 6.x or later version is needed. Yönergeler için bağlantıyı izleyinFollow the link for instructions

3. Azure Stack hub PowerShell modüllerinin var olan sürümlerini kaldırın3. Uninstall existing versions of the Azure Stack Hub PowerShell modules

Gerekli sürümü yüklemeden önce, daha önce yüklenmiş Azure Stack hub Azure Resource Manager veya az PowerShell modüllerini kaldırdığınızdan emin olun.Before installing the required version, make sure that you uninstall any previously installed Azure Stack Hub Azure Resource Manager or Az PowerShell modules. Aşağıdaki iki yöntemden birini kullanarak modülleri kaldırın:Uninstall the modules by using one of the following two methods:

  1. Mevcut Azure Resource Manager ve az PowerShell modüllerini kaldırmak için, tüm etkin PowerShell oturumlarını kapatın ve aşağıdaki cmdlet 'leri çalıştırın: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
    

    ' Modül zaten kullanımda ' gibi bir hatayla karşılaşırsanız, modülleri kullanan PowerShell oturumlarını kapatın ve yukarıdaki betiği yeniden çalıştırın.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. İle başlayan tüm klasörleri Azure Az veya Azs. C:\Program Files\WindowsPowerShell\Modules ve C:\Users\{yourusername}\Documents\WindowsPowerShell\Modules klasörlerini silin.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. Bu klasörlerin silinmesi, var olan tüm PowerShell modüllerini kaldırır.Deleting these folders removes any existing PowerShell modules.

4. bağlı: internet bağlantısı ile Install4. Connected: Install with internet connectivity

Azure Stack az Module Azure Stack hub 2002 veya sonraki bir sürümü çalışacaktır.The Azure Stack Az module will work Azure Stack Hub 2002 or later. Ayrıca, Azure Stack az Module bir Windows makinesinde PowerShell 5,1 veya üzeri ya da Linux veya macOS platformunda PowerShell 6. x veya üzeri ile çalışır.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. PowerShellGet cmdlet’lerinin kullanılması, tercih edilen yükleme yöntemidir.Using the PowerShellGet cmdlets is the preferred installation method. Bu yöntem desteklenen platformlarda aynı şekilde çalışmaktadır.This method works the same on the supported platforms.

Bir PowerShell oturumunda aşağıdaki komutu çalıştırın: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

Not

Azure Stack hub modülü sürüm 2.0.0, bir son değişiklik.Azure Stack Hub module version 2.0.0 is a breaking change. Ayrıntılar için Azure Stack hub 'ında Azurerd Azure PowerShell az ' a geçiş yapın .Refer to the Migrate from AzureRM to Azure PowerShell Az in Azure Stack Hub for details.

Uyarı

Aynı anda Windows için PowerShell 5,1 için hem Azure Resource Manager (Azurera) hem de az modules yüklü olamaz.You can't have both the Azure Resource Manager (AzureRM) and Az modules installed for PowerShell 5.1 for Windows at the same time. Sisteminizde kullanılabilir Azure Resource Manager tutmanız gerekiyorsa, PowerShell Core 6. x veya üzeri için az Module 'ü yüklemeniz gerekir.If you need to keep Azure Resource Manager available on your system, install the Az module for PowerShell Core 6.x or later. Bunu yapmak için PowerShell Core 6. x veya üstünü yükledikten sonra bir PowerShell Çekirdek terminalinde bu yönergeleri uygulayın.To do this, install PowerShell Core 6.x or later and then follow these instructions in a PowerShell Core terminal.

5. bağlantısı kesik: internet bağlantısı olmadan yüklemesi5. Disconnected: Install without internet connection

Bağlantısı kesik bir senaryoda, önce PowerShell modüllerini internet bağlantısı olan bir makineye indirmelisiniz.In a disconnected scenario, you first download the PowerShell modules to a machine that has internet connectivity. Ardından, bunları yükleme için Azure Stack Geliştirme Seti (ASDK) olarak aktarırsınız.Then, you transfer them to the Azure Stack Development Kit (ASDK) for installation.

İnternet bağlantısı olan bir bilgisayarda oturum açın ve Azure Stack hub 'ınızın sürümüne bağlı olarak Azure Resource Manager ve Azure Stack hub paketlerini indirmek için aşağıdaki komut dosyalarını kullanın.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.

Yüklemede beş adım vardır:Installation has five steps:

  1. Bağlı bir makineye Azure Stack hub PowerShell 'i yükler.Install Azure Stack Hub PowerShell to a connected machine.
  2. Ek depolama özelliklerini etkinleştirin.Enable additional storage features.
  3. PowerShell paketlerini, bağlantısı kesilen iş istasyonunuza aktarma.Transport the PowerShell packages to your disconnected workstation.
  4. NuGet sağlayıcısını, bağlantısı kesilen iş istasyonunuzda el ile önyükleyebilirsiniz.Manually bootstrap the NuGet provider on your disconnected workstation.
  5. PowerShell 'in yüklenmesini onaylayın.Confirm the installation of PowerShell.

Azure Stack hub PowerShell 'i yüklerInstall Azure Stack Hub PowerShell

Azure Stack hub 2002 veya üzeri.Azure Stack Hub 2002 or later.

Azure Resource Manager veya az modül kullanabilirsiniz.You could either use Azure Resource Manager or Az modules. Azure Resource Manager için PowerShell Azurerd modülünü Installkonumundaki yönergelere bakın.For Azure Resource Manager, see the instructions at Install PowerShell AzureRM module. Aşağıdaki kod, güvenilir çevrimiçi depodan modüller kaydeder 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

Not

İnternet bağlantısı olmayan makinelerde, telemetri veri toplamayı devre dışı bırakmak için aşağıdaki cmdlet 'i yürütmenizi öneririz.On machines without an internet connection, we recommend executing the following cmdlet for disabling the telemetry data collection. Telemetri veri toplamayı devre dışı bırakmadan cmdlet 'lerde bir performans düşüşü yaşayabilirsiniz.You may experience a performance degradation of the cmdlets without disabling the telemetry data collection. Bu yalnızca İnternet bağlantısı olmayan makineler için geçerlidirThis is applicable only for the machines without internet connections

Disable-AzDataCollection

Paketlerinizi iş istasyonunuza ekleyinAdd your packages to your workstation

  1. İndirilen paketleri bir USB cihazına kopyalayın.Copy the downloaded packages to a USB device.

  2. Bağlantısı kesilen iş istasyonunda oturum açın ve paketleri USB cihazdan iş istasyonundaki bir konuma kopyalayın.Sign in to the disconnected workstation and copy the packages from the USB device to a location on the workstation.

  3. NuGet sağlayıcısını, bağlantısı kesilen iş istasyonunuzda el ile önyükleyebilirsiniz.Manually bootstrap the NuGet provider on your disconnected workstation. Yönergeler için bkz. Internet 'e bağlı olmayan bir makinede NuGet sağlayıcısını el ile önyükleme.For instructions, see Manually bootstrapping the NuGet provider on a machine that isn't connected to the internet.

  4. Bu konumu varsayılan depo olarak Kaydet ve AzureRM AzureStack Bu depodan ve modüllerini yükler: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
    

PowerShell yüklenmesini onaylamaConfirm the installation of PowerShell

Aşağıdaki komutu çalıştırarak yüklemeyi onaylayın:Confirm the installation by running the following command:

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

6. PowerShell 'i bir proxy sunucu kullanacak şekilde yapılandırma6. Configure PowerShell to use a proxy server

Bir proxy sunucusunun İnternet 'e erişmesini gerektiren senaryolarda, önce PowerShell 'i mevcut bir proxy sunucusunu kullanacak şekilde yapılandırırsınız:In scenarios that require a proxy server to access the internet, you first configure PowerShell to use an existing proxy server:

  1. Yükseltilmiş bir PowerShell istemi açın.Open an elevated PowerShell prompt.

  2. Aşağıdaki komutları çalıştırın: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. az Module kullanın7. Use the Az module

Cmdlet 'leri ve kod örneklerini Azure Resource Manager göre kullanabilirsiniz.You can use the cmdlets and code samples based on Azure Resource Manager. Ancak, modüllerin ve cmdlet 'lerin adını değiştirmek isteyeceksiniz.However, you will want to change the name of the modules and cmdlets. Modül adları, AzureRM ve Azure 'un olabilmesi Az ve cmdlet 'ler için aynı şekilde değiştirilmiştir.The module names have been changed so that AzureRM and Azure become Az, and the same for cmdlets. Örneğin, AzureRM.Compute modül olarak yeniden adlandırıldı Az.Compute . New-AzureRMVMFor example, the AzureRM.Compute module has been renamed to Az.Compute. New-AzureRMVM Şimdi New-AzVM olmuştur ve Get-AzureStorageBlob de Get-AzStorageBlob olmuştur.has become New-AzVM, and Get-AzureStorageBlob is now Get-AzStorageBlob.

AzurRM betiğini az ve Azure Stack hub 'ın az modülündeki değişiklikleri parçalara taşımaya yönelik daha kapsamlı bir tartışma ve kılavuz için bkz. Azurere 'den 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.

Bilinen sorunlarKnown issues

Az modüller yüklenirken hata oluştuError thrown when installing the Az modules

  • Uygulanabilir: Bu sorun 2002 ve üzeri sürümler için geçerlidirApplicable: This issue applies to 2002 and later
  • Neden: modül yüklenirken bir hata oluşur.Cause: When installing the module, an error is thrown. Hata iletisi başlar: Register-PacakgeSource : A parameter cannot be found that matches parameter name. 'PackageManagementProvider'. ya da hata iletisi aşağıdaki metni içerebilir: 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."
  • Düzeltme: aşağıdaki cmdlet 'i aynı oturumda çalıştırın:Remediation: Run the following cmdlet in the same session:
    Install-Module PowershellGet -MinimumumVersion 2.3.0 -Force
    Oturumunuzu kapatın ve yeni bir yükseltilmiş PowerShell oturumu başlatın.Close your session and start a new elevated PowerShell session.
  • Oluşum: ortakOccurrence: Common

Az Module yükleme sırasında, özellikle yönetici hakları gerekli hatası oluşturduğundaWhen installing Az module falsely throws Admin rights required error

  • Uygulanabilir: Bu sorun 2002 ve üzeri sürümler için geçerlidirApplicable: This issue applies to 2002 and later
  • Neden: modül, yükseltilmiş bir komut isteminden yüklenirken bir hata oluşur.Cause: When installing the module from an elevated prompt, an error is thrown. Hata şöyle diyor Administrator rights required .The error says, Administrator rights required.
  • Düzeltme: oturumunuzu kapatın ve yeni bir yükseltilmiş PowerShell oturumu başlatın.Remediation: Close your session and start a new elevated PowerShell session. Mevcut bir az olmadığından emin olun.Make sure there isn't an existing Az. Oturum için hesap modülü yüklendi.Accounts module loaded in the session.
  • Oluşum: ortakOccurrence: Common

Sonraki adımlarNext steps