Legger til innhold i de angitte elementene, for eksempel å legge til ord i en fil.
- Syntaks
- Beskrivelse
- Eksempler
- Eksempel 1: Legg til en streng i alle tekstfiler med et unntak
- Eksempel 2: Legg til en dato på slutten av de angitte filene
- Eksempel 3: Legg til innholdet i en spesifisert fil i en annen fil
- Eksempel 4: Legg til innholdet i en spesifisert fil i en annen fil ved hjelp av pipeline
- Eksempel 5: Opprett en ny fil og kopier innhold
- Eksempel 6: Legg til innhold i en skrivebeskyttet fil
- Eksempel 7: Bruk Filtre med Tilleggsinnhold
- Parametere
- Innganger
- Utganger
- Merknader
Syntaks
Add-Content <string> <Object> >] >]
Add-Content <Object> -LiteralPath <string> >] >]
Beskrivelse
Add-Content
cmdleten legger til innhold i et angitt element eller fil. Du kan angi innholdetved å skrive inn innholdet i kommandoen eller ved å angi et objekt som inneholder innholdet.
hvis du trenger å opprette filer eller kataloger for følgende eksempler, se Ny-Element.
Eksempler
Eksempel 1: Legg til en streng i alle tekstfiler med et unntak
dette eksemplet legger til en verdi i tekstfiler i gjeldende katalog, men ekskluderer filer basert på filnavnet deres.
Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'
Path-parameteren angir alle .txt
filer i gjeldende katalog, Men Excludeparameter ignorerer filnavn som samsvarer med det angitte mønsteret. Verdiparameteren spesifiserertekststreng som er skrevet til filene.
Eksempel 2: Legg til en dato på slutten av de angitte filene
dette eksemplet legger datoen til filer i gjeldende katalog og viser datoen i powershell-konsollen.
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
cmdleten oppretter to nye filer i gjeldende mappe. Verdiparameteren inneholderutgangen av cmdletenGet-Date
. PassThru-parameteren sender det ekstra innholdet til rørledningen.Fordi det er ingen andre cmdlet å motta utdataene, vises Den I powershell-konsollen.Get-Content
cmdleten viser den oppdaterte filen, DateTimeFile1.log
.
Eksempel 3: Legg til innholdet i en spesifisert fil i en annen fil
dette eksemplet henter innholdet fra en fil og lagrer innholdet i en variabel. Variabelen brukes til å legge til innholdet i en annen fil.
$From = Get-Content -Path .\CopyFromFile.txtAdd-Content -Path .\CopyToFile.txt -Value $FromGet-Content -Path .\CopyToFile.txt
-
Get-Content
cmdleten får innholdet iCopyFromFile.txt
og lagrer innholdet i$From
variabelen. -
Add-Content
cmdleten oppdatererCopyToFile.txt
filen ved hjelp av innholdet i$From
variabelen. -
Get-Content
cmdleten viser CopyToFile.txt.
Eksempel 4: Legg til innholdet i en spesifisert fil i en annen fil ved hjelp av pipeline
dette eksemplet henter innholdet fra en fil og rør det til Add-Content
cmdleten.
Get-Content -Path .\CopyFromFile.txt | Add-Content -Path .\CopyToFile.txtGet-Content -Path .\CopyToFile.txt
Get-Content
cmdleten får innholdet iCopyFromFile.txt
. Resultatene sendes i rør tilAdd-Content
cmdleten, som oppdaterer CopyToFile.txt
.Den sisteGet-Content
cmdleten viser CopyToFile.txt
.
Eksempel 5: Opprett en ny fil og kopier innhold
dette eksemplet oppretter en ny fil og kopierer innholdet i en eksisterende fil til den nye filen.
Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)Get-Content -Path .\NewFile.txt
-
Add-Content
cmdleten bruker Sti-og Verdiparametrene til å opprette en ny fil i gjeldende mappe. -
Get-Content
cmdleten får innholdet i en eksisterende fil,CopyFromFile.txt
og sender den til Verdiparameteren. Parentesene rundtGet-Content
cmdleten sikrer at kommandoen avsluttes før kommandoenAdd-Content
begynner. -
Get-Content
cmdleten viser innholdet i den nye filen,NewFile.txt
.
Eksempel 6: Legg til innhold i en skrivebeskyttet fil
denne kommandoen legger til en verdi i filen selv om filattributtet IsReadOnly er Satt Til True.Trinnene for å opprette en skrivebeskyttet fil er inkludert i eksemplet.
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
cmdleten bruker Sti-og elementparametrene til å opprette filenIsReadOnlyTextFile.txt
i gjeldende katalog. -
Set-ItemProperty
cmdleten bruker Navn-og Verdiparametrene til å endre egenskapen file ‘ isreadonly Til True. -
Get-ChildItem
cmdleten viser at filen er tom (0) og har skrivebeskyttet attributt (r
). -
Add-Content
cmdleten bruker Path-parameteren til å angi filen. Verdien parameterinkluderer tekststrengen for å legge til filen. Kraftparameteren skriver teksten tilrad-only fil. -
Get-Content
cmdleten bruker Path-parameteren til å vise filens innhold.
for å fjerne det skrivebeskyttede attributtet, bruk kommandoenSet-ItemProperty
med Verdien parameterset til False
.
Eksempel 7: Bruk Filtre med Tilleggsinnhold
du kan angi et filter til cmdletenAdd-Content
. Når du bruker filtre for å kvalifisere Pathparameter, må du inkludere en etterfølgende stjerne (*
) for å indikere innholdet i banen.
følgende kommando legger til ordet «Ferdig» innholdet i alle*.txt
filer iC:\Temp
katalogen.
Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"
Parametere
Angir at innholdet skal leses som en strøm av byte. Denne parameteren ble introdusert ipowershell 6.0.
det oppstår en advarsel når Du bruker AsByteStream-parameteren med Kodingsparameteren. 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: | Godta pipeline inngang: | false | |||||||||||
godta jokertegn: | false |
merk
denne parameteren støttes ikke av noen leverandører installert med PowerShell.To utgi deg for å være en annen bruker,eller opphev legitimasjonen når du kjører denne cmdleten, bruk Invoke-Kommando.
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. Thisparameter fungerer bare i filsystemstasjoner.
de akseptable verdiene for denne parameteren er som følger:
-
ascii
: Bruker kodingen for ascii (7-biters) tegnsett. -
bigendianunicode
: Koder i utf-16 format ved hjelp av big-endian byte rekkefølge. -
bigendianutf32
: Koder i utf-32 format ved hjelp av big-endian byte rekkefølge. -
oem
: Bruker standardkoding FOR MS-DOS-og konsollprogrammer. -
utf7
: Koder i utf-7-format. -
utf8
: Koder i utf-8-format. -
utf8NoBOM
: Koder i utf-8-format uten Byte Order Mark (BOM) -
utf32
: Koder i utf-32-format.
unicode
: Koder I utf-16 format ved hjelp av little-endian byte rekkefølge.
utf8BOM
: Koder I utf-8-format med Byte Order Mark (BOM)
Begynner Med PowerShell 6.2, Tillater Kodingsparameteren også numeriske Id-Er for registrerte kodesider (som -Encoding 1251
) eller strengnavn på registrerte kodesider (som-Encoding "windows-1251"
). HVIS DU vil ha MER informasjon, kan DU se. NET-dokumentasjonen forkoding.tegntabell.
Merk
UTF-7 * anbefales ikke lenger å bruke. I PowerShell 7.1 skrives en advarsel hvis du spesifiserer utf7
For Kodingsparameteren.
Type: | Koding |
Aksepterte verdier: | 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. Skriv inn et baneelement eller mønster, for eksempel*.txt
. Jokertegn er tillatt. Ekskluder-parameteren er bare effektiv når kommandoen inneholder innholdet i et element, for eksempel C:\Windows\*
, der jokertegnet angir innholdet iC:\Windows
– katalogen.
Type: | Streng | Posisjon: | Navngitt | Standardverdi: | Ingen |
Godta rørinngang: | false |
godta jokertegn: | True |
Angir et filter for å kvalifisere path-parameteren. FileSystemprovider Er den eneste installerte PowerShell-leverandøren som støtter bruk av filtre. Du kan findthe syntaks For Filsystem filter språk i about_Wildcards.Filtre er mer effektive enn andre parametere, fordi leverandøren bruker dem når cmdletgets objektene i stedet For Å Ha PowerShell filtrere objektene etter at de er hentet.
Type: | Streng |
Posisjon: | Navngitte | Standardverdi: | Ingen |
Godta pipeline-inngang: | Falsk |
Godta jokertegn: | True |
overstyrer skrivebeskyttet attributt, slik at du kan legge til innhold i en skrivebeskyttet fil. For Eksempel Vil Force overstyre skrivebeskyttet attributtet eller opprette kataloger for å fullføre en filbane, mendet vil ikke forsøke å endre filtillatelser.
Type: | SwitchParameter | ||
Posisjon: | Navngitte | Standardverdi: | Ingen |
Godta pipeline-inngang: | |||
Godta jokertegn: | Falsk |
angir, som en streng matrise, et element eller elementer som denne cmdleten inneholder i operasjonen. Verdien av denne parameteren kvalifiserer path-parameteren. Skriv inn et baneelement eller mønster, for eksempel "*.txt"
. Jokertegn er tillatt. Include-parameteren er bare effektiv når kommandoen inneholder innholdet i et element, for eksempelC:\Windows\*
, der jokertegnet angir innholdet iC:\Windows
– katalogen.
Type: | Streng | Posisjon: | Navngitt | Standardverdi: | Ingen |
Godta rørinngang: | false |
godta jokertegn: | True |
Angir en bane til en eller flere steder. Verdien Av LiteralPath brukes akkurat som den erskrevet. Ingen tegn tolkes som jokertegn. Hvis banen inneholder escape-tegn, omslagdet i enkle anførselstegn. Enkelt anførselstegn fortelle PowerShell ikke å tolke noen charactsas escape sekvenser.
for mer informasjon, se about_Quoting_Rules.
Type: | Streng | |
Aliaser: | Posisjon: | Navngitt |
Standardverdi: | Ingen | Godta pipeline-inngang: | True |
Godta jokertegn: | false |
angir at denne cmdleten ikke legger til en ny linje eller linjeskift i innholdet.
strengrepresentasjonene av inngangsobjektene er sammenkoblet for å danne utgangen. Ingen mellomrom ellernewlines er satt inn mellom utgangsstrengene. Ingen linjeskift legges til etter siste utgangsstreng.
Type: | SwitchParameter |
Posisjon: | Navngitt | Standardverdi: | Ingen |
Godta rørinngang: | false |
godta jokertegn: | false |
returnerer et objekt som representerer det tilføyde innholdet. Denne cmdleten genererer som standard ikke anyoutput.
Type: | Posisjon: | Navngitt | Standardverdi: | Ingen | Godta pipeline-inngang: | Falsk |
Godta jokertegn: | false |
angir banen til elementene som mottar Tilleggsinnholdet.Jokertegn er tillatt.Banene må være stier til elementer, ikke til containere.Du må for eksempel angi en bane til en eller flere filer, ikke en bane til en katalog.Hvis du angir flere baner, bruker du komma til å skille banene.
Type: | Streng | Posisjon: | 0 | Standardverdi: | Ingen |
Godta rørinngang: | true |
godta jokertegn: | true |
merk
denne parameteren er bare tilgjengelig på windows.
Angir en alternativ datastrøm for innhold. Hvis strømmen ikke finnes, opprettes denne cmdleten. Jokertegn støttes ikke.
Stream Er en dynamisk parameter Som Filsystemleverandøren legger til Add-Content
. Thisparameter fungerer bare i filsystemstasjoner.
du kan bruke cmdletenAdd-Content
til å endre innholdet i en alternativ datastrøm, for eksempel Zone.Identifier
. Vi anbefaler imidlertid ikke dette somen måte å eliminere sikkerhetskontroller som blokkerer filer som lastes ned Frainternett. Hvis du kontrollerer at en nedlastet fil er trygg, bruker du cmdletenUnblock-File
.
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. Skriv inn en sitert streng, For eksempel disse dataene er for intern brukonly, eller angi et objekt som inneholder innhold, for Eksempel DateTime-objektet som Get-Date
genererer.
du kan ikke angi innholdet i en fil ved å skrive inn banen, fordi banen bare er en streng.Du kan bruke en Get-Content
kommando for å få innholdet og sende Det til Verdiparameteren.
Type: | Objekt | Posisjon: | 1 |
Standardverdi: | Ingen |
Godta rørinngang: | 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: | Falsk |
Innganger
System.Objekt, System.Management.Automatisering.PSCredential
du kan pipe verdier, baner eller legitimasjon til Set-Content
.
Utganger
Ingen Eller System.Streng
når du bruker parameteren PassThru,Add-Content
genererer Et System.String objekt somrepresenterer innholdet. Ellers genererer ikke denne cmdleten noen utdata.
Merknader
- når du rør et objekt til
Add-Content
, konverteres objektet til en streng før det legges til elementet. Objekttypen bestemmer strengformatet, men formatet kan være annerledes enn standardvisningen for objektet. For å kontrollere strengformatet, bruk formateringsparametrene tilsender cmdlet. - du kan også referere til
Add-Content
med det innebygde aliaset,ac
. For mer informasjon, seabout_aliases. -
Add-Content
cmdleten er utformet for å fungere med data eksponert av enhver leverandør. Hvis du vil vise tilbydere som er tilgjengelige i økten, skriver duGet-PSProvider
. For mer informasjon, seabout_providers. - Clear-Content
- Get-Item
- New-Item
- Set-Content