Join-String
Combina objetos do pipeline em uma única cadeia de caracteres.
Syntax
Join-String
[[-Property] <PSPropertyExpression>]
[[-Separator] <String>]
[-OutputPrefix <String>]
[-OutputSuffix <String>]
[-UseCulture]
[-InputObject <PSObject[]>]
[<CommonParameters>]Join-String
[[-Property] <PSPropertyExpression>]
[[-Separator] <String>]
[-OutputPrefix <String>]
[-OutputSuffix <String>]
[-SingleQuote]
[-UseCulture]
[-InputObject <PSObject[]>]
[<CommonParameters>]Join-String
[[-Property] <PSPropertyExpression>]
[[-Separator] <String>]
[-OutputPrefix <String>]
[-OutputSuffix <String>]
[-DoubleQuote]
[-UseCulture]
[-InputObject <PSObject[]>]
[<CommonParameters>]Join-String
[[-Property] <PSPropertyExpression>]
[[-Separator] <String>]
[-OutputPrefix <String>]
[-OutputSuffix <String>]
[-FormatString <String>]
[-UseCulture]
[-InputObject <PSObject[]>]
[<CommonParameters>]Description
O Join-String cmdlet une ou combina texto de objetos de pipeline em uma única cadeia de caracteres.
Se nenhum parâmetro for especificado, os objetos de pipeline serão convertidos em uma cadeia de caracteres e unidos ao separador $OFSpadrão.
Nota
Quando você define $OFS seu valor é usado para unir matrizes quando elas são convertidas em cadeias de caracteres até que a variável seja redefinida para $null. Como o uso $OFS pode ter efeitos não intencionais em outro lugar do código, é melhor usar o parâmetro Separator .
Ao especificar um nome de propriedade, o valor da propriedade é convertido em uma cadeia de caracteres e unido em uma cadeia de caracteres.
Em vez de um nome de propriedade, um bloco de script pode ser usado. O resultado do bloco de script é convertido em uma cadeia de caracteres antes de ser unido para formar o resultado. Ele pode combinar o texto da propriedade de um objeto ou o resultado do objeto que foi convertido em uma cadeia de caracteres.
Este cmdlet foi introduzido no PowerShell 6.2.
Exemplos
Exemplo 1: Juntar nomes de diretórios
Este exemplo une nomes de diretório, encapsula a saída entre aspas duplas e separa os nomes de diretório com vírgula e espaço (, ). A saída é um objeto string.
Get-ChildItem -Directory C:\ | Join-String -Property Name -DoubleQuote -Separator ', '
"PerfLogs", "Program Files", "Program Files (x86)", "Users", "Windows"Get-ChildItem usa o parâmetro Directory para obter todos os nomes de diretório para a C:\ unidade.
Os objetos são enviados pelo pipeline para Join-String. O parâmetro Property especifica os nomes dos diretórios. O parâmetro DoubleQuote encapsula os nomes de diretório com aspas duplas.
O parâmetro Separator especifica o uso de vírgula e espaço (, ) para separar os nomes de diretório.
Os Get-ChildItem objetos são System.IO.DirectoryInfo e Join-String converte os objetos para System.String.
Exemplo 2: Usar uma substring de propriedade para unir nomes de diretório
Este exemplo usa um método de substring para obter as primeiras quatro letras de nomes de diretório, encapsula a saída em aspas simples e separa os nomes de diretório com um ponto-e-vírgula (;).
Get-ChildItem -Directory C:\ | Join-String -Property {$_.Name.SubString(0,4)} -SingleQuote -Separator ';'
'Perf';'Prog';'Prog';'User';'Wind'Get-ChildItem usa o parâmetro Directory para obter todos os nomes de diretório para a C:\ unidade.
Os objetos são enviados pelo pipeline para Join-String.
O bloco de script do parâmetro Property usa a variável automática ($_) para especificar a substring da propriedade Name de cada objeto. A substring obtém as primeiras quatro letras de cada nome de diretório. A substring especifica as posições de início e fim do caractere. O parâmetro SingleQuote encapsula os nomes de diretório com aspas simples. O parâmetro Separator especifica o uso de um ponto-e-vírgula (;) para separar os nomes de diretório.
Para obter mais informações sobre variáveis automáticas e substrings, consulte about_Automatic_Variables e Substring.
Exemplo 3: Exibir saída de junção em uma linha separada
Este exemplo une nomes de serviço com cada serviço em uma linha separada e recuado por uma guia.
Get-Service -Name se* | Join-String -Property Name -Separator "`r`n`t" -OutputPrefix "Services:`n`t"
Services:
seclogon
SecurityHealthService
SEMgrSvc
SENS
Sense
SensorDataService
SensorService
SensrSvc
SessionEnvGet-Service usa o parâmetro Name com para especificar serviços que começam com se*. O asterisco (*) é um curinga para qualquer personagem.
Os objetos são enviados pelo pipeline para Join-String que use o parâmetro Property para especificar os nomes de serviço. O parâmetro Separator especifica três caracteres especiais que representam um retorno de carro (`r), newline (`n) e tab (`t). O OutputPrefix insere um rótulo Services: com uma nova linha e guia antes da primeira linha de saída.
Para obter mais informações sobre caracteres especiais, consulte about_Special_Characters.
Exemplo 4: Criar uma definição de classe a partir de um objeto
Este exemplo gera uma definição de classe do PowerShell usando um objeto existente como modelo.
Este exemplo de código usa splatting para reduzir o comprimento da linha e melhorar a legibilidade. Para obter mais informações, consulte about_Splatting.
$obj = [pscustomobject] @{Name = "Joe"; Age = 42}
$parms = @{
Property = "Name"
FormatString = ' ${0}'
OutputPrefix = "class {`n"
OutputSuffix = "`n}`n"
Separator = "`n"
}
$obj.PSObject.Properties | Join-String @parms
class {
$Name
$Age
}Parâmetros
-DoubleQuote
Encapsula o valor da cadeia de caracteres de cada objeto de pipeline entre aspas duplas.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FormatString
Especifica uma cadeia de caracteres de formato que especifica como cada objeto de pipeline deve ser formatado antes de uni-los. Use o espaço reservado {0} para representar o objeto atual. Se você precisar manter as chaves ({}) na cadeia formatada, você pode escapar delas dobrando as chaves ({{ e }}).
Para obter mais informações, consulte o método String.Format e Formatação composta.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Especifica o texto a ser associado. Insira uma variável que contenha o texto ou digite um comando ou expressão que faça com que os objetos se juntem em cadeias de caracteres.
| Type: | PSObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OutputPrefix
Texto inserido antes da cadeia de caracteres de saída. A cadeia de caracteres pode conter caracteres especiais, como retorno de carro (`r), nova linha (`n) e tabulação (`t).
| Type: | String |
| Aliases: | op |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OutputSuffix
Texto anexado à cadeia de caracteres de saída. A cadeia de caracteres pode conter caracteres especiais, como retorno de carro (`r), nova linha (`n) e tabulação (`t).
| Type: | String |
| Aliases: | os |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Property
O nome de uma propriedade, ou uma expressão de propriedade, a ser convertida em texto.
| Type: | PSPropertyExpression |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Separator
Texto ou caracteres, como vírgula ou ponto-e-vírgula, inseridos entre o texto de cada objeto de pipeline.
Por padrão, os objetos de pipeline são unidos sem um separador. Se a variável de preferência Separador de Campo de Saída ($OFS) estiver definida, esse valor será usado, a menos que esse parâmetro seja especificado.
Nota
Quando você define $OFS seu valor é usado para unir matrizes quando elas são convertidas em cadeias de caracteres até que a variável seja redefinida para $null. Como o uso $OFS pode ter efeitos não intencionais em outro lugar do código, é melhor usar o parâmetro Separator .
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SingleQuote
Encapsula o valor da cadeia de caracteres de cada objeto de pipeline entre aspas simples.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseCulture
Usa o separador de lista para a cultura atual como o delimitador de item. Para localizar o separador de lista para uma cultura, use o seguinte comando: (Get-Culture).TextInfo.ListSeparator.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Saídas
Ligações Relacionadas
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários