Partilhar via

ConvertFrom-EncodedSqlName

  • Referência
Módulo:
SQLServer

Retorna o identificador original do SQL Server quando dado um identificador que foi codificado em um formato utilizável em caminhos do Windows PowerShell.

Sintaxe

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

Description

O cmdlet ConvertFrom-EncodedSqlName retorna o identificador do SQL Server não codificado quando dado um identificador que foi codificado em um formato utilizável em caminhos do Windows PowerShell.

Identificadores delimitados do SQL Server podem conter caracteres especiais que normalmente não têm suporte em nomes de objeto do Windows PowerShell.

Esses caracteres estendidos devem ser codificados para sua representação hexadecimal ou escapados usando o caractere '.

Determinados caracteres, como o caractere de dois-pontos (:) não podem ser escapados.

A codificação hexadecimal está no formato %nn.

Decode-SqlName converte as seguintes codificações nos caracteres correspondentes:

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

Exemplos

Exemplo 1: decodificar um identificador do SQL Server

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

My:Table/

Esse comando decodifica um identificador do SQL Server que tem uma representação hexadecimal codificada para o caractere : O Windows PowerShell também remove o caractere de escape back-tick (') de um caractere/escape.

Parâmetros

-ProgressAction

Determina como o PowerShell responde às atualizações de progresso geradas por um script, cmdlet ou provedor, como as barras de progresso geradas pelo cmdlet Write-Progress. O cmdlet Write-Progress cria barras de progresso que mostram o status de um comando.

Tipo:ActionPreference
Aliases:proga
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SqlName

Especifica o identificador do SQL Server que esse cmdlet reformata.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

String

Saídas

String