Partager via

ConvertTo-EncodedSqlName

  • Référence
Module:
SQLServer

Encode les caractères étendus dans les noms SQL Server pour les formats utilisables dans les chemins Windows PowerShell.

Syntaxe

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

Description

L’applet de commande ConvertTo-EncodedSqlName encode des caractères spéciaux dans les noms SQL Server pour les formats utilisables dans les chemins Windows PowerShell.

Les identificateurs délimités SQL Server peuvent contenir des caractères non pris en charge normalement dans les noms d’objets Windows PowerShell.

Lorsque vous utilisez des identificateurs délimités dans les chemins d’accès du fournisseur SQL Server, ces caractères étendus doivent être encodés dans leur représentation hexadécimale ou placés en échappement à l’aide du caractère ' .

Certains caractères, tels que le caractère deux-points (:) ne peuvent pas être échappés.

L’encodage hexadécimal pour les caractères est au format %nn.

Les caractères encodés par ConvertTo-EncodedSqlName sont : \ : . / % <> * ? [ ] |

Exemples

Exemple 1 : Encoder un nom de table SQL Server

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

My%3ATable%2F

Cette commande encode un nom de table SQL Server qui contient : et / characters.

Paramètres

-ProgressAction

Détermine comment PowerShell répond aux mises à jour de progression générées par un script, une applet de commande ou un fournisseur, telles que les barres de progression générées par l’applet de commande Write-Progress. L’applet de commande Write-Progress crée des barres de progression qui affichent l’état d’une commande.

Type:ActionPreference
Alias:proga
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SqlName

Spécifie l’identificateur SQL Server à encoder.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

String

Sorties

String