Convert-UrnToPath

Referenz

Modul:: SQLServer

Konvertiert einen SQL Server-Verwaltungsobjekt-URN in einen Windows PowerShell-Anbieterpfad.

Syntax

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

Beschreibung

Das cmdlet Convert-UrnToPath konvertiert einen URN (SQL Server Management Object Uniform Resource Name) in einen SQL Server-Anbieterpfad.

SQL Server-Verwaltungsobjekte verfügen über eine Urn-Eigenschaft, die eine Zeichenfolge zurückgibt, die ihren Speicherort in der SQL Server-Objekthierarchie angibt.

Wenn Knoten in der Urn SQL Server-durch Trennzeichen getrennte Bezeichner mit erweiterten Zeichen sind, die in Windows PowerShell-Pfadknoten nicht unterstützt werden, werden die erweiterten Zeichen mit ihrer hexadezimalen Darstellung codiert.

Beispielsweise wird ein Tabellenname "Main:Table" als "Main%3ATable" codiert.

Beispiele

Beispiel 1: Abrufen einer Zeichenfolge mit dem aktuellen Pfad

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

Dieser Befehl gibt eine Zeichenfolge zurück, die den aktuellen Pfad enthält. Im Beispiel wird die Funktion "ToString()" der Urn-Eigenschaft verwendet, um den Urn als Zeichenfolge zurückzugeben.

Beispiel 2: Festlegen des Pfadspeicherorts basierend auf einem URN

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

Mit diesem Befehl wird der Pfad zum Speicherort festgelegt, der in einem SQL Server-Verwaltungsobjekt-URN angegeben ist.

Beispiel 3: Abrufen von Datenbankpfaden

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

Dieser Befehl gibt ein Array von Zeichenfolgen zurück, die den Pfad zu einer Datenbank in der Standardinstanz enthalten. Der Pipelineoperator wird verwendet, um den aktuellen Knoten-URN an Convert-UrnToPath zu übergeben.

Parameter

-ProgressAction

Bestimmt, wie PowerShell auf Statusaktualisierungen reagiert, die von einem Skript, Cmdlet oder Anbieter generiert werden, z. B. auf die Statusanzeigen, die vom Cmdlet Write-Progress generiert werden. Das Cmdlet Write-Progress erstellt Statusanzeigen, die den Status eines Befehls anzeigen.

Typ:	ActionPreference
Aliase:	proga
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Urn

Gibt einen SQL Server-URN an, der den Speicherort eines Objekts in der SQL Server-Hierarchie identifiziert.

Typ:	String
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

Eingaben

String

Gibt eine Zeichenfolge an, die einen URN des SQL Server-Verwaltungsobjekts darstellt.

Ausgaben