ConvertFrom-String

ConvertFrom-String
    [-InputObject] <String>
    [-Delimiter <String>]
    [-PropertyNames <String[]>]
    [<CommonParameters>]

ConvertFrom-String
    [-InputObject] <String>
    [-TemplateFile <String[]>]
    [-TemplateContent <String[]>]
    [-IncludeExtent]
    [-UpdateTemplate]
    [<CommonParameters>]

O cmdlet ConvertFrom-String extrai e analisa propriedades estruturadas do conteúdo da cadeia de caracteres. Esse cmdlet gera um objeto analisando o texto de um fluxo de texto tradicional. Para cada cadeia de caracteres no pipeline, o cmdlet divide a entrada por um delimitador ou uma expressão de análise e atribui nomes de propriedade a cada um dos elementos de divisão resultantes. Você pode fornecer esses nomes de propriedade; se você não fizer isso, eles serão gerados automaticamente para você.

O conjunto de parâmetros padrão do cmdlet, ByDelimiter, divide exatamente no delimitador de expressão regular. Ele não executa a correspondência de aspas ou o escape do delimitador como o cmdlet Import-Csv faz.

O conjunto de parâmetros alternativo do cmdlet, TemplateParsing, gera elementos dos grupos capturados por uma expressão regular. Para obter mais informações sobre expressões regulares, consulte about_Regular_Expressions.

Esse cmdlet dá suporte a dois modos: análise delimitada básica e análise controlada por exemplo gerada automaticamente.

A análise delimitada, por padrão, divide a entrada em espaço em branco e atribui nomes de propriedade aos grupos resultantes.

Você pode personalizar o delimitador canalizando os resultados do ConvertFrom-String em um dos cmdlets Format-* ou pode usar o parâmetro delimitador de.

O cmdlet também dá suporte à análise controlada por exemplo e gerada automaticamente com base no FlashExtract, trabalho de pesquisa da Microsoft Research.

"Hello World" | ConvertFrom-String

P1    P2
--    --
Hello World

Esse comando gera um objeto com nomes de propriedade padrão, P1 e P2.

Esse comando gera um objeto com propriedades P1, P2; ambas as propriedades são do tipo String, por padrão.

"Hello World" | ConvertFrom-String | Get-Member

   TypeName: System.Management.Automation.PSCustomObject

Name        MemberType   Definition
----        ----------   ----------
Equals      Method       bool Equals(System.Object obj)
GetHashCode Method       int GetHashCode()
GetType     Method       type GetType()
ToString    Method       string ToString()
P1          NoteProperty string P1=Hello
P2          NoteProperty string P2=World

Esse comando gera um objeto com um domínio e um nome de usuário usando a barra invertida (\) como delimitador. O caractere de barra invertida deve ser escapado com outra barra invertida ao usar expressões regulares.

"Contoso\Administrator" | ConvertFrom-String -Delimiter "\\"

P1      P2
--      --
Contoso Administrator

O exemplo a seguir cria objetos a partir de entradas de arquivo de hosts do Windows.

$content = Get-Content C:\Windows\System32\drivers\etc\hosts
$content = $content -match "^[^#]"
$content | ConvertFrom-String -PropertyNames IP, Server

IP             Server
--             ------
192.168.7.10   W2012R2
192.168.7.20   W2016
192.168.7.101  WIN8
192.168.7.102  WIN10

O cmdlet Get-Content armazena o conteúdo de um arquivo de hosts do Windows em $content. O segundo comando remove os comentários no início do arquivo de hosts usando uma expressão regular que corresponde a qualquer linha que não comece com (#). O último comando converte o texto restante em objetos com propriedades Server e IP.

Esse comando usa uma expressão como o valor do parâmetro TemplateContent. A expressão é salva em uma variável para simplificar. O Windows PowerShell entende agora que a cadeia de caracteres usada no pipeline para ConvertFrom-String tem três propriedades:

• Nome
• telefone
• idade

$template = @'
{Name*:Phoebe Cat}, {phone:425-123-6789}, {age:6}
{Name*:Lucky Shot}, {phone:(206) 987-4321}, {age:12}
'@

$testText = @'
Phoebe Cat, 425-123-6789, 6
Lucky Shot, (206) 987-4321, 12
Elephant Wise, 425-888-7766, 87
Wild Shrimp, (111)  222-3333, 1
'@

$PersonalData = $testText | ConvertFrom-String -TemplateContent $template
Write-Output ("Pet items found: " + ($PersonalData.Count))
$PersonalData

Pet items found: 4

Name          phone           age
----          -----           ---
Phoebe Cat    425-123-6789    6
Lucky Shot    (206) 987-4321  12
Elephant Wise 425-888-7766    87
Wild Shrimp   (111)  222-3333 1

Cada linha na entrada é avaliada pelas correspondências de exemplo. Se a linha corresponder aos exemplos fornecidos no padrão, os valores serão extraídos e passados para a variável de saída.

Os dados de exemplo, $template, fornecem dois formatos de telefone diferentes:

• 425-123-6789
• (206) 987-4321

Os dados de exemplo também fornecem dois formatos de idade diferentes:

• 6
• 12

Isso implica que telefones como (206) 987 4321 não serão reconhecidos, pois não há dados de exemplo que correspondam a esse padrão porque não há hifens.

Este é o mesmo exemplo do Exemplo 4, acima. A diferença é que a cadeia de caracteres padrão inclui um tipo de dados para cada propriedade desejada.

$template = @'
{[string]Name*:Phoebe Cat}, {[string]phone:425-123-6789}, {[int]age:6}
{[string]Name*:Lucky Shot}, {[string]phone:(206) 987-4321}, {[int]age:12}
'@

$testText = @'
Phoebe Cat, 425-123-6789, 6
Lucky Shot, (206) 987-4321, 12
Elephant Wise, 425-888-7766, 87
Wild Shrimp, (111)  222-3333, 1
'@

$PersonalData = $testText | ConvertFrom-String -TemplateContent $template
Write-Output ("Pet items found: " + ($PersonalData.Count))
$PersonalData

Pet items found: 4

Name          phone           age
----          -----           ---
Phoebe Cat    425-123-6789      6
Lucky Shot    (206) 987-4321   12
Elephant Wise 425-888-7766     87
Wild Shrimp   (111)  222-3333   1

$PersonalData | Get-Member

   TypeName: System.Management.Automation.PSCustomObject

Name        MemberType   Definition
----        ----------   ----------
Equals      Method       bool Equals(System.Object obj)
GetHashCode Method       int GetHashCode()
GetType     Method       type GetType()
ToString    Method       string ToString()
age         NoteProperty int age=6
Name        NoteProperty string Name=Phoebe Cat
phone       NoteProperty string phone=425-123-6789

O cmdlet Get-Member é usado para mostrar que a propriedade idade é um inteiro.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

O Windows PowerShell inclui os seguintes aliases para ConvertFrom-String:

• CFS