Partager via


ConvertFrom-EncodedSqlName

Retourne l’identificateur SQL Server d’origine lorsqu’un identificateur a été encodé dans un format utilisable dans les chemins Windows PowerShell.

Syntaxe

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

Description

L’applet de commande ConvertFrom-EncodedSqlName retourne l’identificateur SQL Server non codé lorsqu’un identificateur a été encodé dans un format utilisable dans les chemins Windows PowerShell.

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

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 est au format %nn.

Decode-SqlName convertit les encodages suivants en caractères correspondants :

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

Exemples

Exemple 1 : Décoder un identificateur SQL Server

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

My:Table/

Cette commande décode un identificateur SQL Server qui a une représentation hexadécimale encodée pour le caractère : Windows PowerShell supprime également l’échappement du caractère de graduation arrière (') d’un caractère d’échappement/caractère.

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 que cette applet de commande reformats.

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