Bagikan melalui

Menginstal modul SQL Server PowerShell

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.

Nota

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:

Nota

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

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

SQL Server Management Studio (SSMS)

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

Nota

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

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 memandikan Anda melalui langkah-langkah menginstal modul SqlServer PowerShell di komputer tanpa akses internet. Anda memerlukan dua komputer untuk menyelesaikan penginstalan ini: komputer yang terhubung ke internet dan komputer tujuan offline.

  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 ditentukan dalam -Path parameter . 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 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

Nota

PowerShell selalu menggunakan modul terbaru yang telah 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>"

Pemecahan Masalah

Jika Anda mengalami masalah saat menginstal, lihat dokumentasiInstall-Module dan referensiInstall-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 dan Install-Module yang diperbarui Find-Module yang merupakan bagian dari modul PowerShellGet dengan meneruskan -AllowPrerelease sakelar. 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 /sql/linux/sql-server-linux-manage-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 menyebarkan dan mengonfigurasi Microsoft SQL Server.

Referensi mengenai cmdlet

Konten terkait

  • Last updated on