Partilhar via

ConvertTo-EncodedSqlName

  • Referência
Módulo:
SQLServer

Codifica caracteres estendidos em nomes do SQL Server para formatos utilizáveis em caminhos do Windows PowerShell.

Sintaxe

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

Description

O cmdlet ConvertTo-EncodedSqlName codifica caracteres especiais em nomes do SQL Server para formatos utilizáveis em caminhos do Windows PowerShell.

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

Ao usar identificadores delimitados em caminhos de provedor do SQL Server, 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 para os caracteres está no formato %nn.

Os caracteres codificados por ConvertTo-EncodedSqlName são: \ : . / % <> * ? [ ] |

Exemplos

Exemplo 1: codificar um nome de tabela do SQL Server

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

My%3ATable%2F

Esse comando codifica um nome de tabela do SQL Server que contém : e/caracteres.

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 a ser codificado.

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