Azure PowerShell'i yüklemeInstall Azure PowerShell

Bu makalede, PowerShellGet kullanarak Azure PowerShell modüllerinin nasıl yüklendiği ele alınır.This article explains how to install the Azure PowerShell modules using PowerShellGet. Bu yönergeler Windows, macOS ve Linux platformlarında kullanılabilir.These instructions work on Windows, macOS, and Linux platforms.

Azure PowerShell, Azure Cloud Shell’de de sunulur ve şimdi, Docker görüntülerine önceden yüklenir.Azure PowerShell is also available in Azure Cloud Shell and is now preinstalled in Docker images.

GereksinimlerRequirements

Not

PowerShell 7.x ve üzeri, tüm platformlarda Azure PowerShell ile kullanılması önerilen PowerShell sürümüdür.PowerShell 7.x and later is the recommended version of PowerShell for use with Azure PowerShell on all platforms.

Azure PowerShell tüm platformlarda PowerShell 6.2.4 ve üzeri sürümlerle birlikte kullanılabilir.Azure PowerShell works with PowerShell 6.2.4 and later on all platforms. Ayrıca Windows üzerinde PowerShell 5.1 ile de desteklenir.It is also supported with PowerShell 5.1 on Windows. İşletim sisteminiz için sunulan en son PowerShell sürümünü yükleyin.Install the latest version of PowerShell available for your operating system. PowerShell 6.2.4 ve üzerinde çalıştırıldığında Azure PowerShell için ek gereksinim yoktur.Azure PowerShell has no additional requirements when run on PowerShell 6.2.4 and later.

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

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

  1. Windows PowerShell 5.1’e güncelleştirin.Update to Windows PowerShell 5.1. Windows 10 sürüm 1607 veya üzeri sürümü kullanıyorsanız, zaten PowerShell 5.1 yüklüdür.If you're on Windows 10 version 1607 or higher, 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 -Name PowerShellGet -Force öğesini çalıştırın.Run Install-Module -Name PowerShellGet -Force.

Azure PowerShell modülünü yüklemeInstall the Azure PowerShell module

Uyarı

Windows üzerinde PowerShell 5.1’de aynı anda hem AzureRM hem de Az modülünün yüklenmesi desteklenmez.We do not support having both the AzureRM and Az modules installed for PowerShell 5.1 on Windows at the same time. Sisteminizde AzureRM'yi kullanılabilir durumda tutmanız gerekiyorsa, PowerShell 6.2.4 veya sonraki sürümleri için Az modülünü yükleyin.If you need to keep AzureRM available on your system, install the Az module for PowerShell 6.2.4 or later.

PowerShellGet cmdlet’lerinin kullanılması, tercih edilen yükleme yöntemidir.Using the PowerShellGet cmdlets is the preferred installation method. Az modülünü yalnızca geçerli kullanıcı için yükleyin.Install the Az module for the current user only. Bu, önerilen yükleme kapsamıdır.This is the recommended installation scope. Bu yöntem Windows, macOS ve Linux platformlarında aynı şekilde çalışır.This method works the same on Windows, macOS, and Linux platforms. Bir PowerShell oturumunda aşağıdaki komutu çalıştırın:Run the following command from a PowerShell session:

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (Get-Module -Name AzureRM -ListAvailable)) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Scope CurrentUser
}

PowerShell galerisi varsayılan olarak PowerShellGet için güvenilir depo olarak yapılandırılmamıştır.By default, the PowerShell gallery isn't configured as a trusted repository for PowerShellGet. PSGallery'yi ilk kez kullandığınızda şu istemle karşılaşırsınız:The first time you use the PSGallery you see the following prompt:

Untrusted repository

You are installing the modules from an untrusted repository. If you trust this repository, change
its InstallationPolicy value by running the `Set-PSRepository` cmdlet.

Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):

Yükleme işlemine devam etmek için Yes veya Yes to All yanıtını verin.Answer Yes or Yes to All to continue with the installation.

Modülün bir sistemdeki tüm kullanıcılar için yüklenmesi, yükseltilmiş ayrıcalıklar gerektirir.Installing the module for all users on a system requires elevated privileges. Windows’ta Yönetici olarak çalıştır seçeneğini kullanarak ya da macOS veya Linux’ta sudo komutunu kullanarak PowerShell oturumunu başlatın:Start the PowerShell session using Run as administrator in Windows or use the sudo command on macOS or Linux:

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (Get-Module -Name AzureRM -ListAvailable)) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Scope AllUsers
}

Az modülü, Azure PowerShell cmdlet’leri için toplu bir modüldür.The Az module is a rollup module for the Azure PowerShell cmdlets. Bunu yüklediğinizde genel olarak kullanılabilir durumdaki tüm Az PowerShell modülleri indirilir ve cmdlet'leri kullanıma sunulur.Installing it downloads all of the generally available Az PowerShell modules, and makes their cmdlets available for use.

Çevrimdışı yüklemeInstall offline

Bazı ortamlarda PowerShell Galerisi'ne bağlanmak mümkün olmaz.In some environments, it's not possible to connect to the PowerShell Gallery. Bu durumlarda yine de aşağıdaki yöntemlerden birini kullanarak çevrimdışı yükleyebilirsiniz:In those situations, you can still install offline using one of these methods:

  • Modülleri ağınızdaki başka bir konuma indirin ve bu konumu yükleme kaynağı olarak kullanın.Download the modules to another location in your network and use that as an installation source. Bu yöntem, PowerShell modüllerini PowerShellGet ile bağlantısız sistemlere dağıtmak üzere tek sunucuda veya dosya paylaşımında önbelleğe almanızı sağlar.This method allows you to cache PowerShell modules on a single server or file share to be deployed with PowerShellGet to any disconnected systems. Yerel depoyu ayarlamayı ve bağlantısız sistemlerde yüklemeyi öğrenmek için Yerel PowerShellGet depolarıyla çalışma konusundan yararlanın.Learn how to set up a local repository and install on disconnected systems with Working with local PowerShellGet repositories.

  • Ağa bağlı bir makineye Azure PowerShell MSI'yi indirin ve sonra PowerShell Galerisi'ne erişimi olmayan sistemlere yükleyiciyi kopyalayın.Download the Azure PowerShell MSI to a machine connected to the network, and then copy the installer to systems without access to PowerShell Gallery. MSI yükleyicisinin yalnızca Windows üzerinde PowerShell 5.1 için kullanılabildiğini unutmayın.Keep in mind that the MSI installer only works for PowerShell 5.1 on Windows.

  • Modülü Save-Module ile bir dosya paylaşımına kaydedin veya başka bir konuma kaydedin ve sonra el ile diğer makinelere kopyalayın:Save the module with Save-Module to a file share, or save it to another source and manually copy it to other machines:

    Save-Module -Name Az -Path '\\server\share\PowerShell\modules' -Force
    

Sorun gidermeTroubleshooting

Azure PowerShell modülünü yüklerken karşılaşılan yaygın sorunlardan bazıları burada verilmiştir.Here are some common problems seen when installing the Azure PowerShell module. Burada listelenmeyen bir sorunla karşılaşırsanız GitHub’da bir sorun oluşturun.If you experience a problem not listed here, file an issue on GitHub.

Ara sunucu blokları bağlantısıProxy blocks connection

Install-Module cmdlet'inden PowerShell Galerisi'ne ulaşılamadığını belirten hatalar alıyorsanız, bir ara sunucunun arkasında olabilirsiniz.If you get errors from Install-Module that indicate the PowerShell Gallery is unreachable, you may be behind a proxy. Farklı işletim sistemlerinin ve ağ ortamlarının sistem genelinde ara sunucu yapılandırmaya ilişkin gereksinimleri farklıdır.Different operating systems and network environment have different requirements for configuring a system-wide proxy. Ara sunucu ayarlarınız ve ortamınızda bunları nasıl yapılandıracağınız konusunda sistem yöneticinize danışın.Contact your system administrator for your proxy settings and how to configure them for your environment.

PowerShell'in kendisi otomatik olarak bu ara sunucuyu kullanacak şekilde yapılandırılamaz.PowerShell itself may not be configured to use this proxy automatically. Aşağıdaki komutları kullanarak PowerShell 5.1 ve sonraki sürümlerinde PowerShell oturumunu bir ara sunucu kullanacak şekilde yapılandırın:With PowerShell 5.1 and later, configure the PowerShell session to use a proxy using the following commands:

$webClient = New-Object System.Net.WebClient
$webClient.Proxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials

İşletim sistemi kimlik bilgileriniz doğru yapılandırıldıysa, bu yapılandırma PowerShell isteklerini ara sunucu üzerinden yönlendirir.If your operating system credentials are configured correctly, this configuration routes PowerShell requests through the proxy. Bu ayarın oturumlar arasında kalıcı olmasını sağlamak için, komutu PowerShell profilinize ekleyin.To have this setting persist between sessions, add the commands to your PowerShell profile.

Paketi yüklemek için ara sunucunuzun şu adrese yönelik HTTPS bağlantılarına izin vermesi gerekir:To install the package, your proxy needs to allow HTTPS connections to the following address:

  • https://www.powershellgallery.com

Oturum açSign in

Azure PowerShell ile çalışmaya başlamak için, Azure kimlik bilgilerinizle oturum açın.To start working with Azure PowerShell, sign in with your Azure credentials.

# Connect to Azure with a browser sign in token
Connect-AzAccount

Not

Modül otomatik yüklemesini devre dışı bıraktıysanız, Import-Module -Name Az kullanarak modülü el ile içeri aktarın.If you've disabled module autoloading, manually import the module with Import-Module -Name Az. Modülü yapısından dolayı, bu işlem birkaç saniye sürebilir.Because of the way the module is structured, this can take a few seconds.

Başlattığınız her yeni PowerShell oturumu için bu adımları tekrarlamanız gerekir.You'll need to repeat these steps for every new PowerShell session you start. Azure oturum açma bilgilerinizin PowerShell oturumları arasında kalıcı hale getirilmesi için bkz. Kullanıcı kimlik bilgilerini PowerShell oturumları arasında kalıcı hale getirme.To learn how to persist your Azure sign in across PowerShell sessions, see Persist user credentials across PowerShell sessions.

Azure PowerShell modülünü güncelleştirmeUpdate the Azure PowerShell module

Bir PowerShell modülünü güncelleştirmek için modülü yüklerken kullandığınız yöntemi kullanmanız gerekir.To update any PowerShell module, you should use the same method used to install the module. Örneğin, ilk olarak Install-Module kullandıysanız en son sürümü edinmek için Update-Module kullanmanız gerekir.For example, if you originally used Install-Module, then you should use Update-Module to get the latest version. İlk olarak MSI paketini kullandıysanız yeni MSI paketini indirip yüklemeniz gerekir.If you originally used the MSI package then you should download and install the new MSI package.

PowerShellGet cmdlet’leri bir MSI paketinden yüklenen modülleri güncelleştiremez.The PowerShellGet cmdlets cannot update modules that were installed from an MSI package. MSI paketleri PowerShellGet kullanılarak yüklenen modülleri güncelleştirmez.MSI packages do not update modules that were installed using PowerShellGet. PowerShellGet kullanarak güncelleştirmeyle sorunlarıyla karşılaşıyorsanız güncelleştirmek yerine yeniden yüklemeniz gerekir.If you have any issues updating using PowershellGet, then you should reinstall , rather than update. Yeniden yükleme, yükleme ile aynı şekilde yapılır ancak -Force parametresini eklemeniz gerekir:Reinstalling is done the same way as installing, but you need to add the -Force parameter:

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (Get-Module -Name AzureRM -ListAvailable)) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Force
}

MSI tabanlı yüklemelerin aksine, PowerShellGet kullanarak yükleme veya güncelleştirme yapmanız, sisteminizde bulunan eski sürümleri kaldırmaz.Unlike MSI-based installations, installing or updating using PowerShellGet does not remove older versions that may exist on your system. Sisteminizdeki eski Azure PowerShell sürümlerini kaldırmak için bkz. Azure PowerShell modülünü kaldırma.To remove old versions of Azure PowerShell from your system, see Uninstall the Azure PowerShell module. MSI tabanlı yüklemeler hakkında daha fazla bilgi edinmek için bkz. MSI ile Azure PowerShell’i yükleme.For more information about MSI-based installations, see Install Azure PowerShell with an MSI.

Azure PowerShell'in birden çok sürümünü kullanmaUse multiple versions of Azure PowerShell

Azure PowerShell'in birden çok sürümünü yüklemek mümkündür.It's possible to install more than one version of Azure PowerShell. Birden fazla Azure PowerShell sürümünün yüklü olup olmadığını denetlemek için şu komutu kullanın:To check if you have multiple versions of Azure PowerShell installed, use the following command:

Get-InstalledModule -Name Az -AllVersions | Select-Object -Property Name, Version

Azure PowerShell'in bir sürümünü kaldırmak için bkz. Azure PowerShell modülünü kaldırma.To remove a version of Azure PowerShell, see Uninstall the Azure PowerShell module.

Modülün birden çok sürümünü yüklediyseniz, modül otomatik yükleme ve Import-Module tarafından varsayılan olarak en son sürüm yüklenir.If you have more than one version of the module installed, module autoload and Import-Module load the latest version by default.

-RequiredVersion parametresini kullanarak Az modülünün belirli bir sürümünü yükleyebilirsiniz:You can install or load a specific version of the Az module using the -RequiredVersion parameter:

# Install Az version 3.6.1
Install-Module -Name Az -RequiredVersion 3.6.1
# Load Az version 3.6.1
Import-Module -Name Az -RequiredVersion 3.6.1

PowerShellGet ile birden çok depo kullanmaUse multiple repositories with PowerShellGet

Repository parametresi, PowerShellGet öğesine sisteminizde ek depolar eklediyseniz gereklidir ve Az modülü bunlardan birden fazlasında bulunabilir.The Repository parameter is required if you have added additional repositories to PowerShellGet on your system and the Az module can be found in more than one of them.

if ($PSVersionTable.PSEdition -eq 'Desktop' -and (Get-Module -Name AzureRM -ListAvailable)) {
    Write-Warning -Message 'Az module not installed. Having both the AzureRM and Az modules installed at the same time is not supported.'
} else {
    Install-Module -Name Az -Repository PSGallery -AllowClobber -Force
}

Geri bildirimde bulunmaProvide feedback

Azure PowerShell’de bir hata bulursanız GitHub’da sorun bildirin.If you find a bug in Azure PowerShell, file an issue on GitHub. Komut satırından geri bildirim sağlamak için Send-Feedback cmdlet'ini kullanın.To provide feedback from the command line, use the Send-Feedback cmdlet.

Sonraki AdımlarNext Steps

Azure PowerShell modülleri ve bunların özellikleri hakkında daha fazla bilgi edinmek için bkz. Azure PowerShell’i Kullanmaya Başlama.To learn more about the Azure PowerShell modules and their features, see Get Started with Azure PowerShell. Azure PowerShell’i zaten biliyorsanız ve AzureRM’den geçiş yapmanız gerekiyorsa bkz. AzureRM’den Az’ye geçiş.If you're familiar with Azure PowerShell and need to migrate from AzureRM, see Migrate from AzureRM to Az.