Add-Content

Module: Microsoft.PowerShell.Hallinta

Lisää määriteltyihin kohtiin sisältöä, kuten sanojen lisääminen tiedostoon.

syntaksi

Add-Content <string> <Object> >] >] 
Add-Content <Object> -LiteralPath <string> >] >] 

kuvaus

Add-Content cmdlet liittää sisällön tiettyyn kohteeseen tai tiedostoon. Voit määrittää sisällön kirjoittamalla sisällön komentoon tai määrittämällä objektin, joka sisältää sisällön.

Jos haluat luoda tiedostoja tai kansioita seuraaville esimerkeille, Katso uusi-kohde.

esimerkit

Esimerkki 1: Lisää merkkijono kaikkiin tekstitiedostoihin poikkeuksena

tässä esimerkissä lisätään nykyisen hakemiston tekstitiedostoille arvo, mutta jätetään pois niiden tiedostonimeen perustuvat tiedostot.

Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'

Polkuparametri määrittää kaikki .txt nykyisen hakemiston tiedostot, mutta Ekskludeparametri ei huomioi annettua kaavaa vastaavia tiedostonimiä. Arvoparametri määrittää tiedostoille kirjoitetun tekstimerkkijonon.

Esimerkki 2: Lisää päivämäärä määriteltyjen tiedostojen loppuun

Tämä esimerkki liittää päivämäärän nykyisen kansion tiedostoihin ja näyttää päivämäärän PowerShell-konsolissa.

Add-Content -Path .\DateTimeFile1.log, .\DateTimeFile2.log -Value (Get-Date) -PassThruGet-Content -Path .\DateTimeFile1.logTuesday, May 14, 2019 8:24:27 AMTuesday, May 14, 2019 8:24:27 AM5/14/2019 8:24:27 AM

Add-Content cmdlet luo kaksi uutta tiedostoa nykyiseen hakemistoon. Arvoparametri sisältää Get-Date cmdlet: n ulostulon. PassThru-parametri lähettää lisätyn sisällön putkistoon.Koska tulosteen vastaanottamiseen ei ole toista cmdletiä, se näkyy PowerShell-konsolissa.Get-Content cmdlet näyttää päivitetyn tiedoston, DateTimeFile1.log.

esimerkki 3: lisää tietyn tiedoston sisältö toiseen tiedostoon

Tämä esimerkki saa sisällön tiedostosta ja tallentaa sisällön muuttujaan. Muuttujaa käytetään sisällön liittämiseen toiseen tiedostoon.

$From = Get-Content -Path .\CopyFromFile.txtAdd-Content -Path .\CopyToFile.txt -Value $FromGet-Content -Path .\CopyToFile.txt
  • Get-Content cmdlet saa CopyFromFile.txt ja tallentaa sisällön$From muuttuja.
  • Add-Content cmdlet päivittää CopyToFile.txt tiedoston käyttäen $Frommuuttujan sisältöä.
  • Get-Content cmdlet näyttää Kopiotiedoston.txt.

esimerkki 4: Lisää tietyn tiedoston sisältö toiseen tiedostoon käyttäen putkea

Tämä esimerkki saa tiedoston sisällön ja putkittaa senAdd-Content cmdlet.

Get-Content -Path .\CopyFromFile.txt | Add-Content -Path .\CopyToFile.txtGet-Content -Path .\CopyToFile.txt

Get-Content cmdlet saavat CopyFromFile.txt. Tulokset merkitään Add-Content cmdlet, joka päivittää CopyToFile.txt.Viimeinen Get-Content cmdlet näyttää CopyToFile.txt.

esimerkki 5: Luo uusi tiedosto ja kopioi sisältö

tässä esimerkissä luodaan uusi tiedosto ja kopioidaan olemassa olevan tiedoston sisältö uuteen tiedostoon.

Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)Get-Content -Path .\NewFile.txt
  • Add-Content cmdlet käyttää polku-ja Arvoparametreja luodakseen uuden tiedoston nykyiseen hakemistoon.
  • Get-Content cmdlet saa olemassa olevan tiedoston sisällön, CopyFromFile.txtja siirtää sen Arvoparametrille. Get-Content cmdlet varmistavat, että komento päättyy ennen kuin Add-Content komento alkaa.
  • Get-Content cmdlet näyttää uuden tiedoston sisällön, NewFile.txt.

esimerkki 6: Lisää sisältöä vain luettavaan tiedostoon

Tämä komento tuo tiedostolle arvon, vaikka IsReadOnly file-attribuutin arvo olisi True.Vaiheet luoda vain luku-tiedoston sisältyvät esimerkkiin.

New-Item -Path .\IsReadOnlyTextFile.txt -ItemType FileSet-ItemProperty -Path .\IsReadOnlyTextFile.txt -Name IsReadOnly -Value $TrueGet-ChildItem -Path .\IsReadOnlyTextFile.txtAdd-Content -Path .\IsReadOnlyTextFile.txt -Value 'Add value to read-only text file' -ForceGet-Content -Path .\IsReadOnlyTextFile.txtMode LastWriteTime Length Name---- ------------- ------ -----ar-- 1/28/2019 13:35 0 IsReadOnlyTextFile.txt
  • New-Item cmdlet käyttää polku-ja ItemType-parametreja luodakseen tiedostonIsReadOnlyTextFile.txt nykyisessä hakemistossa.
  • Set-ItemProperty cmdlet käyttää nimeä ja Arvoparametreja muuttaakseen tiedoston isreadly-ominaisuuden True-ominaisuudeksi.
  • Get-ChildItem cmdlet näyttää, että tiedosto on tyhjä (0) ja siinä on vain luku-attribuutti (r).
  • Add-Content cmdlet käyttää Polkuparametria tiedoston määrittelyyn. Arvoparametri sisältää tiedostoon liitettävän merkkijonon. Voima-parametri kirjoittaa tekstin vain Senad-tiedostoon.
  • Get-Content cmdlet käyttää Polkuparametria tiedoston sisällön näyttämiseen.

poistaaksesi vain luku-attribuutin, käytä Set-ItemProperty – komentoa, jossa arvo-parametrisarja on False.

esimerkki 7: Käytä suotimia, joiden lisäsisältö

voit määrittää suodattimenAdd-Content cmdlet. Kun käytät suotimia polkuparametrin määrittelemiseksi, sinun on lisättävä perään tähdellä (*), joka osoittaa polun sisällön.

seuraava komento lisää sanan ”tehty” kaikkien *.txt tiedostojen sisällön C:\Temphakemistoon.

Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"

parametrit

-AsByteStream

määrittää, että sisältö luetaan tavuvirtana. Tämä parametri otettiin käyttöönvowershell 6.0: ssa.

varoitus tapahtuu, kun käytät Asbytestream-parametria Koodausparametrin kanssa. TheAsByteStream parameter ignores any encoding and the output is returned as a stream of bytes.

Type: SwitchParameter
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm

Prompts you for confirmation before running the cmdlet.

td>False

Type: Kytkinparametri
peitenimet: cf
Position: nimetty
oletusarvo: väärä
hyväksy putkilinjan syöttö:
hyväksy yleismerkit: False
-credential

huomautus

tätä parametria ei tue yksikään tarjoaja, joka on asennettu PowerShell.To tekeytyä toiseksi käyttäjäksi tai kohota tunnistetietojasi,kun suoritat tätä cmdletiä, käytä Invoke-komentoa.

Type: PSCredential
Position: Named
Default value: None
Accept pipeline input: True
Accept wildcard characters: False
-Encoding

Specifies the type of encoding for the target file. The default value is utf8NoBOM.

Encoding is a dynamic parameter that the FileSystem provider adds to the Add-Content cmdlet. Tämäparametri toimii vain tiedostojärjestelmän asemissa.

tämän parametrin hyväksyttävät arvot ovat seuraavat:

  • ascii: käyttää ASCII-merkistön (7-bittinen) koodausta.
  • bigendianunicode: koodaa UTF-16-muodossa käyttäen big-endian tavujärjestystä.
  • bigendianutf32: koodaa UTF-32-muodossa käyttäen big-endian tavujärjestystä.
  • oem: käyttää MS-DOS-ja konsoliohjelmien oletuskoodausta.
  • unicode: Koodaa UTF-16-muodossa käyttäen little-endian tavujärjestystä.
  • utf7: koodeja UTF-7-muodossa.
  • utf8: koodeja UTF-8-muodossa.
  • utf8BOM: Encodes in UTF-8 format with Byte Order Mark (BOM)
  • utf8NoBOM: Encodes in UTF-8 format without Byte Order Mark (bom)
  • utf32: Encodes UTF-32-muodossa.

alkaen Powershellissa 6.2, Koodausparametri mahdollistaa myös rekisteröityjen koodisivujen numeeriset tunnukset (kuten -Encoding 1251) tai rekisteröityjen koodisivujen merkkijonot (kuten-Encoding "windows-1251"). Lisätietoja on. NET-dokumentaation koodauksessa.Koodikirja.

Huomautus

UTF-7*: n käyttöä ei enää suositella. PowerShell 7.1: ssä varoitus kirjoitetaan, jos määrittelet utf7 Koodausparametrille.

Type: Encoding
hyväksytyt arvot: ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Position: Named
Default value: UTF8NoBOM
Accept pipeline input: False
Accept wildcard characters: False
-Exclude

Specifies, as a string array, an item or items that this cmdlet excludes in the operation. The valueof this parameter qualifies the Path parameter. Anna polkuelementti tai-kuvio, kuten*.txt. Jokerimerkit ovat sallittuja. Exclude-parametri on voimassa vain silloin, kun komento sisältää kohteen sisällön, kuten C:\Windows\*, jossa yleismerkki määrittelee C:\Windows hakemiston sisällön.

Type: String
Position: Named
Default value:
None
Accept pipeline input: False
hyväksy jokerimerkit: True

-suodatin

määrittää suodattimen, jolla Polkuparametri voidaan määritellä. FileSystemprovider on ainoa asennettu PowerShell-tarjoaja, joka tukee suodattimien käyttöä. Voit löytää tiedostojärjestelmän suodatuskielen syntaksin kohdasta about_Wildcards.Suodattimet ovat tehokkaampia kuin muut parametrit, koska tarjoaja soveltaa niitä, kun cmdletgets objektit sen sijaan, että PowerShell suodattaa objektit sen jälkeen, kun ne on noudettu.

Type: String
Position: nimetty
oletusarvo: Ei mitään
hyväksy putkilinjan tulo: vääriä
hyväksy jokerimerkit: tosi
-Force

ohittaa vain luku-ominaisuuden, jolloin voit lisätä sisältöä vain luku-tiedostoon. Esimerkiksi Force ohittaa vain luku-attribuutin tai luo hakemistoja tiedoston polun täydentämiseksi, mutta se ei yritä muuttaa tiedoston käyttöoikeuksia.

Type: Switchparametrer
Position: nimetty
oletusarvo: Ei mitään
hyväksy putkilinjan tulo: vääriä
hyväksy jokerimerkit: vääriä
-include

määrittää merkkijonorivistönä kohteen tai kohteita, jotka tämä cmdlet sisältää operaatiossa. Tämän parametrin arvo täyttää Polkuparametrin vaatimukset. Anna polkuelementti tai-kuvio, kuten"*.txt". Jokerimerkit ovat sallittuja. Include-parametri on voimassa vain silloin, kun komento sisältää kohteen sisällön, kuten C:\Windows\*, jossa yleismerkki määrittelee C:\Windows hakemiston sisällön.

Type: String
Position: Named
Default value:
None
Accept pipeline input: False
hyväksy jokerimerkit: True
-LiteralPath

määrittää polun yhteen tai useampaan paikkaan. LiteralPath-arvoa käytetään täsmälleen sellaisenaan. Mitään merkkejä ei tulkita jokerimerkeiksi. Jos polku sisältää pakomerkkejä, liitä se yksittäisiin lainausmerkkeihin. Yksittäiset lainausmerkit kertovat Powershellille, ettei se tulkitse mitään merkkejä pakenemissekvensseistä.

lisätietoja on kohdassa about_Quoting_Rules.

Type: String
peitenimet: PSPath, LP
Position: nimetty
oletusarvo: Ei mitään
hyväksy putkilinjan tulo:
hyväksy jokerimerkit: false
-nonewline

viittaa siihen, että tämä cmdlet ei lisää sisältöön uutta riviä tai kuljetuspaluuta.

syötettävien objektien merkkijonoesitykset kootaan yhteen tulosteen muodostamiseksi. Ei välilyöntejä tai rivejä lisätään lähtö merkkijonojen väliin. Viimeisen tulostusmerkkijonon jälkeen ei lisätä uutta riviä.

Type: Switchparametrer
Position: Named None
hyväksy putkilinjan tulo: false
hyväksy jokerimerkit: false
-passhru

palauttaa lisättyä sisältöä edustavan objektin. Oletusarvoisesti tämä cmdlet ei luo mitään tuotosta.

Type: Switchparametrer
Position: nimetty
Default value:
hyväksy putkilinjan tulo:
hyväksy jokerimerkit: false
-polku

määrittää polun niihin kohtiin, jotka saavat lisäsisällön.Jokerimerkit ovat sallittuja.Polkujen on oltava polkuja tavaroille, ei konteille.Sinun on esimerkiksi määritettävä polku yhteen tai useampaan tiedostoon, ei hakemistoon johtavaa polkua.Jos määrität useita polkuja, käytä pilkkuja erottaaksesi polut.

hyväksy jokerimerkit:

Type: String
Position: 0
Default value: None
Accept pipeline input: tosi
tosi
-stream

huomautus

Tämä parametri on käytettävissä vain Windowsissa.

määrittää sisällölle vaihtoehtoisen datavirran. Jos virtaa ei ole olemassa, tämä cmdlet luose. Yleismerkkejä ei tueta.

Stream on dynaaminen parametri, jonka tiedostojärjestelmän toimittaja lisää Add-Content. Tämäparametri toimii vain tiedostojärjestelmän asemissa.

voit käyttää Add-Content cmdlet muuttaa minkä tahansa vaihtoehtoisen tietovirran sisältöä, kuten Zone.Identifier. Emme kuitenkaan suosittele tätä tapaa poistaa Tietoturvatarkastukset, jotka estävät Internetistä ladatut tiedostot. Jos varmistat, että ladattu tiedosto on turvallinen, käytäUnblock-File cmdlet.

This parameter was introduced in PowerShell 3.0.

Type: String
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Value

Specifies the content to be added. Kirjoita lainattu merkkijono, kuten tämä tieto on vain sisäistä käyttöä varten, tai määritä objekti, joka sisältää sisältöä, kuten DateTime-objekti, jonka Get-Dateluo.

tiedoston sisältöä ei voi määrittää kirjoittamalla sen polun, koska polku on pelkkä merkkijono.Voit käyttää Get-Content – komentoa saadaksesi sisällön ja välittääksesi sen Arvoparametrille.

1

Type: Object
Position:
Default value:
None
Accept pipeline input: True
Accept wildcard characters: False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Aliases: wi
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

Input

System.Kohde, Järjestelmä.Hallinta.Automaatio.PSCredential

voit putkittaa arvot, polut tai tunnistetiedot osoitteeseen Set-Content.

lähdöt

ei mikään tai systeemi.Merkkijono

Kun käytät Passhru-parametria, Add-Content luo järjestelmän.Merkkijonoobjekti, joka edustaa sisältöä. Muuten tämä cmdlet ei tuota mitään tulosta.

toteaa

  • kun piippaa objektin Add-Content, objekti muutetaan merkkijonoksi ennen kuin se lisätään kohteeseen. Objektityyppi määrittää merkkijonomuodon, mutta muoto voi olla erilainen kuin objektin syöttönäyttö. Voit hallita merkkijonomuotoa käyttämällä päättyvän cmdletin muotoiluparametreja.
  • voi viitata myös Add-Content sen sisäänrakennetulla peitenimellä, ac. Lisätietoja on kohdassa about_aliases.
  • Add-Content cmdlet on suunniteltu toimimaan minkä tahansa palveluntarjoajan paljastamien tietojen kanssa. Listataksesi istunnossa käytettävissä olevat tarjoajat, Kirjoita Get-PSProvider. Lisätietoja on ohjea_providers-sivustossa.
  • about_Aliases
  • bout_Providers

  • Clear-Content
  • Get-Item
  • New-Item
  • Set-Content
  • Related Posts

    Vastaa

    Sähköpostiosoitettasi ei julkaista. Pakolliset kentät on merkitty *