Convert-UrnToPath

Referensi

Modul:: SQLServer

Mengonversi URN Objek Manajemen SQL Server ke jalur penyedia Windows PowerShell.

Sintaks

Convert-UrnToPath
       [-Urn] <String>
       [-ProgressAction <ActionPreference>]
       [<CommonParameters>]

Deskripsi

Cmdlet Convert-UrnToPath mengonversi Nama Sumber Daya SQL Server Management Object Uniform Resource Name (URN) ke jalur penyedia SQL Server.

Objek Manajemen SQL Server memiliki properti Urn yang mengembalikan string yang menunjukkan lokasinya dalam hierarki objek SQL Server.

Jika simpul dalam Urn adalah pengidentifikasi yang dibatasi SQL Server dengan karakter yang diperluas yang tidak didukung di simpul jalur Windows PowerShell, karakter yang diperluas dikodekan dengan representasi heksadesimalnya.

Misalnya, nama tabel "Main:Table" dikodekan sebagai "Main%3ATable".

Contoh

Contoh 1: Dapatkan string yang berisi jalur saat ini

PS C:\> Set-Location "SQLSERVER:\SQL\MyComputer\MyInstance\Databases\AdventureWorks2014"
PS SQLSERVER:\SQL\MyComputer\MyInstance\Databases\AdventureWorks2014> Convert-UrnToPath -Urn (Get-Item .).Urn.ToString()

SQLSERVER:\SQL\MyComputer\MyInstance\Databases\AdventureWorks2014

Perintah ini mengembalikan string yang berisi jalur saat ini. Contoh menggunakan fungsi ToString() dari properti Urn untuk mengembalikan Urn sebagai string.

Contoh 2: Mengatur lokasi jalur berdasarkan URN

PS C:\> Set-Location (Convert-UrnToPath -Urn "Server[@Name='MyComputer']/Database[@Name='AdventureWorks']/Table[@Name='Address' and @Schema = 'Person']")

Perintah ini mengatur jalur ke lokasi yang ditentukan dalam URN Objek Manajemen SQL Server.

Contoh 3: Mendapatkan jalur database

PS C:\> Set-Location "SQLSERVER:\SQL\MyComputer\DEFAULT\Databases"
PS SQLSERVER:\SQL\MyComputer\DEFAULT\Databases> foreach ($Item in Get-ChildItem) { $Item.Urn.ToString() | Convert-UrnToPath }

SQLSERVER:\SQL\MyComputer\DEFAULT\Databases\AdventureWorks2014

Perintah ini mengembalikan array string yang berisi jalur ke database dalam instans default. Operator alur digunakan untuk meneruskan URN simpul saat ini ke Convert-UrnToPath.

Parameter

-ProgressAction

Menentukan bagaimana PowerShell merespons pembaruan kemajuan yang dihasilkan oleh skrip, cmdlet, atau penyedia, seperti bilah kemajuan yang dihasilkan oleh cmdlet Write-Progress. cmdlet Write-Progress membuat bilah kemajuan yang memperlihatkan status perintah.

Jenis:	ActionPreference
Alias:	proga
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Urn

Menentukan URN SQL Server yang mengidentifikasi lokasi objek dalam hierarki SQL Server.

Jenis:	String
Position:	1
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

Input

String

Menentukan string yang mewakili URN Objek Manajemen SQL Server.

Output