Join-String
Combina oggetti dalla pipeline in una singola stringa.
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 Join-String cmdlet 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 $OFSpredefinito .
Nota
Quando si imposta $OFS il relativo valore viene usato per unire matrici quando vengono convertite in stringhe fino a quando la variabile non viene reimpostata su $null. Poiché l'uso $OFS di può avere effetti imprevisti altrove nel codice, è preferibile usare invece il parametro Separator .
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"Get-ChildItem usa il parametro Directory per ottenere tutti i nomi di directory per l'unità C:\ .
Gli oggetti vengono inviati alla pipeline a Join-String. Il parametro Property specifica i nomi di directory. Il parametro DoubleQuote esegue il wrapping dei nomi di directory con virgolette doppie.
Il parametro Separator consente di utilizzare una virgola e uno spazio (, ) per separare i nomi di directory.
Gli Get-ChildItem oggetti sono System.IO.DirectoryInfo e Join-String convertono 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'Get-ChildItem usa il parametro Directory per ottenere tutti i nomi di directory per l'unità C:\ .
Gli oggetti vengono inviati alla pipeline a Join-String.
Il blocco script del parametro Property usa la variabile automatica ($_) per specificare la sottostringa della proprietà Name 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 Separator consente di specificare l'utilizzo di 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
SessionEnvGet-Service usa il parametro Name con per specificare i servizi che iniziano con se*. L'asterisco (*) è un carattere jolly per qualsiasi carattere.
Gli oggetti vengono inviati nella pipeline a Join-String che utilizza il parametro Property per specificare i nomi del servizio. Il parametro Separator consente di specificare tre caratteri speciali che rappresentano un ritorno a capo (`r), una nuova riga (`n) e una scheda (`t). 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
Esegue il wrapping del valore stringa di ogni oggetto pipeline tra virgolette doppie.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-FormatString
Specifica una stringa di formato che specifica la modalità di formattazione di ogni oggetto pipeline prima di unirle. Utilizzare il {0} segnaposto per rappresentare l'oggetto corrente. Se è necessario mantenere le parentesi graffe ({}) nella stringa formattata, è possibile eseguirne l'escape raddoppiando le parentesi graffe ({{ e }}).
Per altre informazioni, vedere il metodo String.Format e la formattazione composita.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-InputObject
Specifica il testo da unire. Immettere una variabile contenente il testo o digitare un comando o un'espressione che ottiene gli oggetti da unire in stringhe.
| Tipo: | PSObject[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-OutputPrefix
Testo inserito prima della stringa di output. La stringa può contenere caratteri speciali, ad esempio ritorno a capo (`r), nuova riga (`n) e tabulazioni (`t).
| Tipo: | String |
| Alias: | op |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-OutputSuffix
Testo aggiunto alla stringa di output. La stringa può contenere caratteri speciali, ad esempio ritorno a capo (`r), nuova riga (`n) e tabulazioni (`t).
| Tipo: | String |
| Alias: | os |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Property
Nome di una proprietà o di un'espressione di proprietà da convertire in testo.
| Tipo: | PSPropertyExpression |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Separator
Testo o caratteri, ad esempio una virgola o un punto e virgola inserito tra il testo per ogni oggetto pipeline.
Per impostazione predefinita, gli oggetti pipeline vengono uniti senza un separatore. Se la variabile di preferenza Separatore campo di output ($OFS) è impostata, tale valore viene utilizzato a meno che non venga specificato questo parametro.
Nota
Quando si imposta $OFS il relativo valore viene usato per unire matrici quando vengono convertite in stringhe fino a quando la variabile non viene reimpostata su $null. Poiché l'uso $OFS di può avere effetti imprevisti altrove nel codice, è preferibile usare invece il parametro Separator .
| Tipo: | String |
| Posizione: | 1 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-SingleQuote
Esegue il wrapping del valore stringa di ogni oggetto pipeline tra virgolette singole.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-UseCulture
Usa il separatore di elenco per le impostazioni cultura correnti come delimitatore di elemento. Per trovare il separatore di elenco per le impostazioni cultura, usare il comando seguente: (Get-Culture).TextInfo.ListSeparator.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | False |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
