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-Contentcmdlet saaCopyFromFile.txtja tallentaa sisällön$Frommuuttuja. -
Add-Contentcmdlet päivittääCopyToFile.txttiedoston käyttäen$Frommuuttujan sisältöä. -
Get-Contentcmdlet 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-Contentcmdlet käyttää polku-ja Arvoparametreja luodakseen uuden tiedoston nykyiseen hakemistoon. -
Get-Contentcmdlet saa olemassa olevan tiedoston sisällön,CopyFromFile.txtja siirtää sen Arvoparametrille.Get-Contentcmdlet varmistavat, että komento päättyy ennen kuinAdd-Contentkomento alkaa. -
Get-Contentcmdlet 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-Itemcmdlet käyttää polku-ja ItemType-parametreja luodakseen tiedostonIsReadOnlyTextFile.txtnykyisessä hakemistossa. -
Set-ItemPropertycmdlet käyttää nimeä ja Arvoparametreja muuttaakseen tiedoston isreadly-ominaisuuden True-ominaisuudeksi. -
Get-ChildItemcmdlet näyttää, että tiedosto on tyhjä (0) ja siinä on vain luku-attribuutti (r). -
Add-Contentcmdlet käyttää Polkuparametria tiedoston määrittelyyn. Arvoparametri sisältää tiedostoon liitettävän merkkijonon. Voima-parametri kirjoittaa tekstin vain Senad-tiedostoon. -
Get-Contentcmdlet 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
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-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.
| 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-Contentsen sisäänrakennetulla peitenimellä,ac. Lisätietoja on kohdassa about_aliases. -
Add-Contentcmdlet 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