Utilitas sqlps

Utilitas sqlps memulai sesi Windows PowerShell 2.0 dengan memuat dan mendaftarkan penyedia dan cmdlet PowerShell untuk SQL Server. 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 Microsoft SQL Server di masa mendatang. Hindari menggunakan fitur ini dalam pekerjaan pengembangan baru, dan rencanakan untuk memodifikasi aplikasi yang saat ini menggunakan fitur ini. sqlps Gunakan modul PowerShell sebagai gantinya. Untuk informasi selengkapnya tentang sqlps modul, lihat Mengimpor Modul SQLPS.

Sintaksis

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

Argumen

-NoLogo
Menentukan agar perangkat lunak sqlps menyembunyikan banner hak cipta ketika mulai.

-Tidak Ada Keluar
Menentukan bahwa sqlps utilitas terus berjalan setelah perintah startup selesai.

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

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

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

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

-
-Command- menentukan bahwa sqlps program membaca masukan dari masukan standar.

script_block [ -argsargument_array ]
Menentukan blok perintah PowerShell yang akan dijalankan, blok harus dibungkus dalam kurung kurawal: {}. Script_block hanya dapat ditentukan ketika utilitas dipanggil sqlps dari PowerShell atau sesi utilitas lainnya sqlps . 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 sqlps (&) menyebabkan utilitas menjalankan perintah.

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

Komentar

sqlps Utilitas 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 sqlps utilitas 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, sqlps utilitas 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 sqlps utilitas di SQL Server 2008 dan SQL Server 2008 R2 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 dan versi utilitas yang lebih tinggi, yang telah diubah untuk menggunakan sqlps modul.

Contoh

sqlps -NoLogo

B. Jalankan skrip PowerShell SQL Server dari prompt perintah

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

C. Jalankan skrip PowerShell SQL Server dari prompt perintah, dan lanjutkan beroperasi setelah skrip selesai

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

Lihat Juga

Mengaktifkan atau Menonaktifkan Protokol Jaringan Server
SQL Server PowerShell

  • Terakhir diperbarui pada