Convert-UrnToPath
Konvertiert einen SQL Server-Verwaltungsobjekt-URN in einen Windows PowerShell-Anbieterpfad.
Syntax
Default (Standardwert)
Convert-UrnToPath
[-Urn] <String>
[<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
-Urn
Gibt einen SQL Server-URN an, der den Speicherort eines Objekts in der SQL Server-Hierarchie identifiziert.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
String
Gibt eine Zeichenfolge an, die einen URN des SQL Server-Verwaltungsobjekts darstellt.
Ausgaben
String
Gibt eine Zeichenfolge an, die einen SQL Server PowerShell-Anbieterpfad darstellt.