lähettää ulostulon tiedostoon.
Syntax
Kuvaus
Out-File
cmdlet-komento lähettää tulosteen tiedostoon. Se epäsuorasti käyttää PowerShellin muotoilujärjestelmää towrite tiedostoon. Tiedosto saa saman näyttöesityksen kuin pääte. Tämä tarkoittaa sitä, että tuotos ei välttämättä ole ihanteellinen ohjelmalliseen käsittelyyn, elleivät kaikki tuloobjektit ole merkkijonoja.,Kun sinun täytyy määrittää parametrit lähtö, käytä Out-File
pikemminkin kuin redirectionoperator (>
). Lisätietoja uudelleenohjauksesta on kohdassa_redirection.
Esimerkkejä
Esimerkki 1: Lähetä tuotos ja luo tiedosto
Tämä esimerkki osoittaa, miten voit lähettää luettelo paikallisen tietokoneen prosesseja tiedostoon. Jos tiedostoa ei ole olemassa, Out-File
luo tiedosto määritettyyn polkuun.
Get-Process
cmdlet-komento saa listan prosesseja käynnissä paikallisessa tietokoneessa., Se Processobjects lähetetään alas putki Out-File
cmdlet-komentoa. Out-File
käyttää Filepathparametriä ja luo tiedoston nykyiseen hakemistoon nimeltä Process.txt. Get-Content
– komento saa tiedoston sisällön ja näyttää sen PowerShell-konsolissa.
Esimerkki 2: Estä olemassa olevan tiedoston korvaamisen
Tämä esimerkiksi estää olemassa olevan tiedoston korvaamisen. Oletuksena Out-File
ylikirjoittavat olemassa olevat tiedostot.,
Get-Process
cmdlet-komento saa listan prosesseja käynnissä paikallisessa tietokoneessa. Se Processobjects lähetetään alas putki Out-File
cmdlet-komentoa. Out-File
käyttää Filepathparametriä ja yrittää kirjoittaa tiedostoon nykyisessä hakemistossa nimeltä Process.txt. TheNoClobber-parametri estää tiedoston ylikirjoittamisen ja näyttää viestin, että tiedosto on jo olemassa.
esimerkki 3: Lähetä ulostulo tiedostoon ASCII-muodossa
tässä esimerkissä näytetään, miten koodataan ulostulo tietyllä koodaustyypillä.,
$Procs = Get-ProcessOut-File -FilePath .\Process.txt -InputObject $Procs -Encoding ASCII -Width 50
Get-Process
cmdlet-komento saa listan prosesseja käynnissä paikallisessa tietokoneessa. Prosessihankkeet tallennetaan muuttujaan $Procs
. Out-File
käyttää FilePath parametri ja luo tiedosto nykyisessä hakemistossa nimeltä Prosessi.txt. InputObject-parametri siirtää prosessin objektit $Procs
tiedostoprosessiin.txt. Koodausparametri muuntaa theoutput ASCII-muotoon. Leveysparametri rajoittaa jokaisen tiedoston rivin 50 merkkiin sosome-tiedot voidaan typistää.,
Esimerkki 4: Käytä palveluntarjoajan ja lähettää tulosteen tiedostoon
Tämä esimerkki osoittaa, kuinka käyttää Out-File
cmdlet-komentoa, kun et ole Tiedostojärjestelmä providerdrive. Käytä Get-PSProvider
cmdlet: tä nähdäksesi palveluntarjoajat paikallisella tietokoneellasi. Lisätietoja on saatavilla osoitteesta
Set-Location
komento käyttää Polku parametri määrittää nykyisen sijainnin registryprovider Alias:
. Get-Location
cmdlet-komento näyttää täydellinen polku Alias:
.,Get-ChildItem
lähettää esineitä alas putki Out-File
cmdlet-komentoa. Out-File
käyttää theFilePath parametri määrittää koko polku ja tiedostonimi-lähtö,C:\TestDir\AliasNames.txt. Get-Content
cmdlet käyttää Polkuparametria ja näyttää tiedoston sisällön PowerShell-konsolissa.
Parametrit
Lisää tuotoksen loppuun olemassa olevan tiedoston.,
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
.,
hyväksyttävät arvot tämän parametrin ovat seuraavat:
-
ascii
: Käyttää koodaus ASCII (7-bittinen) – merkistöä. -
bigendianunicode
: Koodaa UTF-16-muodossa käyttää big-endian-tavujärjestyksessä. -
bigendianutf32
: Koodaa UTF-32-muodossa käyttää big-endian-tavujärjestyksessä. -
oem
: Käyttää oletuskoodaus MS-DOS ja konsoli ohjelmia. -
unicode
: Koodaa UTF-16-muodossa käyttäen little endian-tavujärjestyksessä., -
utf7
: Koodaa UTF-7-muodossa. -
utf8
: Koodaa UTF-8-muodossa. -
utf8BOM
: Koodaa UTF-8-muodossa Byte Order Mark (BOM) -
utf8NoBOM
: Koodaa UTF-8-muodossa ilman Byte Order Mark (BOM) -
utf32
: Koodaa UTF-32-muodossa.
alkaen Powershellista 6.,2 Encoding-parametrin avulla numeerinen Tunnukset on rekisteröity koodisivua (esimerkiksi -Encoding 1251
) tai string nimet rekisteröity koodi sivuille (kuten-Encoding "windows-1251"
). Lisätietoja on saatavilla. Net-dokumentaatiosta.CodePage.
Huom.
UTF-7* ei enää suositella käytettäväksi. Powershellissa 7.1 kirjoitetaan varoitus, jos täsmentää utf7
Koodausparametrille.,
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.,
Tyyppi: | SwitchParameter |
Sijainti: | Nimeltä |
Oletus arvo: | Ei |
Hyväksy putki ohjaus: | False |
Hyväksy yleismerkkejä: | False |
Määrittää esineitä kirjoitetaan tiedostoon. Anna muuttuja, joka sisältää objektit tai typea komento tai lauseke, joka saa objektit.,
Tyyppi: | PSObject |
Sijainti: | Nimeltä |
Oletus arvo: | Ei |
Hyväksy putki ohjaus: | True |
Hyväksy yleismerkkejä: | False |
Määrittää polku tuotoksen tiedosto. LiteralPath-parametria käytetään juuri niin kuin se kirjoitetaan.Jokerimerkkejä ei hyväksytä. Jos polku sisältää pakohahmoja, liitä se yksittäin merkkeihin., Yhden lainausmerkit kertovat PowerShell ei tulkita mitään merkkejä escapesequences. Lisätietoja on saatavissa seuraavasta osoitteesta: o_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., Oletusarvoisesti, jos tiedosto on olemassa määritellyllä polulla, Out-File
korvaa filewithout-varoituksen.,
Tyyppi: | SwitchParameter |
Aliakset: | NoOverwrite |
Sijainti: | Nimeltä |
Oletus arvo: | Ei |
Hyväksy kaasuputken tulo: | False |
Hyväksy yleismerkkejä: | False |
Määrittää, että sisältö kirjoitetaan tiedostoon ei pääty rivinvaihtomerkkiä. Tuloesineiden stringesentaatiot konventoidaan ulostulon muodostamiseksi., Lähtöruutujen väliin ei aseteta välilyöntejä tai uusia linjoja. Ei newline lisätään jälkeen viimeinen lähtö merkkijono.
Tyyppi: | SwitchParameter |
Sijainti: | Nimeltä |
Oletus arvo: | Ei |
Hyväksy putki ohjaus: | False |
Hyväksy yleismerkkejä: | False |
Osoittaa, mitä tapahtuisi, jos cmdlet-komento toimii. Cmdlet ei ole käynnissä.,
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., Jos tätä parametria ei käytetä, leveys määritetään thehostin ominaisuuksien perusteella. PowerShell-konsolin oletusarvo on 80 merkkiä.
Tyyppi: | Int32 |
Sijainti: | Nimeltä |
Oletus arvo: | Ei |
Hyväksy putki ohjaus: | False |
Hyväksy yleismerkkejä: | False |
Tuloa
PSObject
putki tahansa esineen Out-File
.,
Tuotokset
Ei mitään
Out-File
ei tuota mitään tulostetta.
Huomautuksia
Input esineet ovat automaattisesti alustettu kuin ne olisivat terminaalissa, mutta voit käyttääFormat-*
cmdlet voit nimenomaisesti hallita muotoilu tuotoksen tiedosto. EsimerkiksiGet-Date | Format-List | Out-File out.txt
lähettää PowerShell-komennon tuloste Out-File
cmdlet-komentoa, käytä putki. Vaihtoehtoisesti, voit tallentaa tiedot muuttujaan ja käyttää InputObject parametri siirtää tiedot Out-File
cmdlet-komentoa.,
Out-File
tallentaa tiedot tiedostoon, mutta se ei tuota mitään tulostetta esineitä putki.
- about_Providers
- about_Quoting_Rules
- Pois-Oletus
- Pois-Isäntä
- Pois-Null
- Pois-String
- Tee-Objekti
Vastaa