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

Bu makalede, PowerShellGet kullanarak Azure PowerShell modüllerini nasıl yükleyeceğiniz anlatılır.This article tells you 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. Az modülü için şu anda başka desteklenen yükleme metodu yoktur.For the Az module, currently no other installation methods are supported.

GereksinimlerRequirements

Azure PowerShell, Windows’da PowerShell 5.1 veya sonraki sürümleriyle veya tüm platformlarda PowerShell 6.x ve sonraki sürümleriyle çalışır.Azure PowerShell works with PowerShell 5.1 or higher on Windows, or PowerShell Core 6.x and later on all platforms. PowerShell'iniz olup olmadığından veya macOS mu yoksa Linux mı kullandığınızdan emin değilseniz, PowerShell Core'un en son sürümünü yükleyin.If you aren't sure if you have PowerShell, or are on macOS or Linux, install the latest version of 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

Azure PowerShell'i Windows üzerinde PowerShell 5.1'de çalıştırmak için:To run 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.

PowerShell Core kullanıldığında, Azure PowerShell için ek gereksinimler yoktur.There are no additional requirements for Azure PowerShell when using PowerShell Core.

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

Uyarı

Windows için PowerShell 5.1'de aynı anda hem AzureRM hem de Az modülünü yükleyemezsiniz.You can't have both the AzureRM and Az modules installed for PowerShell 5.1 for Windows at the same time. Sisteminizde AzureRM'yi kullanılabilir durumda tutmanız gerekiyorsa, PowerShell Core 6.x 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 Core 6.x or later. Bunu yapmak için PowerShell Core 6.x veya sonraki sürümünü yükleyin ve ardından PowerShell Core terminalinde bu yönergeleri izleyin.To do this, install PowerShell Core 6.x or later and then follow these instructions in a PowerShell Core terminal.

Önerilen yükleme yöntemi, yalnızca etkin kullanıcı için yüklemeye yöneliktir:The recommended install method is to only install for the active user:

Install-Module -Name Az -AllowClobber -Scope CurrentUser

Sistemdeki tüm kullanıcılar için yüklemek istiyorsanız yönetici ayrıcalıkları gerekir.If you want to install for all users on a system, this requires administrator privileges. Yükseltilmiş bir PowerShell oturumundan, yönetici olarak veya MacOS ya da Linux’taki sudo komutuyla çalıştırın:From an elevated PowerShell session either run as administrator or with the sudo command on macOS or Linux:

Install-Module -Name Az -AllowClobber -Scope AllUsers

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.

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. Bu modülü yüklediğinizde kullanılabilir durumdaki tüm Azure Resource Manager modülleri indirilir ve cmdlet'leri kullanıma sunulur.Installing it downloads all of the available Azure Resource Manager 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 başka bir konuma indirin ve bu konumu ağınızda yükleme kaynağı olarak kullanın.Download the modules to another location and use that as an installation source on your network. Bu karmaşık bir işlem olabilir ama PowerShell modüllerini PowerShellGet ile bağlantısız sistemlere dağıtmak üzere tek sunucu veya dosya paylaşımında önbelleğe almanızı sağlar.This can be a complicated process, but will let you 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 '\\someshare\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, please 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. Sistem genelinde ara sunucu yapılandırma konusunda farklı işletim sistemlerinin farklı gereksinimleri olacaktır ve burada bunlar ayrıntılı olarak ele alınmamıştır.Different operating systems will have different requirements for configuring a system-wide proxy, which are not covered in detail here. Ara sunucu ayarlarınız ve işletim sisteminiz için 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 OS.

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. PowerShell 5.1 ve sonraki sürümleriyle, aşağıdaki komutu kullanarak PowerShell oturumunda kullanılacak ara sunucuyu yapılandırın:With PowerShell 5.1 and later, configure the proxy to use for a PowerShell session with the following command:

(New-Object System.Net.WebClient).Proxy.Credentials = `
  [System.Net.CredentialCache]::DefaultNetworkCredentials

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

Paketi yüklemek için ara sunucunuzun şu adrese yönelik HTTPS bağlantılarına izin vermesi gerekir:In order 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 Az kullanarak modülü el ile içeri aktarın.If you've disabled module autoloading, manually import the module with Import-Module 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 geçiş yaparken silinmemesi için bkz. Kullanıcı kimlik bilgilerini PowerShell oturumları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

Az modülünün paketlenme şeklinden dolayı, Update-Module komutu yüklemenizi doğru güncelleştirmeyecektir.Because of how the Az module is packaged, the Update-Module command won't update your installation correctly. Az modülünü yüklediğinizde aslında her hizmet için cmdlet’leri sağlayan tüm bağımlı alt modüllerini toplar ve yükler.When you install the Az module, it actually collects and installs all of its dependent submodules, and which provide the cmdlets for each service. Başka bir deyişle, Azure PowerShell modülünü güncelleştirmek için yalnızca güncelleştirmek yerine yeniden yüklemeniz gerekir.That means that to update the Azure PowerShell module, you will need to reinstall, rather than just update. Bu işlem yüklemeyle aynı şekilde yapılır ama -Force bağımsız değişkenini eklemeniz gerekebilir:This is done in the same way as installing, but you may need to add the -Force argument:

Install-Module -Name Az -AllowClobber -Force

Bu yüklü modüllerin üzerine yazabilse de, sisteminizde yine de eski sürümler kalabilir.Although this can overwrite installed modules, you may still have older versions left on your system. Sisteminizdeki eski Azure PowerShell sürümlerini nasıl kaldıracağınızı öğrenmek için bkz. Azure PowerShell modülünü kaldırma.To learn how to remove old versions of Azure PowerShell from your system, see Uninstall the Azure PowerShell module.

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

-RequiredVersion bağımsız değişkenini 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 by using the -RequiredVersion argument:

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

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.

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.