Aracılığıyla paylaş

sqlps yardımcı programı

Şunlar için geçerlidir:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalitik Platform Sistemi (PDW)Microsoft Fabric'te SQL veritabanı

sqlps yardımcı programı, SQL Server PowerShell sağlayıcısı ve cmdlet'leri yüklenmiş ve kaydedilmiş bir Windows PowerShell oturumu başlatır. SQL Server örnekleri ve nesneleriyle çalışmak için SQL Server PowerShell bileşenlerini kullanan PowerShell komutlarını veya betiklerini girebilirsiniz.

Önemli

Bu özellik, SQL Server'ın gelecek bir sürümünde kaldırılacaktır. Bu özelliği yeni geliştirme çalışmalarında kullanmaktan kaçının ve şu anda bu özelliği kullanan uygulamaları değiştirmeyi planlayın. Bunun yerine sqlps PowerShell modülünü kullanın. sqlps modülü hakkında daha fazla bilgi için bkz. SQLPS Modülünü İçeri Aktarma.

Sözdizimi

sqlps
[ [ [ -NoLogo ] [ -NoExit ] [ -NoProfile ]
    [ -OutPutFormat { Text | XML } ] [ -InPutFormat { Text | XML } ]
  ]
  [ -Command { -
             | script_block [ -args argument_array ]
             | string [ command_parameters ]
             }
  ]
]
[ -? | -Help ]

Tartışmalar

sqlps yardımcı programının başladığında telif hakkı başlığını gizlediğini belirtir.

-NoExit

Başlangıç komutları tamamlandıktan sonra sqlps yardımcı programının çalışmaya devam ettiğini belirtir.

-NoProfile

sqlps yardımcı programının bir kullanıcı profili yüklemediğini belirtir. Kullanıcı profilleri, PowerShell oturumlarında kullanılmak üzere yaygın olarak kullanılan diğer adları, işlevleri ve değişkenleri kaydeder.

-OutPutFormat { Metin | XML }

sqlps yardımcı programı çıkışının metin dizeleri (Metin) veya serileştirilmiş CLIXML biçiminde (XML) olarak biçimlendirildiğini belirtir.

-InPutFormat { Metin | XML }

sqlps yardımcı programının girişinin metin dizeleri (Metin) veya serileştirilmiş CLIXML biçiminde (XML) olarak biçimlendirildiğini belirtir.

-Komut

sqlps yardımcı programının çalıştırılacak komutunu belirtir. sqlps yardımcı programı komutu çalıştırır ve sonra da belirtilmediği sürece -NoExit çıkar. sonrasında -Commandbaşka anahtar belirtmeyin. Komut parametresi olarak okunurlar.

-

-Command- sqlps yardımcı programının girişi standart girişten okuduğunu belirtir.

script_block [ -argsargument_array ]

Çalıştırılacak PowerShell komutlarının bloğunu belirtir, bloğun ayraç içine alınması gerekir: {}. Script_block yalnızca sqlps yardımcı programı PowerShell'den veya başka bir sqlps yardımcı programı oturumundan çağrıldığında belirtilebilir. argument_array, script_block PowerShell komutlarının bağımsız değişkenlerini içeren bir PowerShell değişkenleri dizisidir.

dize [ command_parameters ]

Çalıştırılacak PowerShell komutlarını içeren bir dize belirtir. "{<command>}" biçimini kullanın. Tırnak işaretleri bir dizeyi gösterir ve çağırma işleci (&), sqlps yardımcı programının komutunu (<command>) çalıştırmasına neden olur.

[ -? | -Yardım ]

sqlps yardımcı programı seçeneklerinin söz dizimi özetini gösterir.

Açıklamalar

sqlps yardımcı programı PowerShell ortamını (PowerShell.exe) başlatır ve SQL Server PowerShell modülünü yükler. sqlps olarak da adlandırılan modül, şu SQL Server PowerShell ek bileşenlerini yükler ve kaydeder:

  • Microsoft.SqlServer.Management.PSProvider.dll

    SQL Server PowerShell sağlayıcısını ve Encode-SqlName ve Decode-SqlName gibi ilişkili cmdlet'leri uygular.

  • Microsoft.SqlServer.Management.PSSnapin.dll

    Invoke-Sqlcmd ve Invoke-PolicyEvaluation cmdlet'lerini uygular.

Aşağıdaki görevleri gerçekleştirmek için sqlps yardımcı programını kullanabilirsiniz:

  • PowerShell komutlarını etkileşimli olarak çalıştırın.

  • PowerShell betik dosyalarını çalıştırın.

  • SQL Server cmdlet'lerini çalıştırın.

  • SQL Server nesnelerinin hiyerarşisinde gezinmek için SQL Server sağlayıcı yollarını kullanın.

Varsayılan olarak , sqlps yardımcı programı betik yürütme ilkesi Kısıtlı olarak ayarlanmış şekilde çalışır. Bu, PowerShell betiklerinin çalıştırılmasını engeller. Set-ExecutionPolicy cmdlet'ini kullanarak imzalı betikleri veya herhangi bir betik çalıştırmayı etkinleştirebilirsiniz. Yalnızca güvenilen kaynaklardan betikleri çalıştırın ve uygun NTFS izinlerini kullanarak tüm giriş ve çıkış dosyalarının güvenliğini sağlayın. PowerShell betiklerini etkinleştirme hakkında daha fazla bilgi için bkz. Windows PowerShell Betiklerini Çalıştırma.

SQL Server 2008 (10.0.x) ve SQL Server 2008 R2'deki (10.50.x) sqlps yardımcı programının sürümü, Windows PowerShell 1.0 mini kabuğu olarak uygulandı. Mini kabuklar, kullanıcıların mini kabuk tarafından yüklenen ek bileşenler dışındaki ek bileşenleri yüklemesine izin verme gibi belirli kısıtlamalara sahiptir. Bu kısıtlamalar, sqlps modülünü kullanacak şekilde değiştirilmiş olan yardımcı programın SQL Server 2012 (11.x) ve sonraki sürümleri için geçerli değildir.

Örnekler

sqlps -NoLogo

B. Komut isteminden bir SQL Server PowerShell betiği çalıştırma

sqlps -Command "&{.\MyFolder.MyScript.ps1}"

C. Komut isteminden bir SQL Server PowerShell betiği çalıştırın ve betik tamamlandıktan sonra çalışmaya devam edin

sqlps -NoExit -Command "&{.\MyFolder.MyScript.ps1}"

İlgili içerik

  • Last updated on