Bagikan melalui


Menentukan instans di Penyedia PowerShell SQL Server

Jalur yang ditentukan untuk penyedia PowerShell SQL Server harus mengidentifikasi instans Mesin Database dan komputer yang dijalankannya. Sintaks untuk menentukan komputer dan instans harus mematuhi aturan untuk pengidentifikasi SQL Server dan jalur Windows PowerShell.

Nota

Ada dua modul PowerShell SQL Server; SqlServer dan SQLPS.

Modul SqlServer adalah modul PowerShell saat ini yang akan digunakan.

Modul SQLPS disertakan dengan penginstalan SQL Server (untuk kompatibilitas mundur) tetapi tidak lagi diperbarui.

Modul SqlServer berisi versi cmdlet yang diperbarui di SQLPS dan menyertakan cmdlet baru untuk mendukung fitur SQL terbaru.

Instal modul SqlServer dari Galeri PowerShell.

Untuk informasi selengkapnya, kunjungi SQL Server PowerShell.

Sebelum Anda mulai

Simpul pertama yang mengikuti SQLSERVER:\SQL di jalur penyedia SQL Server adalah nama komputer yang menjalankan instans Mesin Database; misalnya:

SQLSERVER:\SQL\MyComputer

Jika Anda menjalankan Windows PowerShell di komputer yang sama dengan instans Mesin Database, Anda dapat menggunakan localhost atau (lokal) alih-alih nama komputer. Skrip yang menggunakan localhost atau (lokal) dapat dijalankan di komputer apa pun tanpa harus diubah untuk mencerminkan nama komputer yang berbeda.

Anda dapat menjalankan beberapa instans program yang dapat dieksekusi Mesin Database di komputer yang sama. Simpul yang mengikuti nama komputer di jalur penyedia SQL Server mengidentifikasi instans; misalnya:

SQLSERVER:\SQL\MyComputer\MyInstance

Setiap komputer dapat memiliki satu instans default Mesin Database. Anda tidak menentukan nama untuk instans default saat menginstalnya. Jika Anda hanya menentukan nama komputer dalam string koneksi, Anda tersambung ke instans default di komputer tersebut. Semua instans lain di komputer harus diberi nama instans. Anda menentukan nama instans selama penyiapan, dan string koneksi harus menentukan nama komputer dan nama instans.

Batasan dan pembatasan

Anda tidak dapat menggunakan titik (.) untuk menentukan komputer lokal dalam skrip PowerShell. Periode tidak didukung karena periode ditafsirkan sebagai perintah oleh PowerShell.

Karakter tanda kurung dalam (lokal) biasanya diperlakukan sebagai perintah oleh Windows PowerShell. Anda harus mengodekannya atau melepaskannya untuk digunakan dalam jalur, atau mengapit jalur dalam tanda kutip ganda. Untuk informasi selengkapnya, lihat Mengodekan dan Mendekode Pengidentifikasi SQL Server.

Penyedia SQL Server mengharuskan Anda selalu menentukan nama instans. Untuk instans default, Anda harus menentukan nama instans DEFAULT.

Contoh: Nama komputer dan instans

Contoh ini menggunakan localhost dan DEFAULT untuk menentukan instans default di komputer lokal:

Set-Location SQLSERVER:\SQL\localhost\DEFAULT

Karakter tanda kurung dalam (lokal) biasanya diperlakukan sebagai perintah oleh Windows PowerShell. Anda harus:

  • Sertakan string jalur dalam tanda kutip:

    Set-Location "SQLSERVER:\SQL\(local)\DEFAULT"
    
  • Lolos dari tanda kurung menggunakan karakter pemeriksaan belakang ('):

    Set-Location SQLSERVER:\SQL\`(local`)\DEFAULT
    
  • Mengodekan tanda kurung menggunakan representasi heksadesimal mereka:

    Set-Location SQLSERVER:\SQL\%28local%29\DEFAULT