Condividi tramite


ConvertTo-EncodedSqlName

Codifica i caratteri estesi nei nomi di SQL Server per formattare i percorsi di Windows PowerShell utilizzabili.

Sintassi

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

Descrizione

Il cmdlet ConvertTo-EncodedSqlName codifica caratteri speciali nei nomi di SQL Server per formattare i percorsi di Windows PowerShell utilizzabili.

Gli identificatori delimitati di SQL Server possono contenere caratteri normalmente non supportati nei nomi degli oggetti di Windows PowerShell.

Quando si usano identificatori delimitati nei percorsi del provider SQL Server, questi caratteri estesi devono essere codificati nella relativa rappresentazione esadecimale o preceduti da un carattere di escape usando il carattere ' .

Alcuni caratteri, ad esempio il carattere due punti (:) non possono essere preceduti da caratteri di escape.

La codifica esadecimale per i caratteri è nel formato %nn.

I caratteri codificati da ConvertTo-EncodedSqlName sono: \ : . / % <> * ? [ ] |

Esempio

Esempio 1: Codificare un nome di tabella di SQL Server

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

My%3ATable%2F

Questo comando codifica un nome di tabella di SQL Server che contiene : e /characters.

Parametri

-ProgressAction

Determina in che modo PowerShell risponde agli aggiornamenti dello stato generati da uno script, un cmdlet o un provider, ad esempio le barre di stato generate dal cmdlet Write-Progress. Il cmdlet Write-Progress crea barre di stato che mostrano lo stato di un comando.

Tipo:ActionPreference
Alias:proga
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SqlName

Specifica l'identificatore di SQL Server da codificare.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

String

Output

String