Convert-UrnToPath

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

Syntax

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

Beschreibung

Das Cmdlet Convert-UrnToPath konvertiert einen SQL Server Verwaltungsobjekt-Uniform Resource Name (URN) in einen SQL Server Anbieterpfad.

SQL Server Management Objects verfügen über eine Urn-Eigenschaft, die eine Zeichenfolge zurückgibt, in der der Ort des Objekts in der SQL Server-Objekthierarchie angegeben ist.

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 die 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 URN SQL Server Management-Objekt 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

-Urn

Gibt einen SQL Server URN an, der die Position eines Objekts in der hierarchie SQL Server identifiziert.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Eingaben

String

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

Ausgaben

String

Gibt eine Zeichenfolge an, die einen SQL Server PowerShell-Anbieterpfad darstellt.