Azure Stack Hub için PowerShell Azurerd modülünü yüklerInstall PowerShell AzureRM module for Azure Stack Hub

Azure PowerShell Azure Resource Manager (Azurerd), Azure Stack hub kaynaklarınızı yönetmek için Azure Resource Manager modelini kullanan bir cmdlet kümesi sağlar.Azure PowerShell Azure Resource Manager (AzureRM) provides a set of cmdlets that use the Azure Resource Manager model for managing your Azure Stack Hub resources.

Önemli

Azure PowerShell’in eski bir sürümüne yönelik web sayfasına ulaştınız.You've reached a webpage for an outdated version of Azure PowerShell. Azure Resource Manager (Azurerd) PowerShell modülünün tüm sürümleri güncel değil, ancak destek dışı.All versions of the Azure Resource Manager (AzureRM) PowerShell module are outdated, but not out of support. Az PowerShell modülü artık Azure ve Azure Stack hub ile etkileşim kurmak için önerilen PowerShell modülüdür.The Az PowerShell module is now the recommended PowerShell module for interacting with Azure and Azure Stack Hub. Az PowerShell modülünü kullanmaya başlamak için bkz. Azure Stack hub 'ı Için PowerShell az Preview Module' ü yüklemek.To get started with the Az PowerShell module, see Install PowerShell Az preview module for Azure Stack Hub. Az PowerShell modülüne geçiş yapmayı öğrenmek için.To learn how to migrate to the Az PowerShell module. bkz. Azure Stack hub 'Da Azurere 'dan Azure PowerShell az ' a geçirme.see Migrate from AzureRM to Azure PowerShell Az in Azure Stack Hub.

Ayrıca, Azure Stack hub kaynak sağlayıcıları için uyumlu uç noktaları belirtmek üzere API profillerini de kullanmanız gerekir.You also need to 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 uyumlu PowerShell modülleri yükleyebilirsiniz.You can install Azure Stack Hub compatible PowerShell 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.

Bir Docker kapsayıcısında Azure Stack Hub için Azure Resource Manager modüllerini de çalıştırabilirsiniz.You can also run the Azure Resource Manager 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.

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

Azure Stack hub ve PowerShell Azure Resource Manager modülünü kullanmaya başlamadan önce, aşağıdaki önkoşullara sahip olmanız gerekir:Before you get started with Azure Stack Hub and the PowerShell Azure Resource Manager module, you must have the following prerequisites:

  • PowerShell sürüm 5,1PowerShell Version 5.1
    Sürümünüzü denetlemek için $PSVersionTable. psversion çalıştırın ve ana sürümü karşılaştırın.To check your version, run $PSVersionTable.PSVersion and compare the Major version. PowerShell 5,1 ' i yoksa, Windows PowerShell 'ı yükleme' yi izleyin.If you don't have PowerShell 5.1, follow the Installing Windows PowerShell.

    Not

    PowerShell 5,1, bir Windows makinesi gerektirir.PowerShell 5.1 requires a Windows machine.

  • PowerShell 'i yükseltilmiş bir komut Isteminde çalıştırın.Run PowerShell in an elevated command prompt.

  • PowerShell Galerisi erişimPowerShell Gallery access
    PowerShell Galerisierişiminizin olması gerekir.You need access to the PowerShell Gallery. Galeri, PowerShell içeriği için merkezi depodur.The gallery is the central repository for PowerShell content. PowerShellGet modülü PowerShell yapılarını bulmak, yüklemek, güncelleştirmek ve yayımlamak için cmdlet 'leri içerir.The PowerShellGet module contains cmdlets for discovering, installing, updating, and publishing PowerShell artifacts. Bu yapıtlara örnek olarak modüller, DSC kaynakları, rol özellikleri ve PowerShell Galerisi ve diğer özel depolardaki betikler verilebilir.Examples of these artifacts are modules, DSC resources, role capabilities, and scripts from the PowerShell Gallery and other private repositories. PowerShell 'i bağlantısı kesik bir senaryoda kullanıyorsanız, internet bağlantısı olan bir makineden kaynak almalısınız ve bunları, bağlantısı kesilen makinenize erişilebilen bir konumda depolıyoruz.If you're using PowerShell in a disconnected scenario, you must retrieve resources from a machine with a connection to the internet and store them in a location accessible to your disconnected machine.

PSGallery 'nin bir depo olarak kaydedilip kaydedilmediği doğrulayın.Validate if PSGallery is registered as a repository.

Not

Bu adım internet erişimi gerektirir.This step requires internet access.

Yükseltilmiş bir PowerShell istemi açın ve aşağıdaki cmdlet 'leri çalıştırın:Open an elevated PowerShell prompt, and run the following cmdlets:

Install-module -Name PowerShellGet -Force
Import-Module -Name PackageManagement -ErrorAction Stop
Get-PSRepository -Name "PSGallery"

Depo kayıtlı değilse, yükseltilmiş bir PowerShell oturumu açın ve aşağıdaki komutu çalıştırın:If the repository isn't registered, open an elevated PowerShell session and run the following command:

Register-PSRepository -Default
Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted

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 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 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 Azure Stack hub 'ı için PowerShell 'i yükler4. Connected: Install PowerShell for Azure Stack Hub with internet connectivity

İhtiyaç duyduğunuz API sürüm profili ve Azure Stack merkezi PowerShell modülleri, çalıştırdığınız Azure Stack hub sürümüne göre değişir.The API version profile and Azure Stack Hub PowerShell modules you require will depend on the version of Azure Stack Hub you're running.

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

Bu modülleri geliştirme iş istasyonunuza yüklemek için aşağıdaki PowerShell betiğini çalıştırın:Run the following PowerShell script to install these modules on your development workstation:

Azure Stack hub 2002 veya üzeri için:For Azure Stack Hub 2002 or later:

Kullanıcı Azurermmodules veya az Preview modüllerini kullanabilirsiniz.You can use either user AzureRm modules or Az preview modules. Az modüllerin kullanımı, Azure Stack hub 2002 ve en son düzeltmeyi gerektirir.The use of the Az modules requires Azure Stack Hub 2002 and the latest hotfix.

Az Preview modüllerini kullanmak için PowerShell az Module' u yüklemek için yönergeleri izleyin.To use Az preview modules, follow the instructions at Install PowerShell Az module.

# Install the AzureRM.BootStrapper module. Select Yes when prompted to install NuGet
Install-Module -Name AzureRM.BootStrapper

# Install and import the API Version Profile required by Azure Stack Hub into the current PowerShell session.
Use-AzureRmProfile -Profile 2019-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.8.2

Azure Stack hub 1910 için:For Azure Stack Hub 1910:

# Install the AzureRM.BootStrapper module. Select Yes when prompted to install NuGet
Install-Module -Name AzureRM.BootStrapper

# Install and import the API Version Profile required by Azure Stack Hub into the current PowerShell session.
Use-AzureRmProfile -Profile 2019-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.8.0

Not

  • Azure Stack hub modülü sürüm 1.8.0, bir son değişiklik sürümüdür.Azure Stack Hub module version 1.8.0 is a breaking change release. Ayrıntılar için sürüm notuna bakın.Refer to the release note for details.

Azure Stack hub 1908 veya öncesi için:For Azure Stack Hub 1908 or earlier:

# Install the AzureRM.BootStrapper module. Select Yes when prompted to install NuGet
Install-Module -Name AzureRM.BootStrapper

# Install and import the API Version Profile required by Azure Stack Hub into the current PowerShell session.
Use-AzureRmProfile -Profile 2019-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.7.2

Not

Azure Stack hub Module sürümü 1.7.2, bir son değişiklik sürümüdür.The Azure Stack Hub module version 1.7.2 is a breaking change release. Azure Stack hub 1.6.0 'dan geçiş yapmak için lütfen geçiş kılavuzunabakın.To migrate from Azure Stack Hub 1.6.0, please refer to the migration guide.

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 "Azure*" -ListAvailable
Get-Module -Name "Azs*" -ListAvailable

Yükleme başarılı olursa, AzureRm ve AzureStack modülleri çıktıda görüntülenir.If the installation is successful, the AzureRm and AzureStack modules are displayed in the output.

5. bağlantısı kesik: internet bağlantısı olmadan PowerShell 'i yükler5. Disconnected: Install PowerShell without an 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 ya da az Preview modülü kullanabilirsiniz.You could either use Azure Resource Manager or Az preview modules. Az modüller için, PowerShell 'ı Install az Modulekonumundaki yönergeler bölümüne bakın.For Az modules, see instructions at Install PowerShell Az module.


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

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

Azure Stack hub 1910.Azure Stack Hub 1910.

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

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

Not

Azure Stack hub modülü sürüm 1.8.0, bir son değişiklik sürümüdür.Azure Stack Hub module version 1.8.0 is a breaking change release. Ayrıntılar için sürüm notuna bakın.Refer to the release note for details.

Azure Stack hub 1908 veya öncesi için:For Azure Stack Hub 1908 or earlier:

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

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

Not

Azure Stack hub modülü sürüm 1.7.1, bir son değişiklik.The Azure Stack Hub module version 1.7.1 is a breaking change. Azure Stack hub 1.6.0 'den geçiş yapmak için lütfen geçiş kılavuzunabakın.To migrate from Azure Stack Hub 1.6.0 please refer to the migration guide.

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-AzureRmDataCollection

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 AzureStack Bu depodan Azure Resource Manager ve modülleri yüklensin:Register this location as the default repository and install the Azure Resource Manager 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"
    
    Register-PSRepository -Name $RepoName -SourceLocation $SourceLocation -InstallationPolicy Trusted
    
    Install-Module -Name AzureRM -Repository $RepoName
    
    Install-Module -Name AzureStack -Repository $RepoName
    

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 "Azure*" -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
    

Bilinen sorunKnown issue

Yöntem get_SerializationSettings hatasıMethod get_SerializationSettings error

  • Neden: PowerShell az Module ve PowerShell Azure Resource Manager modülleri uyumlu değil.Cause: The PowerShell Az module and PowerShell Azure Resource Manager modules are not compatible.

    Aşağıdaki hata, Azure Resource Manager modüllerinin ve az modüllerin aynı oturumda yüklendiğini gösterir:The following error indicates that the Azure Resource Manager modules and Az modules are loaded in the same session:

    >  Method 'get_SerializationSettings' in type 'Microsoft.Azure.Management.Internal.Resources.ResourceManagementClient' from assembly 'Microsoft.Azure.Commands.ResourceManager.Common, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' does 
    not have an implementation.
    
  • Düzeltme: çakışan modülleri kaldırın.Remediation: Uninstall the conflicting modules.

    Azure Resource Manager modüllerini kullanmak istiyorsanız az modüller ' i kaldırın.If you would like to use the Azure Resource Manager modules, uninstall the Az modules. Veya az modüller kullanmak istiyorsanız Azure Resource Manager kaldırın.Or uninstall the Azure Resource Manager if you would like to use the Az modules. PowerShell oturumunuzu kapatın ve az ya da Azure Resource Manager modüllerini kaldırın.Close your PowerShell session and uninstall either the Az or Azure Resource Manager modules.

    Azure Stack hub PowerShell modüllerinin var olan sürümlerini kaldırmayönergeleri bulabilirsiniz.You can find instructions at Uninstall existing versions of the Azure Stack Hub PowerShell modules.

Sonraki adımlarNext steps