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