Join-String

Sintassi

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>]

Descrizione

Il cmdlet Join-String unisce o combina testo da oggetti pipeline in una singola stringa.

Se non vengono specificati parametri, gli oggetti pipeline vengono convertiti in una stringa e uniti con il separatore predefinito $OFS.

Specificando un nome di proprietà, il valore della proprietà viene convertito in una stringa e unito in una stringa.

Anziché un nome di proprietà, è possibile usare un blocco di script. Il risultato del blocco di script viene convertito in una stringa prima che venga unito al risultato. Può combinare il testo della proprietà di un oggetto o il risultato dell'oggetto convertito in una stringa.

Questo cmdlet è stato introdotto in PowerShell 6.2.

Esempio

Esempio 1: Aggiungere nomi di directory

Questo esempio unisce i nomi di directory, esegue il wrapping dell'output tra virgolette doppie e separa i nomi di directory con una virgola e uno spazio (, ). L'output è un oggetto stringa.

Get-ChildItem -Directory C:\ | Join-String -Property Name -DoubleQuote -Separator ', '

"PerfLogs", "Program Files", "Program Files (x86)", "Users", "Windows"

usa il parametro directory di per ottenere tutti i nomi di directory per l'unità . Gli oggetti vengono inviati alla pipeline per Join-String. Il parametro proprietà specifica i nomi di directory. Il parametro DoubleQuote esegue il wrapping dei nomi di directory con virgolette doppie. Il parametro separatore consente di usare una virgola e uno spazio () per separare i nomi di directory.

Gli oggetti Get-ChildItem sono System.IO.DirectoryInfo e Join-String converte gli oggetti in System.String.

Esempio 2: Usare una sottostringa di proprietà per aggiungere nomi di directory

Questo esempio usa un metodo di sottostringa per ottenere le prime quattro lettere di nomi di directory, esegue il wrapping dell'output tra virgolette singole e separa i nomi di directory con un punto e virgola (;).

Get-ChildItem -Directory C:\ | Join-String -Property {$_.Name.SubString(0,4)} -SingleQuote -Separator ';'

'Perf';'Prog';'Prog';'User';'Wind'

usa il parametro directory di per ottenere tutti i nomi di directory per l'unità . Gli oggetti vengono inviati alla pipeline per Join-String.

Il blocco di script proprietà utilizza la variabile automatica () per specificare la sottostringa della proprietà Nome di ogni oggetto. La sottostringa ottiene le prime quattro lettere di ogni nome di directory. La sottostringa specifica le posizioni iniziale e finale del carattere. Il parametro SingleQuote esegue il wrapping dei nomi di directory con virgolette singole. Il parametro separatore consente di utilizzare un punto e virgola () per separare i nomi di directory.

Per altre informazioni sulle variabili automatiche e le sottostringhe, vedere about_Automatic_Variables e substring.

Esempio 3: Visualizzare l'output di join in una riga separata

Questo esempio unisce i nomi dei servizi a ogni servizio in una riga separata e rientrati da una scheda.

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
    SessionEnv

usa il parametro Name con per specificare i servizi che iniziano con . L'asterisco (*) è un carattere jolly per qualsiasi carattere.

Gli oggetti vengono inviati alla pipeline per che usa il parametro proprietà per specificare i nomi del servizio. Il parametro separatore specifica tre caratteri speciali che rappresentano un ritorno a capo (), nuova riga () e tabulazioni (). Il OutputPrefix inserisce un'etichetta Services: con una nuova riga e una nuova scheda prima della prima riga di output.

Per altre informazioni sui caratteri speciali, vedere about_Special_Characters.

Esempio 4: Creare una definizione di classe da un oggetto

Questo esempio genera una definizione di classe di PowerShell usando un oggetto esistente come modello.

Questo esempio di codice usa lo splatting per ridurre la lunghezza della riga e migliorare la leggibilità. Per altre informazioni, vedere 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
}

Parametri

-DoubleQuote

-FormatString

-InputObject

-OutputPrefix

-OutputSuffix

-Property

-Separator

-SingleQuote

-UseCulture

Input

PSObject

Output

String

Collegamenti correlati

• about_Automatic_Variables
• about_Special_Characters
• Sottostringa