stuurt uitvoer naar een bestand.
syntaxis
beschrijving
de Out-File cmdlet stuurt uitvoer naar een bestand. Het maakt impliciet gebruik van PowerShell ‘ s opmaaksysteem tohrite naar het bestand. Het bestand krijgt dezelfde weergave als de terminal. Dit betekent dat de uitvoer niet ideaal is voor programmatische verwerking tenzij alle invoerobjecten tekenreeksen zijn.,Wanneer u parameters voor de uitvoer moet opgeven, gebruikt u Out-File in plaats van de redirectionoperator (>). Zie about_Redirection voor meer informatie over omleiding.
voorbeelden
Voorbeeld 1: uitvoer verzenden en een bestand aanmaken
dit voorbeeld laat zien hoe een lijst van de processen van de lokale computer naar een bestand wordt verzonden. Als het bestand niet bestaat, maakt Out-File het bestand aan in het opgegeven pad.
de Get-Process cmdlet krijgt de lijst van processen die op de lokale computer worden uitgevoerd., De Processobjecten worden via de pijplijn naar de Out-File cmdlet gestuurd. Out-File gebruikt de Bestandspathparameter en maakt een bestand aan in de huidige map genaamd Process.txt. Het Get-Content Commando krijgt de inhoud van het bestand en toont het in de PowerShell console.
Voorbeeld 2: voorkom dat een bestaand bestand wordt overschreven
dit voorbeeld voorkomt dat een bestaand bestand wordt overschreven. Standaard overschrijft Out-File bestaande bestanden.,
de Get-Process cmdlet krijgt de lijst van processen die op de lokale computer worden uitgevoerd. De Processobjecten worden via de pijplijn naar de Out-File cmdlet gestuurd. Out-File gebruikt de Bestandspathparameter en probeert te schrijven naar een bestand in de huidige map genaamd Process.txt. De oclobber-parameter voorkomt dat het bestand wordt overschreven en geeft een bericht weer dat het bestand al bestaat.
Voorbeeld 3: Stuur uitvoer naar een bestand in ASCII-formaat
dit voorbeeld laat zien hoe uitvoer met een specifiek coderingstype moet worden gecodeerd.,
$Procs = Get-ProcessOut-File -FilePath .\Process.txt -InputObject $Procs -Encoding ASCII -Width 50de Get-Process cmdlet krijgt de lijst van processen die op de lokale computer worden uitgevoerd. De Processobjects worden opgeslagen in de variabele, $Procs. Out-File gebruikt de parameter FilePath en maakt een bestand aan in de huidige map genaamd Process.txt. De InputObject parameter geeft de procesobjecten in $Procs door aan het bestandsproces.txt. De codering parameter converteert de output naar ASCII formaat. De breedte parameter beperkt elke lijn in het dossier aan 50 karakters sosome gegevens kunnen worden afgekapt.,
Voorbeeld 4: Gebruik een provider en stuur uitvoer naar een bestand
dit voorbeeld laat zien hoe u de Out-File cmdlet gebruikt als u niet in een bestandssysteem providerdrive zit. Gebruik deGet-PSProvider cmdlet om de providers op uw lokale computer te bekijken. Voor meer informatie, zie about_Providers.
het commando Set-Location gebruikt de parameter Path om de huidige locatie in te stellen op de registryrovider Alias:. DeGet-Location cmdlet toont het volledige pad voorAlias:.,Get-ChildItem stuurt objecten door de pijplijn naar de Out-File cmdlet. Out-File gebruikt de parameter filePath om het volledige pad en de bestandsnaam voor de uitvoer te specificeren,C:\TestDir\AliasNames.txt. DeGet-Content cmdlet gebruikt de parameter Path en toont de inhoud van het bestand in de PowerShell console.
Parameters
toe voegt de uitvoer toe aan het einde van een bestaand bestand.,
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Prompts you for confirmation before running the cmdlet.,
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the type of encoding for the target file. The default value is utf8NoBOM.,
de aanvaardbare waarden voor deze parameter zijn als volgt:
-
ascii: gebruikt de codering voor de ASCII (7-bit) tekenset. -
bigendianunicode: codeert in UTF-16 formaat met behulp van de big-endian bytevolgorde. -
bigendianutf32: codeert in UTF-32 formaat met behulp van de big-endian bytevolgorde. -
oem: gebruikt de standaardcodering voor MS-DOS en console programma ‘ s. -
unicode: codeert in UTF-16 formaat met behulp van de little-endian bytevolgorde., -
utf7: codeert in UTF-7-formaat. -
utf8: codeert in UTF-8-formaat. -
utf8BOM: codeert in UTF-8-formaat met bytevolgorde Mark (BOM) -
utf8NoBOM: codeert in UTF-8-formaat zonder bytevolgorde Mark (BOM) -
utf32: codeert in UTF-32 formaat.
beginnend met PowerShell 6.,2, de coderingsparameter staat ook numerieke ID ’s toe van geregistreerde codepagina’ s (zoals -Encoding 1251) of stringnamen van geregistreerde codepagina ‘ s (zoals-Encoding "windows-1251"). Zie de.net-documentatie voor codering voor meer informatie.codetabel.
Note
UTF-7 * wordt niet langer aanbevolen. In PowerShell 7.1 wordt een waarschuwing geschreven als u utf7 specificeert voor de Coderingsparameter.,
| Type: | Encoding |
| Accepted values: | ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
| Position: | 1 |
| Default value: | UTF8NoBOM |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the path to the output file.,
| Type: | String |
| Aliases: | Path |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Overrides the read-only attribute and overwrites an existing read-only file. The Force parameterdoes not override security restrictions.,
| Type: | SwitchParameter |
| Plaats: | Naam |
| Standaard waarde: | Geen |
| Accepteren pijplijn invoer: | False |
| Accepteren wildcard tekens: | False |
hiermee Geeft u de objecten die moeten worden geschreven naar het bestand. Voer een variabele in die de objecten of typea-opdracht of expressie bevat die de objecten krijgt.,
| Type: | PSObject |
| Plaats: | Naam |
| Standaard waarde: | Geen |
| Accepteren pijplijn invoer: | True |
| Accepteren wildcard tekens: | False |
hiermee Geeft u het pad naar het output bestand. De Letteralpath parameter wordt precies gebruikt zoals het wordt getypt.Jokertekens worden niet geaccepteerd. Als het pad escape-karakters bevat, sluit het dan om in enkele aanhalingstekens., Enkele aanhalingstekens vertellen PowerShell geen tekens te interpreteren als escapesequences. Voor meer informatie, zie over_quoting_rules.,
| Type: | String |
| Aliases: | PSPath, LP |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
NoClobber prevents an existing file from being overwritten and displays a message that the filealready exists., Standaard, als een bestand bestaat in het opgegeven pad, overschrijft Out-File het bestand zonder waarschuwing.,
| Type: | SwitchParameter |
| Aliassen: | NoOverwrite |
| Plaats: | Naam |
| Standaard waarde: | Geen |
| Accepteren pijplijn input: | False |
| Accepteren jokertekens: | False |
Hiermee wordt opgegeven dat de inhoud geschreven naar het bestand niet eindigt met een newline karakter in. De stringrepresentations van de invoerobjecten worden samengevoegd om de uitvoer te vormen., Er worden geen spaties of nieuwe regels ingevoegd tussen de uitvoerstrings. Er wordt geen nieuwe regel toegevoegd na de laatste uitvoerstring.
| Type: | SwitchParameter |
| Plaats: | Naam |
| Standaard waarde: | Geen |
| Accepteren pijplijn invoer: | False |
| Accepteren wildcard tekens: | False |
Laat zien wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.,
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the number of characters in each line of output. Any additional characters are truncated,not wrapped., Als deze parameter niet wordt gebruikt, wordt de breedte bepaald door de kenmerken van de host. De standaard voor de PowerShell console is 80 tekens.
| Type: | Int32 |
| Plaats: | Naam |
| Standaard waarde: | Geen |
| Accepteren pijplijn invoer: | False |
| Accepteren wildcard tekens: | False |
Ingangen
PSObject
U kunt pijp elk object Out-File.,
uitgangen
geen
Out-File genereert geen uitvoer.
Notes
Invoerobjecten worden automatisch opgemaakt zoals ze in de terminal zouden zijn, maar u kunt eenFormat-* cmdlet gebruiken om expliciet de opmaak van de uitvoer naar het bestand te bepalen. Bijvoorbeeld,Get-Date | Format-List | Out-File out.txt
om de uitvoer van een PowerShell-commando naar de Out-File cmdlet te sturen, gebruikt u de pijplijn. U kunt ook gegevens opslaan in een variabele en de InputObject parameter gebruiken om gegevens door te geven aan de Out-Filecmdlet.,
Out-File slaat gegevens op in een bestand, maar het produceert geen uitvoerobjecten naar de pijplijn.
- about_Providers
- about_Quoting_Rules
- Out-Default
- Out-Host
- Out-Null
- Out-String
- Tee-Object
Geef een reactie