Aracılığıyla paylaş

Az PowerShell modülü sorunlarını giderme

Hata ayıklama kaydını etkinleştir.

Az PowerShell modülüyle ilgili bir sorunu gidermek için izlemeniz gereken ilk adımlardan biri hata ayıklama günlüğünü etkinleştirmektir.

Hata ayıklama günlüğünü komut başına etkinleştirmek için Debug parametresini belirtin.

Get-AzResource -Name 'DoesNotExist' -Debug

PowerShell oturumunun tamamında hata ayıklama günlüğünü etkinleştirmek için DebugPreference değişkeninin değerini Continueolarak ayarlarsınız.

$DebugPreference = 'Continue'

Otomasyon senaryolarında duyuru iletileri

Azure PowerShell ile Azure'a bağlanırken, döndürülen nesne tabanlı çıkışı değiştirmelerini önlemek için PowerShell'in bilgi akışı kullanılarak duyuru iletileri görüntülenir. Duyuru iletilerinin deneyiminizi etkilememesi için elimizden gelen çabayı göstermiş olsak da, bunların kullanımı etkileyebilecekleri bazı otomasyon senaryoları vardır. Sorunlarla karşılaşırsanız, bu senaryolarda bilgi akışını gizlemenizi öneririz:

Connect-AzAccount -Subscription '<subscription name or id>' -InformationAction Ignore

Web Hesabı Yöneticisi (WAM)

  • Etkileşimli oturum açma yöntemi WAM için bir pencere açamıyor ve şu hatayı döndürür: Kullanıcı kimlik doğrulamasını iptal etti.
  • Azure PowerShell cmdlet'leri kullanıcı adı ve parola veya cihaz koduyla oturum açtıktan sonra çalıştırılamaz.
  • WAM açılır penceresinde İş ve Okul Hesabı seçeneği görüntülenmez.
  • Etkileşimli oturum açma yöntemi, Windows PowerShell ISE konsolunda BIR WAM penceresi açamaz.

Bu sorunların geçici çözümü WAM'yi devre dışı bırakmaktır:

Update-AzConfig -EnableLoginByWam $false
  • Hesap seçmek için WAM açılır penceresini bulmak kolay değildir. Açılır pencereyi bulmak için diğer pencereleri küçültün.

Kurulum

Bu bölüm, Az PowerShell modülünü yüklerken karşılaşılan yaygın sorunların çözümlerinin listesini içerir.

Az ve AzureRM'in bir arada bulunması

Uyarı

Hem AzureRM hem de Az PowerShell modüllerinin Windows PowerShell 5.1'de aynı anda yüklenmesini desteklemiyoruz.

Hem AzureRM hem de Az PowerShell modülünü aynı Windows sistemine yüklemeniz gereken bir senaryoda:

  • AzureRM yalnızca Windows PowerShell 5.1'in geçerli kullanıcı kapsamında yüklenmelidir.
  • Az PowerShell modülünü PowerShell 7.2 veya sonraki bir sürüme yükleyin.

Uyarı

AzureRM PowerShell modülü 29 Şubat 2024 itibarıyla resmi olarak kullanım dışı bırakılmıştır. Kullanıcıların destek ve güncelleştirmelerin devam etmesini sağlamak için AzureRM'den Az PowerShell modülüne geçmeleri tavsiye edilir.

AzureRM modülü çalışmaya devam edebilir, ancak artık bakım yapılmaz veya desteklenmez ve kullanıcının takdirine ve riskine bağlı olarak sürekli kullanım sağlanır. Az modülüne geçiş konusunda yönergeler için lütfen geçiş kaynaklarımıza bakın.

Visual Studio

Visual Studio'nun eski sürümleri, AzureRM modülünü yükleyen Azure geliştirme iş yükünün bir parçası olarak Azure PowerShell'i yükleyebilir. Azure PowerShell, Visual Studio yükleyicisi kullanılarak veya Uygulamalar & özelliklerinde "Kaldır" kullanılarak kaldırılabilir. PowerShell 7.x'i zaten yüklediyseniz Az PowerShell modülünü el ile yüklemeniz gerekebilir.

Proxy bağlantıyı engelliyor

PowerShell Galerisine bağlanılamıyor şeklinde bir hata Install-Module alırsanız, bir proxy'nin arkasında olabilirsiniz. Farklı işletim sistemlerinin ve ağ ortamlarının sistem genelinde ara sunucu yapılandırmaya ilişkin gereksinimleri farklıdır. Ara sunucu ayarlarınız ve ortamınızda bunları nasıl yapılandıracağınız konusunda sistem yöneticinize danışın.

PowerShell kendisi, bu proxyyi otomatik olarak kullanacak şekilde yapılandırılmamış olabilir. PowerShell 5.1 ve üzeri sürümlerde, aşağıdaki komutları kullanarak PowerShell oturumunu ara sunucu kullanacak şekilde yapılandırın:

$webClient = New-Object -TypeName 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. Bu ayarın oturumlar arasında kalıcı olmasını sağlamak için, komutu PowerShell profilinize ekleyin.

Paketi yüklemek için proxy'nizin www.powershellgallery.comHTTPS bağlantılarına izin vermesi gerekir.

Nesne referansı, bir nesne örneğine ayarlanmadı

"Nesne başvurusu bir nesnenin örneğine ayarlanmadı" iletisi, null olan bir nesneye ya da var olmayan veya erişim izniniz olmayan bir Azure kaynağına başvurduğunuz anlamına gelir.

$resourceId =  '/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/<resource-group-name>/providers/Microsoft.Web/sites/<webapp-name>/privateEndpointConnections/<endpoint-name>'
Get-AzPrivateEndpointConnection -ResourceId $resourceId

Get-AzPrivateEndpointConnection: Object reference not set to an instance of an object.

Belirtilen Azure kaynağının mevcut olduğunu doğrulamak için Get-AzResource cmdlet'ini kullanabilirsiniz.

Get-AzResource -ResourceId $resourceId

AzAD cmdlet'leriyle ilgili izin sorunları

Az PowerShell modülü Microsoft Graph API'sini kullanır. Az PowerShell modülüyle Azure'da kaynakları yönetmek veya idare etmek için Azure portalından veya diğer Azure komut satırı araçlarından aynı görevi gerçekleştirmek için aynı izinler gerekir. İzinler hakkında belirli sorular için Microsoft Graph izinler referansı bölümüne bakın.

Microsoft Graph sorgu parametreleri

Az.Resources altındaki AzAd cmdlet'leri artık sorgu parametrelerini ve arama sorgusu parametrelerinidestekliyor. Söz dizimi hakkında ayrıntılı bilgi için daha önce başvurulan bağlantılara bakın.

Get-AzAdGroupMember hizmet sorumlularını döndürmüyor

Geçerli Graph API'deki sınırlamalar nedeniyle, Az 7.x'de Get-AzAdGroupMember ile hizmet ilkeleri döndürülmüyor. Geçici bir çözüm olarak Invoke-AzRestMethod Microsoft Graph API'sinin beta sürümüyle kullanılabilir.

Aşağıdaki örnekte Az PowerShell modülü gereklidir. İlk satırdaki myGroupName ifadesini grubunuzun adıyla değiştirin.

$Group = Get-AzADGroup -DisplayName myGroupName
((Invoke-AzRestMethod -Uri "https://graph.microsoft.com/beta/groups/$($Group.id)/members").Content |
  ConvertFrom-Json).value |
  Select-Object -Property DisplayName, Id, @{label='OdataType';expression={$_.'@odata.type'}}

Komut bulundu ancak yüklenemedi

Az PowerShell komutlarından herhangi birini çalıştırmaya çalıştığınızda PowerShell tarafından aşağıdaki ileti döndürülür.

Connect-AzAccount: The 'Connect-AzAccount' command was found in the module 'Az.Accounts', but the module could not be loaded. For more information, run 'Import-Module Az.Accounts'.

Bu ileti, aynı Windows tabanlı sistemde hem Az hem de AzureRM PowerShell modülleri yüklü olduğunda ve aynı PowerShell sürümü için $env:PSModulePath'te mevcut olduğunda oluşur.

Önemli

AzureRM, Windows PowerShell'in AllUsers kapsamına yüklendiğinde, PowerShell 7 için $env:PSModulePath parçası olan bir konuma yüklenir. AzureRM ile Az PowerShell modülleri arasındaki çakışmalar nedeniyle bu desteklenmez.

Hem Az hem de AzureRM aynı Windows sisteminde birlikte bulunabilir, ancak yalnızca AzureRM, Windows PowerShell çerçevesinde CurrentUser yüklüyse ve Az, PowerShell 7'de yüklüyse. Daha fazla bilgi için bkz. Az PowerShell modülünü yükleme.

Uyarı

AzureRM PowerShell modülü 29 Şubat 2024 itibarıyla resmi olarak kullanım dışı bırakılmıştır. Kullanıcıların destek ve güncelleştirmelerin devam etmesini sağlamak için AzureRM'den Az PowerShell modülüne geçmeleri tavsiye edilir.

AzureRM modülü çalışmaya devam edebilir, ancak artık bakım yapılmaz veya desteklenmez ve kullanıcının takdirine ve riskine bağlı olarak sürekli kullanım sağlanır. Az modülüne geçiş konusunda yönergeler için lütfen geçiş kaynaklarımıza bakın.

MacOS'ta KeyChain yetkilendirmesi başarısız olduğunda hata döndürülüyor

MacOS'ta Azure PowerShell'i çalıştırırken Bir PowerShell oturumundan Azure hesabınızda oturum açmaya çalışırken bir hata iletisiyle karşılaşabilirsiniz.

DeviceCodeCredential authentication failed: Persistence check failed. Reason: KeyChain authorization/authentication failed. .Error code: -25293. OS error code -25293.

Bu soruna geçici bir çözüm olarak, aşağıdaki komutu çalıştırarak oturumlar arasında kimlik bilgilerinin depolanmasını devre dışı bırakabilirsiniz. Ancak bu değişikliği yaptıktan sonra, her yeni PowerShell oturumu başlattığınızda Connect-AzAccount çalıştırmanız gerekir.

Disable-AzContextAutosave

Bu sitenin bağlantısı güvenli değil

Varsayılan tarayıcınız Microsoft Edge olduğunda, Azure'da Connect-AzAccountile etkileşimli olarak oturum açmayı denerken şu hatayla karşılaşabilirsiniz: "Bu sitenin bağlantısı güvenli değil." Bu sorunu çözmek için Microsoft Edge'de edge://net-internals/#hsts adresini ziyaret edin. "localhost sil" altına ekleyin ve Sil'e tıklayın.

Hizmet Asıl Kimliği Tanımlayıcı Uri'si doğrulanmış etki alanı hatası

Hata: görüntülenir.

Microsoft Entra'daki, tek kiracılı uygulamalarda AppId Uri'nin varsayılan şema veya doğrulanmış etki alanlarının kullanılmasını gerektiren önemli değişiklik nedeniyle, Az.Resources modülünü sürüm 4.1.0 veya sonraki bir sürüme yükseltmeniz gerekir, böylece veya New-AzADServicePrincipal cmdlet'lerini kullanmaya devam edebilirsiniz.

Ayrıca Az PowerShell modülünün 6.0 veya üzeri bir sürümüne de yükseltebilirsiniz.

Zaman Çizelgesi

Bu gereksinim 15 Ekim 2021'de yürürlüğe girdi.

Etkilenen sürümler

Azure PowerShell'in aşağıdaki sürümleri AzureAD hataya neden olan değişiklikten etkilenir:

  • Az.Resources PowerShell modülü sürüm 3.5.1-preview veya üzeri.
  • Az PowerShell modülü sürüm 5.9.0 veya daha eski.

Yükseltmeden sonra hala sorunlarla karşılaşıyorsanız, bir sorun açmaktan çekinmeyin.

Geçici çözüm

Daha önce açıklanan PowerShell modüllerine yükseltemiyorsanız, hizmet sorumlusu oluştururken şu adımları izleyebilirsiniz:

Diğer sorunlar

Azure PowerShell'de bu makalede listelenmeyen bir ürün sorunuyla karşılaşıyorsanız veya daha fazla yardım gerekiyorsa GitHub'da bir sorun oluşturun.