Convert-String

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Formata uma cadeia de caracteres para corresponder a exemplos.

Syntax

Convert-String
       [-Example <System.Collections.Generic.List`1[System.Management.Automation.PSObject]>]
       -InputObject <String>
       [<CommonParameters>]

Description

O cmdlet formata uma cadeia de caracteres para corresponder ao formato dos exemplos.

Exemplos

Exemplo 1: Converter formato de uma cadeia de caracteres

"Mu Han", "Jim Hance", "David Ahs", "Kim Akers" | Convert-String -Example "Ed Wilson=Wilson, E."

Han, M.
Hance, J.
Ahs, D.
Akers, K.

O primeiro comando cria uma matriz que contém nomes e sobrenomes.

O segundo comando formata os nomes de acordo com o exemplo. Ele coloca o sobrenome primeiro na saída, seguido por uma inicial.

Exemplo 2: Simplificar o formato de uma cadeia de caracteres

$composers = @("Johann Sebastian Bach", "Wolfgang Amadeus Mozart", "Frederic Francois Chopin", "Johannes Brahms")
$composers | Convert-String -Example "first middle last=last, first"

Bach, Johann
Mozart, Wolfgang
Chopin, Frederic
Brahms, Johannes

O primeiro comando cria uma matriz que contém nomes, nomes do meio e sobrenomes. Observe que a última entrada não tem nome do meio.

O segundo comando formata os nomes de acordo com o exemplo. Ele coloca o sobrenome primeiro na saída, seguido pelo primeiro nome. Todos os nomes do meio removidos; entrada sem nome do meio é tratada corretamente.

Exemplo 3: Gerenciamento de saída quando as cadeias de caracteres não correspondem ao exemplo

$composers = @("Johann Sebastian Bach", "Wolfgang Amadeus Mozart", "Frederic Francois Chopin", "Johannes Brahms")
$composers | Convert-String -Example "first middle last=middle, first"

Sebastian, Johann
Amadeus, Wolfgang
Francois, Frederic

O primeiro comando cria uma matriz que contém nomes, nomes do meio e sobrenomes. Observe que a última entrada não tem nome do meio.

O segundo comando formata os nomes de acordo com o exemplo. Ele coloca o nome do meio primeiro na saída, seguido pelo primeiro nome. A última entrada é $Composers ignorada, porque não corresponde ao padrão de amostra: não tem nome do meio.

Exemplo 4: Cuidado com espaços de beleza

$composers = @("Antonio Vivaldi", "Richard Wagner ", "Franz Schubert", "Johannes Brahms ")
$composers | Convert-String -Example "Patti Fuller = Fuller, P."

Wagner, R.
 Brahms, J.

O primeiro comando cria uma matriz de nomes e sobrenomes. Observe que o segundo e o quarto itens têm um espaço extra à direita, após o sobrenome.

O segundo comando converte todas as cadeias de caracteres que correspondem ao padrão de exemplo: palavra, espaço, palavra e espaço final à direita, tudo isso antes do sinal de igual(=). Além disso, observe o espaço à esquerda na saída.

Exemplo 5: Formatar informações de processo com vários padrões

$ExamplePatterns = @(
    @{before='"Hello","World"'; after='World: Hello'},
    @{before='"Hello","1"'; after='1: Hello'},
    @{before='"Hello-World","22"'; after='22: Hello-World'},
    @{before='"hello world","333"'; after='333: hello world'}
)
$Processes = Get-Process   | Select-Object -Property ProcessName, Id | ConvertTo-Csv -NoTypeInformation
$Processes | Convert-String -Example $ExamplePatterns

Id: ProcessName
4368: AGSService
8896: Amazon Music Helper
4420: AppleMobileDeviceService
...
11140: git-bash
0: Idle
...
56: Secure System
...
13028: WmiPrvSE
2724: WUDFHost
2980: WUDFHost
3348: WUDFHost

$ExamplePatterns define diferentes padrões esperados nos dados, por meio de exemplos.

O primeiro padrão, @{before='"Hello","World"'; after='World: Hello'}, diz o seguinte:

  • esperar cadeias de caracteres onde uma palavra vem entre aspas duplas, em seguida, uma vírgula,
  • e depois a segunda, e última, palavra entre aspas;
  • sem espaços na corda. Na saída: coloque a segunda palavra em primeiro lugar,
  • sem aspas, depois um único espaço e, em seguida, a primeira palavra, sem aspas.

O segundo padrão, @{before='"Hello","1"'; after='1: Hello'}, diz o seguinte:

  • esperar cadeias de caracteres onde uma palavra vem entre aspas duplas, em seguida, uma vírgula,
  • e, em seguida, um número entre aspas;
  • sem espaços na corda. Na saída: coloque o número primeiro,
  • sem aspas, depois um único espaço e, em seguida, a palavra, sem aspas.

O terceiro padrão, @{before='"Hello-World","22"'; after='22: Hello-World'}, tem a seguinte redação:

  • esperar cadeias de caracteres em que duas palavras com um hífen no meio vêm incluídas em
  • aspas duplas, depois uma vírgula e, em seguida, um número entre aspas;
  • sem espaços entre a vírgula e a terceira aspa dupla.
  • Na saída: coloque o número primeiro, sem aspas, depois um único espaço,
  • e depois as palavras hifenizadas, sem aspas.

O quarto e último padrão, @{before='"hello world","333"'; after='333: hello world'}, tem a seguinte redação:

  • Espere cadeias de caracteres em que duas palavras com um espaço entre elas vêm fechadas
  • aspas duplas, depois uma vírgula e, em seguida, um número entre aspas;
  • sem espaços entre a vírgula e a terceira aspa dupla.
  • Na saída: coloque o número primeiro, sem aspas, depois um único espaço,
  • e depois as palavras com o espaço no meio, sem aspas.

O primeiro comando obtém todos os processos usando o cmdlet Get-Process. O comando os passa para o cmdlet Select-Object, que seleciona o nome do processo e a ID do processo. No final do pipeline, o comando converte a saída em valores separados por vírgula, sem informações de tipo, usando o cmdlet ConvertTo-Csv. O comando armazena os resultados na variável $Processes . $Processes agora contém nomes de processo e PID.

O segundo comando especifica uma variável de exemplo que altera a ordem dos itens de entrada. O comando cobre cada cadeia de caracteres em $Processes.

Observação

O quarto padrão diz implicitamente que duas ou mais palavras separadas por espaços são correspondidas. Sem o quarto padrão, apenas a primeira palavra da cadeia de caracteres entre aspas duplas é correspondida.

Parâmetros

-Example

Especifica uma lista de exemplos do formato de destino. Especifique pares separados pelo sinal de igual (=), com o padrão de origem à esquerda e o padrão de destino à direita, como nos exemplos a seguir:

  • -Example "Hello World=World, Hello"
  • -Example "Hello World=World: Hello",'"Hello","1"=1: Hello'

Observação

O segundo exemplo usa uma lista de padrões

Como alternativa, especifique uma lista de tabelas de hash que contenham propriedades Antes e Depois .

  • -Example @{before='"Hello","World"'; after='World: Hello'}, @{before='"Hello","1"'; after='1: Hello'}

Cuidado

Evite usar espaços ao redor do sinal de igual(=), pois eles são tratados como parte do padrão.

Type:List<T>[PSObject]
Aliases:E
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifica uma cadeia de caracteres a ser formatada.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String

Você pode canalizar cadeias de caracteres para esse cmdlet.

Saídas

String

Esse cmdlet retorna uma cadeia de caracteres.