Out-File

Out-File
    [-FilePath] <string>
    [[-Encoding] <string>]
    [-Append]
    [-Force]
    [-NoClobber]
    [-Width <int>]
    [-NoNewline]
    [-InputObject <psobject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Out-File
    [[-Encoding] <string>]
    -LiteralPath <string>
    [-Append]
    [-Force]
    [-NoClobber]
    [-Width <int>]
    [-NoNewline]
    [-InputObject <psobject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Das Cmdlet Out-File sendet die Ausgabe an eine Datei. Wenn Sie Parameter für die Ausgabe angeben müssen, verwenden Sie Out-File anstelle des Umleitungsoperators (>).

In diesem Beispiel wird gezeigt, wie eine Liste der Prozesse des lokalen Computers an eine Datei gesendet wird. Wenn die Datei nicht vorhanden ist, erstellt Out-File die Datei im angegebenen Pfad.

Get-Process | Out-File -FilePath .\Process.txt
Get-Content -Path .\Process.txt

 NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
     29    22.39      35.40      10.98   42764   9 Application
     53    99.04     113.96       0.00   32664   0 CcmExec
     27    96.62     112.43     113.00   17720   9 Code

Das Cmdlet Get-Process ruft die Liste der Prozesse ab, die auf dem lokalen Computer ausgeführt werden. Die Process-Objekte werden an das Cmdlet Out-File weitergeleitet. Out-File verwendet den FilePath Parameter und erstellt eine Datei im aktuellen Verzeichnis namens Process.txt. Der Befehl Get-Content ruft Inhalt aus der Datei ab und zeigt ihn in der PowerShell-Konsole an.

In diesem Beispiel wird verhindert, dass eine vorhandene Datei überschrieben wird. Standardmäßig überschreibt Out-File vorhandene Dateien.

Get-Process | Out-File -FilePath .\Process.txt -NoClobber

Out-File : The file 'C:\Test\Process.txt' already exists.
At line:1 char:15
+ Get-Process | Out-File -FilePath .\Process.txt -NoClobber
+               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Das Cmdlet Get-Process ruft die Liste der Prozesse ab, die auf dem lokalen Computer ausgeführt werden. Die Process-Objekte werden an das Cmdlet Out-File weitergeleitet. Out-File verwendet den parameter FilePath und versucht, in eine Datei im aktuellen Verzeichnis namens Process.txtzu schreiben. Der NoClobber Parameter verhindert, dass die Datei überschrieben wird, und zeigt eine Meldung an, dass die Datei bereits vorhanden ist.

In diesem Beispiel wird gezeigt, wie die Ausgabe mit einem bestimmten Codierungstyp codiert wird.

$Procs = Get-Process
Out-File -FilePath .\Process.txt -InputObject $Procs -Encoding ASCII -Width 50

Das Cmdlet Get-Process ruft die Liste der Prozesse ab, die auf dem lokalen Computer ausgeführt werden. Die Process-Objekte werden in der Variablen $Procsgespeichert. Out-File verwendet den FilePath Parameter und erstellt eine Datei im aktuellen Verzeichnis namens Process.txt. Der parameter InputObject übergibt die Prozessobjekte in $Procs an die Datei Process.txt. Der parameter Encoding konvertiert die Ausgabe in ASCII--Format. Die Width Parameter beschränkt jede Zeile in der Datei auf 50 Zeichen, sodass einige Daten möglicherweise abgeschnitten werden.

In diesem Beispiel wird gezeigt, wie das Out-File Cmdlet verwendet wird, wenn Sie sich nicht auf einem FileSystem-Anbieterlaufwerk befinden. Verwenden Sie das Cmdlet Get-PSProvider, um die Anbieter auf Ihrem lokalen Computer anzuzeigen. Weitere Informationen finden Sie unter über_Anbieter.

PS> Set-Location -Path Alias:

PS> Get-Location

Path
----
Alias:\

PS> Get-ChildItem | Out-File -FilePath C:\TestDir\AliasNames.txt

PS> Get-Content -Path C:\TestDir\AliasNames.txt

CommandType     Name
-----------     ----
Alias           % -> ForEach-Object
Alias           ? -> Where-Object
Alias           ac -> Add-Content
Alias           cat -> Get-Content

Der Befehl Set-Location verwendet den Parameter Path, um den aktuellen Speicherort auf den Registrierungsanbieter Alias:festzulegen. Das Cmdlet Get-Location zeigt den vollständigen Pfad für Alias:an. Get-ChildItem sendet Objekte an das Cmdlet Out-File. Out-File verwendet den parameter FilePath, um den vollständigen Pfad und Dateinamen für die Ausgabe anzugeben, C:\TestDir\AliasNames.txt. Das cmdlet Get-Content verwendet den parameter Path und zeigt den Inhalt der Datei in der PowerShell-Konsole an.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Sie können jedes Objekt an Out-Filepfeifen.

Out-File generiert keine Ausgabe.

Die Out Cmdlets formatieren keine Objekte, sondern rendern sie lediglich und senden sie an das angegebene Anzeigeziel. Wenn Sie ein unformatiertes Objekt an ein Out-Cmdlet senden, sendet das Cmdlet es an ein Formatierungs-Cmdlet, bevor es gerendert wird.

Verwenden Sie die Pipeline, um die Ausgabe eines PowerShell-Befehls an das cmdlet Out-File zu senden. Sie können Daten in einer Variablen speichern und den InputObject-Parameter verwenden, um Daten an das Out-File Cmdlet zu übergeben.

Out-File Sendet Daten, erzeugt jedoch keine Ausgabeobjekte. Wenn Sie die Ausgabe von Out-File an Get-Memberübergeben, meldet das Cmdlet Get-Member , dass keine Objekte angegeben wurden.