Convert-UrnToPath
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
String
Menentukan string yang mewakili jalur penyedia PowerShell SQL Server.