Menginstal modul PowerShell SQL Server

  • Artikel

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)

Artikel ini menyediakan petunjuk untuk menginstal modul PowerShell SqlServer .

Modul PowerShell untuk SQL Server

Ada dua modul PowerShell SQL Server:

  • SqlServer: Modul SqlServer menyertakan cmdlet baru untuk mendukung fitur SQL terbaru. Modul ini juga berisi versi cmdlet yang diperbarui di SQLPS. Untuk mengunduh modul SqlServer, buka modul SqlServer di Galeri PowerShell.

Catatan

Versi modul SqlServer di PowerShell Gallery mendukung penerapan versi dan memerlukan PowerShell versi 5.1 atau yang lebih tinggi.

  • SQLPS: SQLPS adalah modul yang digunakan oleh Agen SQL untuk menjalankan pekerjaan agen dalam langkah-langkah pekerjaan agen menggunakan subsistem PowerShell.

Untuk artikel bantuan, buka:

Catatan

Dalam konteks modul SqlServer dan SQLPS, dimungkinkan agar nama perintah tertentu ada di kedua modul.

Ini dapat membuat konflik ketika satu modul sudah diinstal dan yang lain sedang diinstal atau diperbarui. Untuk mencegah konflik ini, parameter -AllowClobber dapat digunakan saat menginstal atau memperbarui modul. Selain itu, saat mengimpor satu modul, perlu untuk menghapus modul lain terlebih dahulu atau menggunakan parameter -DisableNameChecking untuk mencegah kesalahan. Langkah-langkah ini memastikan bahwa modul dapat hidup berdampingan tanpa menyebabkan masalah apa pun.

SQL Server Management Studio

Unduh SQL Server Management Studio (SSMS), tidak menginstal modul PowerShell. Untuk menggunakan PowerShell dengan SQL Server Management Directory, instal modul SqlServer dari Galeri PowerShell.

Catatan

SQL Server Management Studio (SSMS) 16.x (dan versi yang lebih lama) menyertakan modul SQLPS .

Azure Data Studio

Azure Data Studio tidak menginstal modul PowerShell. Untuk menggunakan PowerShell dengan Azure Data Studio, instal modul SqlServer dari Galeri PowerShell.

Anda dapat menggunakan ekstensi PowerShell, yang menyediakan dukungan editor PowerShell yang kaya di Azure Data Studio.

Menginstal atau memperbarui modul SqlServer

Untuk menginstal modul SqlServer dari Galeri PowerShell, mulai sesi PowerShell dan jalankan Install-Module SQLServer.

Install-Module -Name SqlServer

Jika berjalan di Windows PowerShell, Anda dapat menggunakan Install-Module SQLServer -Scope CurrentUser untuk menginstal modul untuk pengguna saat ini dan menghindari perlunya izin yang ditingkatkan.

Menginstal modul SqlServer untuk semua pengguna

Untuk menginstal modul SqlServer untuk semua pengguna, jalankan perintah di bawah ini dalam sesi PowerShell yang ditingkatkan; mulai sesi PowerShell sebagai administrator:

Install-Module -Name SqlServer

Menginstal modul SqlServer ke komputer offline

Bagian ini memanmbing Anda melalui langkah-langkah menginstal modul PowerShell SqlServer di komputer yang tidak memiliki akses internet. Anda memerlukan dua komputer untuk menyelesaikan penginstalan ini: komputer yang terhubung ke internet dan komputer tujuan offline (tidak tersambung ke Internet).

  1. Di komputer yang terhubung ke internet, unduh modul PowerShell SQLServer. Perintah ini mengunduh dan menyimpan semua file untuk modul di folder sampel $env:TEMP\SQLServer\<SomeVersion> , yang didefinisikan dalam parameter -Path . Anda dapat memilih folder preferensi Anda sebagai tujuan di komputer yang terhubung ke internet.

    Save-Module -Name SqlServer -Path $env:TEMP

  2. Telusuri ke lokasi folder di File Explorer untuk memverifikasi bahwa $env:TEMP\SQLServer\<SomeVersion> folder ada atau jalankan perintah ini:

    Get-ChildItem -Path $env:TEMP\SQLServer\

  3. Salin folder yang $env:TEMP\SQLServer\<SomeVersion> Anda temukan di langkah 2 ke komputer offline tujuan dalam %ProgramFiles%\WindowsPowerShell\Modules\SqlServer folder (folder ini akan berfungsi untuk PS5 dan PS7). Pastikan untuk mengganti <SomeVersion> dengan nilai yang Anda temukan di langkah sebelumnya.

  4. Konfirmasikan bahwa modul SqlServer PowerShell tersedia di komputer offline dengan menjalankan cmdlet PowerShell berikut:

    Get-Module SqlServer -ListAvailable

    Output mungkin terlihat seperti ini (versi aktual mungkin berbeda dan harus cocok <SomeVersion> dengan yang tercantum sebelumnya):

       PS C:\Users\user1> Get-Module SqlServer -ListAvailable

       Directory: C:\Program Files\WindowsPowerShell\Modules

   ModuleType Version    Name                     ExportedCommands
   ---------- -------    ----                     ----------------
   Script     22.1.1     SqlServer                {Add-RoleMember, Add-SqlAvail...

Lihat versi modul SqlServer yang diinstal

Jalankan perintah berikut untuk melihat versi modul SqlServer yang telah diinstal.

Get-Module SqlServer -ListAvailable

Untuk melihat versi modul SqlServer yang dimuat dalam sesi saat ini

(Get-Module SqlServer).Version

Timpa versi modul SqlServer sebelumnya

Anda juga dapat menggunakan Install-Module perintah untuk menimpa versi sebelumnya.

Install-Module -Name SqlServer -AllowClobber

Catatan

PowerShell selalu menggunakan modul terbaru yang diinstal.

Memperbarui versi modul SqlServer yang diinstal

Saat versi modul SqlServer yang diperbarui tersedia, Anda dapat menginstal versi yang lebih baru menggunakan perintah berikut:

Update-Module -Name SqlServer -AllowClobber

Anda dapat menggunakan Update-Module perintah untuk menginstal versi terbaru modul SQLServer PowerShell, tetapi itu tidak menghapus versi lama. Ini menginstal versi yang lebih baru secara berdampingan untuk memungkinkan Anda bereksperimen dengan versi terbaru sambil masih menginstal modul yang lebih lama.

Namun, jika Anda tidak ingin menyimpan versi modul yang lebih lama, Anda dapat menggunakan Uninstall-Module perintah untuk menghapus versi sebelumnya.

Anda dapat menggunakan perintah berikut untuk mencantumkan jika lebih dari satu versi diinstal:

Get-Module SqlServer -ListAvailable

Anda dapat menggunakan perintah berikut untuk menghapus versi lama:

Uninstall-module -Name SQLServer -RequiredVersion "<version number>"

Pecahkan masalah

Jika Anda mengalami masalah saat menginstal, lihat dokumentasi Install-Module dan referensi Install-Module.

Menggunakan versi tertentu dari modul SqlServer

Untuk menggunakan versi modul tertentu, impor dengan nomor versi tertentu yang mirip dengan perintah berikut:

Import-Module SqlServer -Version 21.1.18218

Versi prarilis modul SqlServer

Versi prarilis (atau "pratinjau") modul SqlServer mungkin tersedia di Galeri PowerShell.

Penting

Versi ini mungkin ditemukan dan diinstal dengan menggunakan cmdlet Find-Module dan Install-Module yang diperbarui yang merupakan bagian dari modul PowerShellGet dengan meneruskan sakelar -AllowPrerelease. Untuk menggunakan cmdlet ini, instal modul PowerShellGet dan buka sesi baru.

Menemukan versi prarilis modul SqlServer

Untuk menemukan versi prarilis (pratinjau) modul SqlServer, jalankan perintah berikut:

Find-Module SqlServer -AllowPrerelease

Menginstal versi prarilis tertentu dari modul SqlServer

Untuk menginstal versi prarilis tertentu dari modul, instal dengan nomor versi tertentu.

Anda dapat mencoba menggunakan perintah berikut:

Install-Module SqlServer -RequiredVersion 21.1.18218-preview -AllowPrerelease

SQL Server PowerShell di Linux

Kunjungi Kelola SQL Server di Linux dengan PowerShell Core untuk melihat cara menginstal SQL Server PowerShell di Linux.

Modul lain

  • Az.Sql - Cmdlet layanan SQL untuk Azure Resource Manager di Windows PowerShell dan PowerShell.

  • SqlServerDsc - Modul dengan sumber daya DSC untuk penyebaran dan konfigurasi Microsoft SQL Server.

Referensi cmdlet

Konten terkait