Aracılığıyla paylaş

Azure Data Studio için PowerShell Düzenleyicisi Desteği

Önemli

28 Şubat 2026 tarihinde Azure Data Studio kullanımdan kaldırılıyor. Visual Studio Codekullanmanızı öneririz. Visual Studio Code'a geçiş hakkında daha fazla bilgi için Azure Data Studio'ya neler oluyor? adresini ziyaret edin.

Bu uzantı, Azure Data Studio'da zengin PowerShell düzenleyicisi desteği sağlar. Artık Azure Data Studio tarafından sunulan IDE benzeri mükemmel arabirimi kullanarak PowerShell betikleri yazabilir ve hatalarını ayıklayabilirsiniz.

PowerShell uzantısı

Özellikler

  • Sözdizimi vurgulama
  • Kod parçacıkları
  • IntelliSense, cmdlet'ler ve daha fazlası için
  • PowerShell Betik Çözümleyicisi tarafından sağlanan kural tabanlı analiz
  • Cmdlet'lerin ve değişkenlerin tanımına gidin
  • Cmdlet'lerin ve değişkenlerin Başvurularını Bulma
  • Belge ve çalışma alanı simgesi bulma
  • F8 kullanarak seçili PowerShell kodu seçimini çalıştırma
  • Ctrl+ tuş kombinasyonunu kullanarak imlecin altındaki sembol için çevrimiçi yardımı başlatın.
  • Temel etkileşimli konsol desteği!

Uzantıyı Yükleme

Azure Data Studio belgelerindeki adımları izleyerek PowerShell uzantısının resmi sürümünü yükleyebilirsiniz. Uzantılar bölmesinde "PowerShell" uzantısını arayın ve buraya yükleyin. Gelecekteki uzantı güncelleştirmeleri hakkında otomatik olarak bilgilendirilirsiniz!

Ayrıca Yayınlar sayfamızdan bir VSIX paketi yükleyebilir ve komut satırı aracılığıyla yükleyebilirsiniz:

azuredatastudio --install-extension PowerShell-<version>.vsix

Platform desteği

  • Windows 7'den Windows 10'a kadar ve Windows PowerShell v3 ve üzeri ile PowerShell Core
  • PowerShell Core ile Linux (PowerShell tarafından desteklenen tüm dağıtımlar)
  • PowerShell Core ile macOS

Sık sorulan soruların yanıtları için SSS bölümünü okuyun.

PowerShell Core'u yükleme

MacOS veya Linux üzerinde Azure Data Studio çalıştırıyorsanız PowerShell Core'u da yüklemeniz gerekebilir.

PowerShell Core, GitHub'da bir Açık Kaynak projesidir. PowerShell Core'u macOS veya Linux platformlarına yükleme hakkında daha fazla bilgi için aşağıdaki makalelere bakın:

Örnek Betikler

Uzantının examples klasöründe PowerShell düzenleme ve hata ayıklama işlevlerini keşfetmek için kullanabileceğiniz bazı örnek betikler vardır. Bunların nasıl kullanılacağı hakkında daha fazla bilgi edinmek için eklenen README.md dosyasına göz atın.

Bu klasör aşağıdaki yolda bulunabilir:

$HOME/.azuredatastudio/extensions/microsoft.powershell-<version>/examples

veya uzantının önizleme sürümünü kullanıyorsanız

$HOME/.azuredatastudio/extensions/microsoft.powershell-preview-<version>/examples

Uzantının örneklerini Azure Data Studio'da açmak/görüntülemek için PowerShell komut isteminizden aşağıdaki kodu çalıştırın:

azuredatastudio (Get-ChildItem $Home\.azuredatastudio\extensions\microsoft.powershell-*\examples)[-1]

Dosya oluşturma ve açma

Düzenleyicide yeni bir dosya oluşturmak ve açmak için PowerShell Tümleşik Terminali'nin içinden New-EditorFile dosyasını kullanın.

PS C:\temp> New-EditorFile ExportData.ps1

Bu komut yalnızca PowerShell dosyaları için değil, herhangi bir dosya türünde çalışır.

PS C:\temp> New-EditorFile ImportData.py

Azure Data Studio'da bir veya daha fazla dosya açmak için komutunu kullanın Open-EditorFile .

Open-EditorFile ExportData.ps1, ImportData.py

Yürütme sırasında konsola odaklanma yok

SSMS ile çalışmaya alışkın olan kullanıcılar için bir sorguyu yürütmeye ve ardından sorgu bölmesine geri dönmek zorunda kalmadan yeniden yürütmeye alışmış olursunuz. Bu durumda, kod düzenleyicisinin varsayılan davranışı size garip gelebilir. F8 ile yürütürken odağı düzenleyicide tutmak için aşağıdaki ayarı değiştirin:

"powershell.integratedConsole.focusConsoleOnExecute": false

Varsayılan, erişilebilirlik amacıyla kullanılır true .

Bu ayarın, gibi Get-Credentialaçıkça giriş çağrısında bulunan bir komut kullandığınızda bile odağın konsola geçmesini önlediğini unutmayın.

SQL PowerShell Örnekleri

Bu örnekleri (aşağıda) kullanmak için sqlserver modülünü PowerShell Galerisi yüklemeniz gerekir.

Install-Module -Name SqlServer

Not

Sürüm 21.1.18102 ve üstü ile SqlServer modül, Windows PowerShell'e ek olarak PowerShell Core 6.2 ve üstü sürümleri destekler.

Bu örnekte, ServerA ve ServerB için sunucu SMO nesnelerini almak üzere Get-SqlInstance cmdlet'i kullanırız. Bu komutun varsayılan çıktısı, örneklerin adı, sürümü, Hizmet Paketi ve CU Güncelleştirme Düzeyi'ni içerir.

Get-SqlInstance -ServerInstance ServerA, ServerB

Bu çıktının nasıl görüneceğine dair bir örnek aşağıda verilmiştir:

Instance Name             Version    ProductLevel UpdateLevel  HostPlatform HostDistribution
-------------             -------    ------------ -----------  ------------ ----------------
ServerA                   13.0.5233  SP2          CU4          Windows      Windows Server 2016 Datacenter
ServerB                   14.0.3045  RTM          CU12         Linux        Ubuntu

Modül, SqlServer aşağıdaki kaydedilmiş SQL Server bağlantısı türlerine programlı olarak erişmenizi sağlayan adlı SQLRegistration bir Sağlayıcı içerir:

  • Veritabanı Altyapısı Sunucusu (Kayıtlı Sunucular)
  • Merkezi Yönetim Sunucusu (CMS)
  • Analiz Hizmetleri
  • Tümleştirme Hizmetleri
  • Raporlama Hizmetleri

Aşağıdaki örnekte, Kayıtlı Sunucular dosyanızda listelenen tüm SQL Server örneklerinin listesini almak için bir dir (diğer adıyla Get-ChildItem) yapacağız.

dir 'SQLSERVER:\SQLRegistration\Database Engine Server Group' -Recurse

Bu çıkışın nasıl görünebileceğine dair bir örnek aşağıda verilmiştir:

Mode Name
---- ----
-    ServerA
-    ServerB
-    localhost\SQL2017
-    localhost\SQL2016Happy
-    localhost\SQL2017

Bir veritabanını veya veritabanındaki nesneleri içeren birçok işlem için Get-SqlDatabase cmdlet kullanılabilir. hem -ServerInstance hem de -Database parametreleri için değerler sağlarsanız, yalnızca bu veritabanı nesnesi alınır. Ancak, yalnızca parametresini -ServerInstance belirtirseniz, bu örnekteki tüm veritabanlarının tam listesi döndürülür.

Bu çıktının nasıl görüneceğine dair bir örnek aşağıda verilmiştir:

Name                 Status           Size     Space  Recovery Compat. Owner
                                            Available  Model     Level
----                 ------           ---- ---------- -------- ------- -----
AdventureWorks2017   Normal      336.00 MB   57.01 MB Simple       140 sa
master               Normal        6.00 MB  368.00 KB Simple       140 sa
model                Normal       16.00 MB    5.53 MB Full         140 sa
msdb                 Normal       48.44 MB    1.70 MB Simple       140 sa
PBIRS                Normal      144.00 MB   55.95 MB Full         140 sa
PBIRSTempDB          Normal       16.00 MB    4.20 MB Simple       140 sa
SSISDB               Normal      325.06 MB   26.21 MB Full         140 sa
tempdb               Normal       72.00 MB   61.25 MB Simple       140 sa
WideWorldImporters   Normal         3.2 GB     2.6 GB Simple       130 sa

Bu sonraki örnek, ServerB örneğindeki tüm veritabanlarının Get-SqlDatabase listesini almak için cmdlet'ini kullanır, ardından yedeklenecek veritabanlarını Out-GridView seçmek için bir kılavuz/tablo (cmdlet'i kullanarak) sunar. Kullanıcı "Tamam" düğmesine tıkladıktan sonra yalnızca vurgulanan veritabanları yedeklenir.

Get-SqlDatabase -ServerInstance ServerB |
Out-GridView -PassThru |
Backup-SqlDatabase -CompressionOption On

Bu örnek, Kayıtlı Sunucular dosyanızda listelenen tüm SQL Server örneklerinin listesini alır; ardından listelenen her SQL Server örneği için gece yarısından bu yana başarısız olan her SQL Aracısı İşini raporlayan Get-SqlAgentJobHistory fonksiyonunu çağırır.

dir 'SQLSERVER:\SQLRegistration\Database Engine Server Group' -Recurse |
WHERE {$_.Mode -ne 'd' } |
FOREACH {
    Get-SqlAgentJobHistory -ServerInstance  $_.Name -Since Midnight -OutcomesType Failed
}

Bu örnekte, Kayıtlı Sunucular dosyanızda listelenen tüm SQL Server örneklerinin listesini almak için bir dir (yani Get-ChildItem için takma ad) kullanacağız ve ardından bu örneklerin her biri için veritabanlarının listesini almak amacıyla Get-SqlDatabase cmdlet'ini kullanacağız.

dir 'SQLSERVER:\SQLRegistration\Database Engine Server Group' -Recurse |
WHERE { $_.Mode -ne 'd' } |
FOREACH {
    Get-SqlDatabase -ServerInstance $_.Name
}

Bu çıktının nasıl görüneceğine dair bir örnek aşağıda verilmiştir:

Name                 Status           Size  Space     Recovery Compat. Owner
                                            Available Model    Level
----                 ------           ---- ---------- -------- ------- -----
AdventureWorks2017   Normal      336.00 MB   57.01 MB Simple       140 sa
master               Normal        6.00 MB  368.00 KB Simple       140 sa
model                Normal       16.00 MB    5.53 MB Full         140 sa
msdb                 Normal       48.44 MB    1.70 MB Simple       140 sa
PBIRS                Normal      144.00 MB   55.95 MB Full         140 sa
PBIRSTempDB          Normal       16.00 MB    4.20 MB Simple       140 sa
SSISDB               Normal      325.06 MB   26.21 MB Full         140 sa
tempdb               Normal       72.00 MB   61.25 MB Simple       140 sa
WideWorldImporters   Normal         3.2 GB     2.6 GB Simple       130 sa

Sorunları Bildirme

PowerShell Uzantısı ile ilgili herhangi bir sorunla karşılaşırsanız sorunları tanılama ve raporlama hakkında bilgi için sorun giderme belgelerine bakın.

Güvenlik Notu

Güvenlik sorunları için buraya bakın.

Koda Katkıda Bulunma

Bu uzantıya nasıl katkıda bulunabileceğiniz hakkında daha fazla bilgi için geliştirme belgelerine göz atın!

Bakımcılar

Lisans

Bu uzantı MIT Lisansı kapsamında lisanslanır. Bu projenin sürümlerine dahil ettiğimiz üçüncü taraf ikili dosyaları hakkında ayrıntılı bilgi için üçüncü taraf bildirimler dosyasına bakın.

Kullanım Kuralları

Bu projede Microsoft Açık Kaynak Kullanım Şartları kabul edilmiştir. Daha fazla bilgi için Code of Conduct FAQ (Kullanım Kuralları Hakkında SSS) konusuna bakın veya sorularınızı ya da görüşlerinizi bildirmek için opencode@microsoft.com adresinden bize ulaşın.