Invia l'output a un file.
Sintassi
Out-File [-FilePath] <string> [[-Encoding] <string>] [-Append] [-Force] [-InputObject <psobject>] [-NoClobber] [-Width <int>] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrizione
Il cmdlet Out-File invia l'output a un file. È possibile utilizzare questo cmdlet anziché l'operatore di reindirizzamento (>) quando è necessario utilizzarne i parametri.
Parametri
-Append
Aggiunge l'output alla fine di un file esistente, anziché sostituire il contenuto esistente del file.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Encoding <string>
Specifica il tipo di codifica dei caratteri utilizzata nel file. I valori validi sono "Unicode", "UTF7", "UTF8", "UTF32", "ASCII", "BigEndianUnicode", "Default" e "OEM". Il valore predefinito è "Unicode".
Con "Default" verrà utilizzata la codifica della tabella codici ANSI corrente del sistema.
Con "OEM" verrà utilizzato l'identificatore della tabella codici corrente del produttore dell'hardware originale per il sistema operativo.
|
Obbligatorio? |
false |
|
Posizione? |
2 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-FilePath <string>
Specifica il percorso del file di output.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Force
Consente al cmdlet di sovrascrivere un file di sola lettura esistente. Quando si utilizza il parametro Force, il cmdlet non può ignorare le limitazioni di sicurezza.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-InputObject <psobject>
Specifica gli oggetti da scrivere nel file. Immettere una variabile contenente gli oggetti oppure digitare un comando o un'espressione che consente di ottenere gli oggetti.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByValue) |
|
Accettare caratteri jolly? |
false |
-NoClobber
Impedisce che venga sovrascritto, ovvero sostituito, il contenuto di un file esistente. Per impostazione predefinita, se nel percorso specificato è presente un file, Out-File lo sovrascrive senza visualizzare alcun avviso. Se vengono utilizzati sia Append che NoClobber, l'output verrà accodato al file esistente.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Width <int>
Specifica il numero di caratteri di ogni riga di output. Eventuali caratteri aggiuntivi vengono troncati e non portati a capo. Se si omette questo parametro, la larghezza verrà determinata dalle caratteristiche dell'host. Il valore predefinito per la console di Windows PowerShell è 80 (caratteri).
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Confirm
Chiede una conferma prima di eseguire il comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-WhatIf
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
|
Input |
System.Management.Automation.PSObject È possibile reindirizzare qualsiasi oggetto a Out-File. |
|
Output |
Nessuno Out-File non genera alcun output. |
Note
I cmdlet di tipo Out non consentono di formattare gli oggetti ma solo di eseguirne il rendering e di inviarli alla destinazione di visualizzazione specificata. Un oggetto non formattato inviato a un cmdlet di tipo Out verrà inviato a un cmdlet di formattazione prima di eseguirne il rendering.
Con i cmdlet di tipo Out non sono disponibili parametri per nomi o percorsi di file. Per inviare i dati a un cmdlet che contiene il verbo Out (cmdlet Out), utilizzare un operatore pipeline (|) per inviare l'output di un comando di Windows PowerShell al cmdlet. È inoltre possibile archiviare i dati in una variabile e utilizzare il parametro InputObject per passare i dati al cmdlet. Per informazioni, vedere gli esempi.
Out-File invia i dati ma non crea oggetti di output. Se si reindirizza l'output di Out-File a Get-Member, Get-Member segnalerà che non sono stati specificati oggetti.
Esempio 1
C:\PS>get-process | out-file -filepath C:\Test1\process.txt Descrizione ----------- Tramite questo comando un elenco dei processi disponibili nel computer verrà inviato al file Process.txt. Se il file non esiste, Out-File lo crea automaticamente. Poiché il nome del parametro FilePath è facoltativo, è possibile ometterlo e inviare il comando equivalente "get-process | outfile C:\Test1\process.txt".
Esempio 2
C:\PS>get-process | out-file C:\Test1\process.txt -noclobber Out-File : File C:\Test1\process.txt already exists and NoClobber was specified. At line:1 char:23 + get-process | out-file <<<< process.txt -noclobber Descrizione ----------- Anche tramite questo comando un elenco dei processi verrà inviato al file Process.txt, tuttavia verrà utilizzato il parametro NoClobber, che impedisce la sovrascrittura di un file esistente. Nell'output sarà incluso il messaggio di errore che verrà visualizzato quando si utilizza NoClobber con un file esistente.
Esempio 3
C:\PS>$a = get-process C:\PS> out-file -filepath C:\Test1\process.txt -inputobject $a -encoding ASCII -width 50 Descrizione ----------- Tramite questi comandi un elenco dei processi disponibili nel computer verrà inviato al file Process.txt. Il testo viene codificato in formato ASCII in modo da poter essere letto da programmi di ricerca come Findstr e Grep. Per impostazione predefinita, Out-File utilizza il formato Unicode. Tramite il primo comando verrà ottenuto l'elenco dei processi disponibili nel computer che verranno quindi archiviati nella variabile $a. Nel secondo comando verrà utilizzato il cmdlet Out-File per inviare l'elenco al file Process.txt. Verrà utilizzato il parametro InputObject per specificare che l'input è disponibile nella variabile $a. Verranno quindi utilizzati il parametro Encoding per convertire l'output in formato ASCII e il parametro Width per limitare ciascuna riga del file a 50 caratteri. Poiché le righe dell'ouput vengono troncate a 50 caratteri, la colonna all'estrema destra della tabella dei processi verrà omessa.
Esempio 4
C:\PS>set-location hklm:\software c:\PS>get-acl mycompany\mykey | out-file -filepath c:\ps\acl.txt c:\PS>get-acl mycompany\mykey | out-file -filepath filesystem::acl.txt Descrizione ----------- Con questi comandi viene illustrato l'utilizzo del cmdlet Out-File quando non viene utilizzata un'unità FileSystem. Tramite il primo comando la posizione corrente verrà impostata sulla chiave del Registro di sistema HKLM:\Software. Il secondo e il terzo comando hanno lo stesso effetto. Viene utilizzato il cmdlet Get-Acl per ottenere il descrittore di sicurezza della sottochiave del Registro di sistema MyKey (HKLM\Software\MyCompany\MyKey). Un operatore pipeline passa il risultato al cmdlet Out-File, che lo invia al file Acl.txt. Poiché Out-File non è supportato dal provider del Registro di sistema di Windows PowerShell, è necessario specificare il nome dell'unità del file system, ad esempio "c:", oppure il nome del provider seguito per due volte dai due punti, ad esempio "FileSystem::", nel valore del parametro FilePath. Questi metodi verranno illustrati nel secondo e nel terzo comando.
Vedere anche