Freigeben über

ConvertFrom-EncodedSqlName

  • Referenz
Modul:
SQLServer

Gibt den ursprünglichen SQL Server-Bezeichner zurück, wenn ein Bezeichner angegeben wird, der in einem Format codiert wurde, das in Windows PowerShell-Pfaden verwendet werden kann.

Syntax

ConvertFrom-EncodedSqlName
                [-SqlName] <String>
                [-ProgressAction <ActionPreference>]
                [<CommonParameters>]

Beschreibung

Das Cmdlet ConvertFrom-EncodedSqlName gibt den nicht codierten SQL Server-Bezeichner zurück, wenn ein Bezeichner angegeben wird, der in einem Format codiert wurde, das in Windows PowerShell-Pfaden verwendet werden kann.

Sql Server-bezeichner mit Trennzeichen können Sonderzeichen enthalten, die in Windows PowerShell-Objektnamen normalerweise nicht unterstützt werden.

Diese erweiterten Zeichen müssen entweder mit ihrer hexadezimalen Darstellung codiert oder mithilfe des Zeichens ".

Bestimmte Zeichen, z. B. das Doppelpunktzeichen (:) können nicht escaped sein.

Die hexadezimale Codierung befindet sich im Format %nn.

Decode-SqlName konvertiert die folgenden Codierungen in die entsprechenden Zeichen:

  • %5C wird \
  • %3A wird:
  • %2E wird .
  • %2F wird /
  • %25 wird %
  • %3C wird <
  • %3E wird >
  • %2A wird *
  • %3F wird ?
  • %5B wird [
  • %5D wird ]
  • %7C wird |

Beispiele

Beispiel 1: Decodieren eines SQL Server-Bezeichners

PS C:\> ConvertFrom-EncodedSqlName -SqlName "My%3ATable`/"

My:Table/

Mit diesem Befehl wird ein SQL Server-Bezeichner decodiert, der eine codierte hexadezimale Darstellung des Zeichens hat. Windows PowerShell entfernt auch das escapeende Back-Tick-Zeichen (') aus einem Escapezeichen /Zeichen.

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

-SqlName

Gibt den SQL Server-Bezeichner an, den dieses Cmdlet neu erstellt.

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

Eingaben

String

Ausgaben

String