SQL Server PowerShell

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

Penyedia SQL Server untuk Windows PowerShell mengekspos hierarki objek SQL Server di jalur yang mirip dengan jalur sistem file. Anda dapat menggunakan jalur untuk menemukan objek, lalu menggunakan metode dari model SQL Server Management Object (SMO) untuk melakukan tindakan pada objek.

Catatan

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, lihat SQL Server PowerShell.

Manfaat Penyedia PowerShell SQL Server

Jalur yang diterapkan oleh penyedia SQL Server memungkinkan peninjauan semua objek dengan mudah dan interaktif dalam instans SQL Server. Anda dapat menavigasi jalur menggunakan alias Windows PowerShell yang mirip dengan perintah yang biasanya Anda gunakan untuk menavigasi jalur sistem file.

Hierarki PowerShell SQL Server

Produk yang model data atau objeknya dapat diwakili dalam hierarki menggunakan penyedia Windows PowerShell untuk mengekspos hierarki. Hierarki diekspos dengan menggunakan drive dan struktur jalur yang mirip dengan apa yang digunakan sistem file Windows.

Setiap penyedia Windows PowerShell mengimplementasikan satu atau beberapa drive. Setiap drive adalah simpul akar hierarki objek terkait. Penyedia SQL Server mengimplementasikan drive SQLSERVER: . Penyedia juga menentukan sekumpulan folder utama untuk drive SQLSERVER: . Setiap folder dan subfoldernya mewakili kumpulan objek yang dapat diakses dengan menggunakan model objek manajemen SQL Server. Ketika Anda berfokus pada subfolder di jalur yang dimulai dengan salah satu folder utama ini, Anda dapat menggunakan metode dari model objek terkait untuk melakukan tindakan pada objek yang diwakili oleh simpul. Folder Windows PowerShell yang diterapkan oleh penyedia SQL Server tercantum dalam tabel berikut:

Folder	Namespace model objek SQL Server	Objek
SQLSERVER:\SQL	Microsoft.SqlServer.Management.Smo Microsoft.SqlServer.Management.Smo.Agent Microsoft.SqlServer.Management.Smo.Broker Microsoft.SqlServer.Management.Smo.Mail	Objek database, seperti tabel, tampilan, dan prosedur tersimpan.
SQLSERVER:\SQLPolicy	Microsoft.SqlServer.Management.Dmf Microsoft.SqlServer.Management.Facets	Objek manajemen berbasis kebijakan, seperti kebijakan dan faset.
SQLSERVER:\SQLRegistration	Microsoft.SqlServer.Management.RegisteredServers Microsoft.SqlServer.Management.Smo.RegSvrEnum	Objek server terdaftar, seperti grup server dan server terdaftar.
SQLSERVER:\Utility	Microsoft.SqlServer.Management.Utility	Objek utilitas, seperti instans terkelola Mesin Database.
SQLSERVER:\DAC	Microsoft.SqlServer.Management.Dac	Objek aplikasi tingkat data seperti paket DAC, dan operasi seperti menyebarkan DAC.
SQLSERVER:\DataCollection	Microsoft.SqlServer.Management.Collector	Objek pengumpul data, seperti kumpulan koleksi dan penyimpanan konfigurasi.
SQLSERVER:\SSIS	Microsoft.SqlServer.Management.IntegrationServices	Objek Integration Services seperti proyek, paket, dan lingkungan.
SQLSERVER:\XEvent	Microsoft.SqlServer.Management.XEvent	Peristiwa Yang Diperluas SQL Server
SQLSERVER:\DatabaseXEvent	Microsoft.SqlServer.Management.XEventDbScoped	Peristiwa Yang Diperluas SQL Server
SQLSERVER:\SQLAS	Microsoft.AnalysisServices	Objek Analysis Services seperti kubus, agregasi, dan dimensi.

Misalnya, Anda dapat menggunakan folder SQLSERVER:\SQL untuk memulai jalur yang dapat mewakili objek apa pun yang didukung oleh model objek SMO. Bagian terdepan dari jalur SQLSERVER:\SQL adalah SQLSERVER:\SQL\ComputerName\InstanceName. Simpul setelah nama instans bergantian antara koleksi objek (seperti Database atau Tampilan) dan nama objek (seperti AdventureWorks2022). Skema tidak direpresentasikan sebagai kelas objek. Saat Anda menentukan simpul untuk objek tingkat atas dalam skema, seperti tabel atau tampilan, Anda harus menentukan nama objek dalam format SchemaName.ObjectName.

Contoh berikut menunjukkan jalur tabel Vendor dalam skema AdventureWorks2022 Pembelian database dalam instans default Mesin Database di komputer lokal:

SQLSERVER:\SQL\localhost\DEFAULT\Databases\AdventureWorks2022\Tables\Purchasing.Vendor  

Untuk informasi selengkapnya tentang hierarki model objek SMO, lihat Diagram Model Objek SMO.

Node koleksi dalam jalur dikaitkan dengan kelas koleksi dalam model objek terkait. Simpul nama objek dikaitkan dengan kelas objek dalam model objek terkait, seperti dalam tabel berikut:

Jalur	Kelas SMO
SQLSERVER:\SQL\MyComputer\DEFAULT\Databases	DatabaseCollection
SQLSERVER:\SQL\MyComputer\DEFAULT\Databases\AdventureWorks2022	Database

Tugas Penyedia SQL Server

Deskripsi Tugas	Artikel
Menjelaskan cara menggunakan cmdlet Windows PowerShell untuk menavigasi melalui simpul di jalur, dan di setiap simpul mendapatkan daftar objek pada simpul tersebut.	Menavigasi Jalur PowerShell SQL Server
Menjelaskan cara menggunakan metode dan properti SMO untuk melaporkan dan melakukan pekerjaan pada objek yang diwakili oleh simpul di jalur. Juga menjelaskan cara mendapatkan daftar metode dan properti SMO untuk simpul tersebut.	Bekerja Dengan Jalur PowerShell SQL Server
Menjelaskan cara mengonversi SMO Uniform Resource Name (URN) ke jalur penyedia SQL Server.	Mengonversi URL ke Jalur Penyedia SQL Server
Menjelaskan cara membuka koneksi Autentikasi SQL Server dengan menggunakan penyedia SQL Server. Secara default, penyedia menggunakan koneksi Autentikasi Windows yang dibuat menggunakan kredensial akun Windows yang menjalankan sesi Windows PowerShell.	Mengelola Autentikasi di Mesin Database PowerShell

Langkah berikutnya

SQL Server PowerShell