Freigeben über


ConvertTo-EncodedSqlName

Codiert erweiterte Zeichen in SQL Server-Namen in Formaten, die in Windows PowerShell-Pfaden verwendet werden können.

Syntax

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

Beschreibung

Das cmdlet ConvertTo-EncodedSqlName codiert Sonderzeichen in SQL Server-Namen in Formaten, die in Windows PowerShell-Pfaden verwendet werden können.

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

Bei Verwendung von durch Trennzeichen getrennten Bezeichnern in SQL Server-Anbieterpfaden müssen diese erweiterten Zeichen entweder mit ihrer hexadezimalen Darstellung codiert oder mithilfe des Zeichens escapezeichen verwendet werden.

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

Die hexadezimale Codierung für die Zeichen befindet sich im Format %nn.

Die von ConvertTo-EncodedSqlName codierten Zeichen sind: \ : . / % <> * ? [ ] |

Beispiele

Beispiel 1: Codieren eines SQL Server-Tabellennamens

PS C:\> ConvertTo-EncodedSqlName -SqlName "My:Table/" 

My%3ATable%2F

Mit diesem Befehl wird ein SQL Server-Tabellenname codiert, der Folgendes enthält: und /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 zu codierenden SQL Server-Bezeichner an.

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

Eingaben

String

Ausgaben

String