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>]

Out-File cmdlet 将输出发送到文件。 当您需要为输出指定参数时，请使用 Out-File redirection 运算符 （），而不是重定向运算符 （>）。

此示例演示如何将本地计算机进程的列表发送到文件。 如果该文件不存在，Out-File 在指定的路径中创建该文件。

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

Get-Process cmdlet 获取在本地计算机上运行的进程的列表。 进程 对象将管道发送到 Out-File cmdlet。 Out-File 使用 FilePath 参数，并在名为 Process.txt的当前目录中创建一个文件。 Get-Content 命令从文件获取内容，并将其显示在 PowerShell 控制台中。

此示例阻止覆盖现有文件。 默认情况下，Out-File 覆盖现有文件。

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
+               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Get-Process cmdlet 获取在本地计算机上运行的进程的列表。 进程 对象将管道发送到 Out-File cmdlet。 Out-File 使用 FilePath 参数，并尝试写入名为 Process.txt的当前目录中的文件。 NoClobber 参数可防止覆盖该文件，并显示一条消息，指出该文件已存在。

此示例演示如何使用特定编码类型对输出进行编码。

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

Get-Process cmdlet 获取在本地计算机上运行的进程的列表。 Process 对象存储在变量 $Procs中。 Out-File 使用 FilePath 参数，并在名为 Process.txt的当前目录中创建一个文件。 InputObject 参数将 $Procs 中的进程对象传递给文件 Process.txt。 编码 参数将输出转换为 ASCII 格式。 Width 参数将文件中的每一行限制为 50 个字符，以便可能会截断某些数据。

此示例演示如何在不 Out-File 在 FileSystem 提供程序驱动器中时使用 cmdlet。 使用 Get-PSProvider cmdlet 查看本地计算机上的提供程序。 有关详细信息，请参阅 about_Providers。

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

Set-Location 命令使用 Path 参数将当前位置设置为注册表提供程序 Alias:。 Get-Location cmdlet 显示 Alias:的完整路径。 Get-ChildItem 将管道中的对象发送到 Out-File cmdlet。 Out-File 使用 FilePath 参数指定输出的完整路径和文件名，C:\TestDir\AliasNames.txt。 Get-Content cmdlet 使用 Path 参数，并在 PowerShell 控制台中显示文件的内容。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

可以通过管道将任何对象传递给 Out-File。

Out-File 不生成任何输出。

这些 Out cmdlet 不设置对象的格式;它们只是呈现对象并将其发送到指定的显示目标。 如果将未格式化的对象发送到 Out cmdlet，则 cmdlet 会在呈现之前将其发送到格式化 cmdlet。

若要将 PowerShell 命令的输出发送到 Out-File cmdlet，请使用管道。 您可以将数据存储在变量中，并使用 InputObject 参数将数据传递给 Out-File cmdlet。

Out-File 发送数据，但它不会生成任何 output 对象。 如果通过管道传输 Out-File to Get-Member的输出，则 Get-Member cmdlet 会报告未指定任何对象。