Az PowerShell modülü sorunlarını giderme

  • Makale

Hata ayıklama günlüğüne kaydetmeyi etkinleştirme

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

Komut başına hata ayıklama günlüğünü 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 olarak Continueayarlarsınız.

$DebugPreference = 'Continue'

Yükleme

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

Az ve AzureRM birlikte bulunma

Uyarı

Windows’da yüklü AzureRM ve Az PowerShell modüllerinin 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 ve özellikler'de "Kaldır" kullanılarak kaldırılabilir. PowerShell 7.x'i zaten yüklediyseniz Az PowerShell modülünü el ile yüklemeniz gerekebilir.

Ara sunucu blokları bağlantısı

PowerShell Galerisi ulaşılamıyor hatası Install-Module alırsanız, bir ara sunucu 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'in kendisi otomatik olarak bu ara sunucuyu kullanacak şekilde yapılandırılamaz. Aşağıdaki komutları kullanarak PowerShell 5.1 ve sonraki sürümlerinde PowerShell oturumunu bir 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.com HTTPS bağlantılarına izin vermesi gerekir.

Nesne başvurusu bir nesnenin ö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 Get-AzResource mevcut olduğunu doğrulamak için 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önetici veya yönetmek için Azure portalından veya başka bir Azure komut satırı aracından aynı görevi gerçekleştirmek için aynı izinler gerekir. İzinler hakkında belirli sorular için bkz . Microsoft Graph izin başvurusu.

Microsoft Graph sorgu parametreleri

Az.Resources altındaki AzAd cmdlet'leri artık sorgu parametrelerini ve arama sorgusu parametrelerini destekliyor. 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'siyle ilgili sınırlamalar nedeniyle hizmet sorumluları Az 7.x içindeki Get-AzAdGroupMember tarafından 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. öğesini ilk satırda grubunuzun adıyla değiştirin myGroupName .

$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 kapsamında yüklendiğinde AllUsers , PowerShell 7'nin parçası $env:PSModulePath olan bir konuma yüklenir. AzureRM ve 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, PowerShell 7'de CurrentUser Yüklü Windows PowerShell ve Az kapsamında 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, oturumlar arasında kimlik bilgilerinin depolanmasını devre dışı bırakmak için aşağıdaki komutu çalıştırabilirsiniz. Ancak bu değişikliği yaptıktan sonra, her yeni PowerShell oturumu başlattığınızda çalıştırmanız Connect-AzAccount gerekir.

Disable-AzContextAutosave

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

Varsayılan tarayıcınız Microsoft Edge olduğunda, Azure'da etkileşimli olarak oturum açmayı denerken şu hatayla Connect-AzAccountkarşı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. "Etki alanı güvenlik ilkesini sil" altına ekleyin localhost ve Sil'e tıklayın.

Hizmet Sorumlusu IdentifierUri doğrulanmış etki alanı hatası

Hata: identifierUris özelliğinin değerleri kuruluşun doğrulanmış bir etki alanını kullanmalıdır veya veya New-AzADApplicationçalıştırılırken New-AzADServicePrincipal alt etki alanı görüntülenir.

Tek kiracılı uygulamalarda AppId Uri'sinin varsayılan şemanın veya doğrulanmış etki alanlarının kullanılmasını gerektiren Microsoft Entra hataya neden olan değişiklik nedeniyle, veya cmdlet'leri kullanmaya New-AzADServicePrincipal devam etmek için Az.Resources modülünü 4.1.0 veya New-AzADApplication sonraki bir sürüme yükseltmeniz gerekir.

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

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.