Condividi tramite

Out-String

Modulo:
Microsoft.PowerShell.Utility Module

Invia oggetti all'host come una serie di stringhe.

Sintassi

Default (Impostazione predefinita) 

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

Descrizione

Il cmdlet Out-String converte gli oggetti gestiti da Windows PowerShell in una matrice di stringhe. Per impostazione predefinita, accumula le stringhe e le restituisce come singola stringa, ma è possibile usare il parametro stream per indirizzare per restituire una stringa alla volta. Questo cmdlet consente di cercare e modificare l'output della stringa come si farebbe nelle shell tradizionali quando la manipolazione degli oggetti è meno conveniente.

Esempio

Esempio 1: Output del 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 come singola stringa. Usa il cmdlet Get-Content 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 cmdlet Get-Culture per ottenere le impostazioni internazionali. L'operatore pipeline (|) invia il risultato al cmdlet Select-Object, che seleziona tutte le proprietà (*) dell'oggetto impostazioni cultura che Get-Culture restituito. Il comando archivia quindi i risultati nella variabile $C.

Il secondo comando usa il cmdlet per convertire l'oggetto cultureInfo in una serie di stringhe (una stringa per ogni proprietà). Usa il parametro InputObject per passare la variabile a . 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 per l'utente corrente e convertono i dati in stringhe.

Esempio 3: Utilizzo degli oggetti

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

In questo esempio viene illustrata 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 cmdlet Get-Alias per ottenere un set di oggetti AliasInfo (uno per ogni alias nella sessione corrente).

L'operatore pipeline (|) invia l'output del cmdlet Get-Alias al cmdlet Out-String, 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 cmdlet Select-String, che seleziona le stringhe che includono "Get-Command" ovunque nella stringa.

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

Parametri

-InputObject

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

Proprietà dei parametri

Tipo:PSObject
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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 come singola stringa.

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Width

Specifica il numero di caratteri in ogni riga di output. Eventuali caratteri aggiuntivi vengono troncati, non di cui è stato eseguito il wrapping. Il parametro Width si applica solo agli oggetti formattati. Se si omette questo parametro, la larghezza viene determinata dalle caratteristiche del programma host. Il valore predefinito per la console di Windows PowerShell è 80 (caratteri).

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

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 gli oggetti; li eseguono semplicemente il rendering 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 eseguire il rendering.
  • I cmdlet out non dispongono di parametri che accettano nomi o percorsi di file. Per inviare dati a un cmdlet out di , 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.