Convert-String

Sintaxe

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 o 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 nome, nome do meio e sobrenome. 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 nome. Todos os nomes do meio removidos; sem nome do meio é tratada corretamente.

Exemplo 3: Gerenciamento de saída quando as cadeias de caracteres não correspondem 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 nome, nome do meio e sobrenome. 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 exemplo: 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 strings que correspondem ao padrão de amostra: 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 do 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'}, tem a seguinte redação:

• espere strings em que uma palavra vem entre aspas duplas e, em seguida, uma vírgula,
• e então a segunda e última palavra entre aspas;
• sem espaços na string. Na saída: coloque a segunda palavra primeiro,
• sem aspas, depois um único espaço e depois a primeira palavra, sem aspas.

O segundo padrão, @{before='"Hello","1"'; after='1: Hello'}, tem a seguinte redação:

• espere strings em que uma palavra vem entre aspas duplas e, em seguida, uma vírgula,
• e então um número entre aspas;
• sem espaços na string. Na saída: coloque o número primeiro,
• sem aspas, depois um único espaço e depois a palavra, sem aspas.

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

• Espere strings em que duas palavras com um hífen entre elas
• aspas duplas, depois uma vírgula e depois 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 strings em que duas palavras com um espaço entre elas
• aspas duplas, depois uma vírgula e depois 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 entre elas, 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 processos e PID.

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

Parâmetros

-Example

-InputObject

Entradas

String

Você pode canalizar cadeias de caracteres para esse cmdlet.

Saídas

String

Esse cmdlet retorna uma cadeia de caracteres.

Links Relacionados

• ConvertFrom-String
• ConvertTo-Csv
• Get-Process
• Out-String
• Select-Object