Lisää määriteltyihin kohtiin sisältöä, kuten sanojen lisääminen tiedostoon.
- syntaksi
- kuvaus
- esimerkit
- Esimerkki 1: Lisää merkkijono kaikkiin tekstitiedostoihin poikkeuksena
- Esimerkki 2: Lisää päivämäärä määriteltyjen tiedostojen loppuun
- esimerkki 3: lisää tietyn tiedoston sisältö toiseen tiedostoon
- esimerkki 4: Lisää tietyn tiedoston sisältö toiseen tiedostoon käyttäen putkea
- esimerkki 5: Luo uusi tiedosto ja kopioi sisältö
- esimerkki 6: Lisää sisältöä vain luettavaan tiedostoon
- esimerkki 7: Käytä suotimia, joiden lisäsisältö
- parametrit
- Input
- lähdöt
- toteaa
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 saaCopyFromFile.txt
ja tallentaa sisällön$From
muuttuja. -
Add-Content
cmdlet päivittääCopyToFile.txt
tiedoston käyttäen$From
muuttujan 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.txt
ja siirtää sen Arvoparametrille.Get-Content
cmdlet varmistavat, että komento päättyy ennen kuinAdd-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:\Temp
hakemistoon.
Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"
parametrit
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 |
Prompts you for confirmation before running the cmdlet.
Type: | Kytkinparametri |
peitenimet: | cf |
Position: | nimetty |
oletusarvo: | väärä |
hyväksy putkilinjan syöttö: | |
hyväksy yleismerkit: | False |
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 |
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 |
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 |
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 |
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ä |
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 |
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 |
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 |
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 |
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.
Type: | String |
Position: | 0 | Default value: | None |
Accept pipeline input: | tosi |
tosi |
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 |
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-Date
luo.
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.
Type: | Object |
Position: | |
Default value: | |
None | |
Accept pipeline input: | True |
Accept wildcard characters: | False |
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, KirjoitaGet-PSProvider
. Lisätietoja on ohjea_providers-sivustossa.
bout_Providers