Condividi tramite

Out-String

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Invia gli oggetti all'host come una serie di stringhe.

Sintassi

Out-String
   [-Stream]
   [-Width <Int32>]
   [-InputObject <PSObject>]
   [<CommonParameters>]

Descrizione

Il Out-String cmdlet converte gli oggetti gestiti Windows PowerShell in una matrice di stringhe. Per impostazione predefinita, Out-String accumula le stringhe e le restituisce come singola stringa, ma è possibile usare il parametro Stream per indirizzare Out-String la restituzione di una stringa alla volta. Questo cmdlet consente di modificare ed eseguire ricerche nell'output delle stringhe in modo simile alle shell tradizionali, in cui la modifica degli oggetti risulta meno efficiente.

Esempio

Esempio 1: Restituire testo nella console come stringa

PS C:\> Get-Content C:\test1\testfile2.txt | Out-String

Questo comando invia il contenuto del file Testfile2.txt alla console in un'unica stringa. Usa il Get-Content cmdlet per ottenere il contenuto del file. L'operatore pipeline (|) invia il contenuto a Out-String, che invia il contenuto alla console come stringa.

Esempio 2: Ottenere le impostazioni cultura correnti e convertire i dati in stringhe

Il primo comando usa il Get-Culture cmdlet per ottenere le impostazioni internazionali. L'operatore pipeline (|) invia il risultato al Select-Object cmdlet , che seleziona tutte le proprietà (*) dell'oggetto Get-Culture impostazioni cultura restituito. Il comando archivia quindi i risultati nella $C variabile .

Il secondo comando usa il Out-String cmdlet per convertire l'oggetto CultureInfo in una serie di stringhe (una stringa per ogni proprietà). Usa il parametro InputObject per passare la $C variabile a Out-String. Il parametro Width è impostato su 100 caratteri per riga per evitare il troncamento.

PS C:\> $C = Get-Culture | Select-Object *
PS C:\> Out-String -InputObject $C -Width 100

Questi comandi ottengono le impostazioni internazionali dell'utente corrente e convertono i dati in stringhe.

Esempio 3: Utilizzo di oggetti

PS C:\> Get-Alias | Out-String -Stream | Select-String "Get-Command"

Questo esempio illustra la differenza tra l'utilizzo di oggetti e l'utilizzo di stringhe. Il comando visualizza gli alias che includono la frase "Get-Command". Usa il Get-Alias cmdlet per ottenere un set di oggetti AliasInfo (uno per ogni alias nella sessione corrente).

L'operatore pipeline (|) invia l'output del Get-Alias cmdlet al Out-String cmdlet , che converte gli oggetti in una serie di stringhe. Usa il parametro Stream di Out-String per inviare ogni stringa singolarmente, anziché concatenarle in una singola stringa. Un altro operatore pipeline invia le stringhe al Select-String cmdlet , che seleziona le stringhe che includono "Get-Command" in qualsiasi punto della stringa.

Se si omette il parametro Stream, il comando visualizza tutti gli alias, perché Select-String trova "Get-Command" nella singola stringa che Out-String restituisce e il formattatore visualizza la stringa come tabella.

Parametri

-InputObject

Specifica gli oggetti da scrivere in una stringa. Immettere una variabile che contiene gli oggetti oppure digitare un comando o un'espressione che ottiene gli oggetti.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Stream

Indica che il cmdlet invia le stringhe per ogni oggetto separatamente. Per impostazione predefinita, le stringhe per ogni oggetto vengono accumulate e inviate in un'unica stringa.

Per usare il parametro Stream, digitare -Stream o il relativo alias, ost.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Width

Specifica il numero di caratteri di ogni riga di output. Eventuali caratteri aggiuntivi vengono troncati e non portati a capo. Il parametro Width si applica solo agli oggetti formattati. Se si omette questo parametro, la larghezza verrà determinata dalle caratteristiche del programma host. Il valore predefinito per la console di Windows PowerShell è 80 (caratteri).

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

PSObject

È possibile inviare oggetti tramite pipe a Out-String.

Output

String

Out-String restituisce la stringa creata dall'oggetto di input.

Note

  • Cmdlet che contengono il verbo Out che non formattano oggetti; e li inviano alla destinazione di visualizzazione specificata. Se si invia un oggetto non formattato a un cmdlet Out, il cmdlet lo invia a un cmdlet di formattazione prima di eseguirne il rendering.
  • I cmdlet Out non dispongono di parametri che accettano nomi o percorsi di file. Per inviare dati a un cmdlet Out, usare un operatore pipeline (|) per inviare l'output di un comando di Windows PowerShell al cmdlet. È anche possibile archiviare i dati in una variabile e usare il parametro InputObject per passare i dati al cmdlet.