Out-File
Hiermee wordt uitvoer naar een bestand verzonden.
Syntax
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>]
Description
De Out-File
cmdlet verzendt uitvoer naar een bestand. Het maakt impliciet gebruik van het opmaaksysteem van PowerShell om naar het bestand te schrijven. Het bestand ontvangt dezelfde weergaveweergave als de terminal. Dit betekent dat de uitvoer mogelijk niet ideaal is voor programmatische verwerking, tenzij alle invoerobjecten tekenreeksen zijn.
Wanneer u parameters voor de uitvoer moet opgeven, gebruikt Out-File
u in plaats van de omleidingsoperator (>
). Zie about_Redirection voor meer informatie over omleiding.
Voorbeelden
Voorbeeld 1: Uitvoer verzenden en een bestand maken
In dit voorbeeld ziet u hoe u een lijst met processen van de lokale computer naar een bestand verzendt. Als het bestand niet bestaat, Out-File
maakt u het bestand in het opgegeven pad.
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
De Get-Process
cmdlet haalt de lijst met processen op die worden uitgevoerd op de lokale computer. De procesobjecten worden via de pijplijn naar de Out-File
cmdlet verzonden. Out-File
gebruikt de parameter FilePath en maakt een bestand in de huidige map met de naam Process.txt. Met de Get-Content
opdracht wordt inhoud uit het bestand opgehaald en weergegeven in de PowerShell-console.
Voorbeeld 2: Voorkomen dat een bestaand bestand wordt overschreven
In dit voorbeeld voorkomt u dat een bestaand bestand wordt overschreven. Bestaande bestanden worden standaard Out-File
overschreven.
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
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
De Get-Process
cmdlet haalt de lijst met processen op die worden uitgevoerd op de lokale computer. De procesobjecten worden via de pijplijn naar de Out-File
cmdlet verzonden. Out-File
gebruikt de parameter FilePath en probeert te schrijven naar een bestand in de huidige map met de naam Process.txt. De parameter NoClobber voorkomt dat het bestand wordt overschreven en geeft een bericht weer dat het bestand al bestaat.
Voorbeeld 3: Uitvoer verzenden naar een bestand in ASCII-indeling
In dit voorbeeld ziet u hoe u uitvoer coderen met een specifiek coderingstype.
$Procs = Get-Process
Out-File -FilePath .\Process.txt -InputObject $Procs -Encoding ASCII -Width 50
De Get-Process
cmdlet haalt de lijst met processen op die worden uitgevoerd op de lokale computer. De procesobjecten worden opgeslagen in de variabele. $Procs
Out-File
gebruikt de parameter FilePath en maakt een bestand in de huidige map met de naam Process.txt. De parameter InputObject geeft de procesobjecten $Procs
door aan het bestand Process.txt. Met de coderingsparameter wordt de uitvoer geconverteerd naar de ASCII-indeling . De parameter Width beperkt elke regel in het bestand tot 50 tekens, zodat sommige gegevens mogelijk worden afgekapt.
Voorbeeld 4: Een provider gebruiken en uitvoer verzenden naar een bestand
In dit voorbeeld ziet u hoe u de Out-File
cmdlet gebruikt wanneer u zich niet in een bestandssysteemproviderstation bevindt . Gebruik de Get-PSProvider
cmdlet om de providers op uw lokale computer weer te geven. Zie about_Providers voor meer informatie.
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
De Set-Location
opdracht gebruikt de parameter Path om de huidige locatie in te stellen op de registerprovider Alias:
. De Get-Location
cmdlet geeft het volledige pad voor Alias:
.
Get-ChildItem
verzendt objecten in de pijplijn naar de Out-File
cmdlet. Out-File
gebruikt de parameter FilePath om het volledige pad en de bestandsnaam voor de uitvoer C :\TestDir\AliasNames.txt op te geven. De Get-Content
cmdlet gebruikt de parameter Path en geeft de inhoud van het bestand weer in de PowerShell-console.
Voorbeeld 5: Breedte van bestandsuitvoer instellen voor volledig bereik
In dit voorbeeld wordt de $PSDefaultParameterValues
Width
parameter voor alle aanroepen van Out-File
en de omleidingsoperartors (>
en >>
) ingesteld op 2000. Dit zorgt ervoor dat powerShell overal binnen het huidige bereik gegevens uitvoert die zijn opgemaakt voor bestanden, een lijnbreedte van 2000 gebruikt in plaats van een lijnbreedte die wordt bepaald door de consolebreedte van de PowerShell-host.
function DemoDefaultOutFileWidth() {
try {
$PSDefaultParameterValues['out-file:width'] = 2000
$logFile = "$pwd\logfile.txt"
Get-ChildItem Env:\ > $logFile
Get-Service -ErrorAction Ignore |
Format-Table -AutoSize |
Out-File $logFile -Append
Get-Process | Format-Table Id,SI,Name,Path,MainWindowTitle >> $logFile
}
finally {
$PSDefaultParameterValues.Remove('out-file:width')
}
}
DemoDefaultOutFileWidth
Zie about_Preference_Variables voor meer informatie over$PSDefaultParameterValues
.
Parameters
-Append
Voegt de uitvoer toe aan het einde van een bestaand bestand. Als er geen codering is opgegeven, gebruikt de cmdlet de standaardcodering. Deze codering komt mogelijk niet overeen met de codering van het doelbestand. Dit is hetzelfde gedrag als de omleidingsoperator (>>
).
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Encoding
Hiermee geeft u het type codering voor het doelbestand. De standaardwaarde is unicode
.
De acceptabele waarden voor deze parameter zijn als volgt:
ascii
Maakt gebruik van ASCII-tekenset (7-bits).bigendianunicode
Maakt gebruik van UTF-16 met de bytevolgorde big-endian.default
Maakt gebruik van de codering die overeenkomt met de actieve codepagina van het systeem (meestal ANSI).oem
Maakt gebruik van de codering die overeenkomt met de huidige OEM-codepagina van het systeem.string
Hetzelfde alsunicode
.unicode
Maakt gebruik van UTF-16 met de bytevolgorde little-endian.unknown
Hetzelfde alsunicode
.utf7
Maakt gebruik van UTF-7.utf8
Maakt gebruik van UTF-8.utf32
Maakt gebruik van UTF-32 met de bytevolgorde little-endian.
Type: | String |
Accepted values: | ASCII, BigEndianUnicode, Default, OEM, String, Unicode, Unknown, UTF7, UTF8, UTF32 |
Position: | 1 |
Default value: | Unicode |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FilePath
Hiermee geeft u het pad naar het uitvoerbestand.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Overschrijft het kenmerk Alleen-lezen en overschrijft een bestaand alleen-lezenbestand. De parameter Force overschrijft geen beveiligingsbeperkingen.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Hiermee geeft u de objecten die naar het bestand moeten worden geschreven. Voer een variabele in die de objecten bevat of typ een opdracht of expressie waarmee de objecten worden opgehaald.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LiteralPath
Hiermee geeft u het pad naar het uitvoerbestand. De parameter LiteralPath wordt precies gebruikt zoals deze is getypt. Jokertekens worden niet geaccepteerd. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens geven PowerShell aan dat er geen tekens als escapereeksen moeten worden geïnterpreteerd. Zie about_Quoting_Rules voor meer informatie.
Type: | String |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoClobber
NoClobber voorkomt dat een bestaand bestand wordt overschreven en geeft een bericht weer dat het bestand al bestaat. Als er een bestand in het opgegeven pad bestaat, Out-File
overschrijft u het bestand standaard zonder waarschuwing.
Type: | SwitchParameter |
Aliases: | NoOverwrite |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoNewline
Hiermee geeft u op dat de inhoud die naar het bestand wordt geschreven, niet eindigt met een nieuw regelteken. De tekenreeksweergaven van de invoerobjecten worden samengevoegd om de uitvoer te vormen. Er worden geen spaties of nieuwe regels ingevoegd tussen de uitvoertekenreeksen. Er wordt geen nieuwe regel toegevoegd na de laatste uitvoertekenreeks.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Width
Hiermee geeft u het maximum aantal tekens in elke regel uitvoer. Eventuele extra tekens worden afgekapt, niet verpakt. Als deze parameter niet wordt gebruikt, wordt de breedte bepaald door de kenmerken van de host. De standaardwaarde voor de PowerShell-console is 80 tekens. Als u de breedte wilt bepalen voor alle aanroepen van Out-File
en de omleidingsoperators (>
en >>
), stelt u deze in voordat u deze gebruikt $PSDefaultParameterValues['out-file:width'] = 2000
Out-File
.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
U kunt elk object doorsluisen naar deze cmdlet.
Uitvoerwaarden
None
Deze cmdlet retourneert geen uitvoer.
Notities
Invoerobjecten worden automatisch opgemaakt zoals ze in de terminal zouden staan, maar u kunt een Format-*
cmdlet gebruiken om expliciet de opmaak van de uitvoer naar het bestand te beheren. Bijvoorbeeld Get-Date | Format-List | Out-File out.txt
Gebruik de pijplijn om de uitvoer van een PowerShell-opdracht naar de Out-File
cmdlet te verzenden. U kunt ook gegevens opslaan in een variabele en de parameter InputObject gebruiken om gegevens door te geven aan de Out-File
cmdlet.
Out-File
slaat gegevens op in een bestand, maar er worden geen uitvoerobjecten naar de pijplijn geproduceerd.
Verwante koppelingen
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor