Utilitas sqlps

Artikel
01/10/2024

Berlaku untuk: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Utilitas sqlps memulai sesi Windows PowerShell dengan penyedia dan cmdlet PowerShell SQL Server yang dimuat dan didaftarkan. Anda dapat memasukkan perintah atau skrip PowerShell yang menggunakan komponen PowerShell SQL Server untuk bekerja dengan instans SQL Server dan objeknya.

Penting

Fitur ini akan dihapus dalam versi SQL Server yang akan datang. Hindari menggunakan fitur ini dalam pekerjaan pengembangan baru, dan rencanakan untuk memodifikasi aplikasi yang saat ini menggunakan fitur ini. Gunakan modul PowerShell sqlps sebagai gantinya. Untuk informasi selengkapnya tentang modul sqlps , lihat Mengimpor Modul SQLPS.

Sintaks

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

Argumen

-NoLogo
Menentukan bahwa utilitas sqlps menyembunyikan spanduk hak cipta saat dimulai.

-NoExit
Menentukan bahwa utilitas sqlps terus berjalan setelah perintah startup selesai.

-NoProfile
Menentukan bahwa utilitas sqlps tidak memuat profil pengguna. Profil pengguna merekam alias, fungsi, dan variabel yang umum digunakan untuk digunakan di seluruh sesi PowerShell.

-OutPutFormat { Text | XML }
Menentukan bahwa output utilitas sqlps diformat sebagai string teks (Teks) atau dalam format CLIXML (XML) berseri.

-InPutFormat { Text | XML }
Menentukan bahwa input ke utilitas sqlps diformat sebagai string teks (Teks) atau dalam format CLIXML (XML) berseri.

-Perintah
Menentukan perintah untuk utilitas sqlps yang akan dijalankan. Utilitas sqlps menjalankan perintah dan kemudian keluar, kecuali -NoExit juga ditentukan. Jangan tentukan sakelar lain setelah -Command, sakelar tersebut akan dibaca sebagai parameter perintah.

-
-Command- menentukan bahwa utilitas sqlps membaca input dari input standar.

script_block [ -argsargument_array ]
Menentukan blok perintah PowerShell untuk dijalankan, blok harus diapit kurung kurawal: {}. Script_block hanya dapat ditentukan ketika utilitas sqlps dipanggil dari PowerShell atau sesi utilitas sqlps lainnya. argument_array adalah array variabel PowerShell yang berisi argumen untuk perintah PowerShell di script_block.

string [ command_parameters ]
Menentukan string yang berisi perintah PowerShell yang akan dijalankan. Gunakan format "&{command}". Tanda kutip menunjukkan string, dan operator pemanggilan (&) menyebabkan utilitas sqlps menjalankan perintah.

Apa yang terjadi denganmu ? | -Bantuan ]
Memperlihatkan ringkasan sintaks opsi utilitas sqlps .

Keterangan

Utilitas sqlps memulai lingkungan PowerShell (PowerShell.exe) dan memuat modul PowerShell SQL Server. Modul ini, juga bernama sqlps, memuat dan mendaftarkan snap-in PowerShell SQL Server ini:

Microsoft.SqlServer.Management.PSProvider.dll

Menerapkan penyedia PowerShell SQL Server dan cmdlet terkait seperti Encode-SqlName dan Decode-SqlName.
Microsoft.SqlServer.Management.PSSnapin.dll

Menerapkan cmdlet Invoke-Sqlcmd dan Invoke-PolicyEvaluation.

Anda dapat menggunakan utilitas sqlps untuk melakukan hal berikut:

Jalankan perintah PowerShell secara interaktif.
Jalankan file skrip PowerShell.
Jalankan cmdlet SQL Server.
Gunakan jalur penyedia SQL Server untuk menavigasi melalui hierarki objek SQL Server.

Secara default, utilitas sqlps berjalan dengan kebijakan eksekusi skrip yang diatur ke Dibatasi. Ini mencegah menjalankan skrip PowerShell apa pun. Anda dapat menggunakan cmdlet Set-ExecutionPolicy untuk mengaktifkan menjalankan skrip yang ditandatangani, atau skrip apa pun. Hanya jalankan skrip dari sumber tepercaya, dan amankan semua file input dan output dengan menggunakan izin NTFS yang sesuai. Untuk informasi selengkapnya tentang mengaktifkan skrip PowerShell, lihat Menjalankan Skrip Windows PowerShell.

Versi utilitas sqlps di SQL Server 2008 (10.0.x) dan SQL Server 2008 R2 (10.50.x) diimplementasikan sebagai shell mini Windows PowerShell 1.0. Shell mini memiliki batasan tertentu, seperti tidak memungkinkan pengguna memuat snap-in selain yang dimuat oleh shell mini. Pembatasan ini tidak berlaku untuk SQL Server 2012 (11.x) dan versi utilitas yang lebih tinggi, yang telah diubah untuk menggunakan modul sqlps .

Contoh

J. Jalankan utilitas sqlps dalam mode interaktif default tanpa banner hak cipta

sqlps -NoLogo

B. Menjalankan skrip PowerShell SQL Server dari prompt perintah

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

C. Jalankan skrip PowerShell SQL Server dari prompt perintah, dan terus berjalan setelah skrip selesai

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

Lihat Juga

Mengaktifkan atau Menonaktifkan Protokol Jaringan Server
SQL Server PowerShell

Bagikan melalui