lägger till innehåll i de angivna objekten, till exempel att lägga till ord i en fil.
- Syntax
- beskrivning
- exempel
- exempel 1: Lägg till en sträng i alla textfiler med undantag
- exempel 2: Lägg till ett datum i slutet av de angivna filerna
- exempel 3: Lägg till innehållet i en viss fil till en annan fil
- exempel 4: Lägg till innehållet i en viss fil till en annan fil med hjälp av rörledningen
- exempel 5: skapa en ny fil och kopiera innehåll
- exempel 6: Lägg till innehåll i en skrivskyddad fil
- exempel 7: Använd filter med tilläggsinnehåll
- parametrar
- ingångar
- utgångar
- anteckningar
Syntax
Add-Content <string> <Object> >] >]
Add-Content <Object> -LiteralPath <string> >] >]
beskrivning
Add-Content
cmdlet lägger till innehåll till ett visst objekt eller en fil. Du kan ange innehålletgenom att skriva innehållet i kommandot eller genom att ange ett objekt som innehåller innehållet.
om du behöver skapa filer eller kataloger för följande exempel, se New-Item.
exempel
exempel 1: Lägg till en sträng i alla textfiler med undantag
detta exempel lägger till ett värde i textfiler i den aktuella katalogen men utesluter filer baserat på deras filnamn.
Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'
sökvägsparametern anger alla.txt
filer i den aktuella katalogen, Men Excludeparameter ignorerar filnamn som matchar det angivna mönstret. Värdeparametern specifikertextsträng som skrivs till filerna.
exempel 2: Lägg till ett datum i slutet av de angivna filerna
detta exempel lägger till datumet i filer i den aktuella katalogen och visar datumet ipowershell-konsolen.
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 skapar två nya filer i den aktuella katalogen. Värdeparametern innehållerutgången från Get-Date
cmdlet. Parametern PassThru matar ut det tillagda innehållet i rörledningen.Eftersom det inte finns någon annan cmdlet för att ta emot utmatningen visas den i PowerShell-konsolen.Get-Content
cmdlet visar den uppdaterade filen,DateTimeFile1.log
.
exempel 3: Lägg till innehållet i en viss fil till en annan fil
detta exempel hämtar innehållet från en fil och lagrar innehållet i en variabel. Variabeln används för att lägga till innehållet i en annan fil.
$From = Get-Content -Path .\CopyFromFile.txtAdd-Content -Path .\CopyToFile.txt -Value $FromGet-Content -Path .\CopyToFile.txt
-
Get-Content
cmdlet får innehållet iCopyFromFile.txt
och lagrar innehållet i$From
variabel. -
Add-Content
cmdlet uppdaterarCopyToFile.txt
fil med innehållet i$From
variabel. -
Get-Content
cmdlet visar CopyToFile.txt.
exempel 4: Lägg till innehållet i en viss fil till en annan fil med hjälp av rörledningen
detta exempel hämtar innehållet från en fil och rör det tillAdd-Content
cmdlet.
Get-Content -Path .\CopyFromFile.txt | Add-Content -Path .\CopyToFile.txtGet-Content -Path .\CopyToFile.txt
Get-Content
cmdlet får innehållet i CopyFromFile.txt
. Resultaten leds tillAdd-Content
cmdlet, som uppdaterar CopyToFile.txt
.Den sista Get-Content
cmdlet visar CopyToFile.txt
.
exempel 5: skapa en ny fil och kopiera innehåll
detta exempel skapar en ny fil och kopierar en befintlig fils innehåll till den nya filen.
Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)Get-Content -Path .\NewFile.txt
-
Add-Content
cmdlet använder sökvägen och värdeparametrarna för att skapa en ny fil iNuvarande katalog. -
Get-Content
cmdlet får innehållet i en befintlig fil,CopyFromFile.txt
och skickar den till Värdeparametern. Parenteserna runtGet-Content
cmdlet säkerställer att kommandot avslutas innan kommandotAdd-Content
börjar. -
Get-Content
cmdlet visar innehållet i den nya filen,NewFile.txt
.
exempel 6: Lägg till innehåll i en skrivskyddad fil
detta kommando lägger till ett värde i filen även om isreadonly-filattributet är inställt på True.Stegen för att skapa en skrivskyddad fil ingår i exemplet.
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 använder parametrarna sökväg och objekttyp för att skapa filenIsReadOnlyTextFile.txt
I den aktuella katalogen. -
Set-ItemProperty
cmdlet använder parametrarna namn och värde för att ändra filens egenskap sisreadonly till True. -
Get-ChildItem
cmdlet visar att filen är tom (0) och har skrivskyddat attribut (r
). -
Add-Content
cmdlet använder sökvägsparametern för att ange filen. Värdet parameterinkluderar textsträngen att lägga till filen. Kraftparametern skriver texten tillläs-bara fil. -
Get-Content
cmdlet använder sökvägsparametern för att visa filens innehåll.
för att ta bort skrivskyddat attribut, använd kommandotSet-ItemProperty
med värdeparameterset tillFalse
.
exempel 7: Använd filter med tilläggsinnehåll
Du kan ange ett filter till Add-Content
cmdlet. När du använder filter för att kvalificera Sökvägparametern måste du inkludera en efterföljande asterisk (*
) för att ange innehållet i sökvägen.
följande kommando lägger till ordet ”klar”innehållet i alla *.txt
filer i katalogen C:\Temp
.
Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"
parametrar
anger att innehållet ska läsas som en ström av byte. Denna parameter introducerades ipowershell 6.0.
en varning uppstår när du använder parametern AsByteStream med Kodningsparametern. 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: | Switchparametrar |
Alias: | cf |
Position: | namngiven |
standardvärde: | falskt |
Acceptera pipelineinmatning: | False |
Acceptera jokertecken: | false |
Obs
denna parameter stöds inte av några leverantörer installerade med PowerShell.To imitera en annan användare,eller höja dina referenser när du kör denna cmdlet, använd Invoke-Command.
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 fungerar endast i filsystemenheter.
de acceptabla värdena för denna parameter är följande:
-
ascii
: använder kodningen för ASCII (7-bitars) teckenuppsättningen. -
bigendianunicode
: kodar i UTF-16-format med big-endian byteordning. -
bigendianutf32
: kodar i UTF-32-format med big-endian byteordning. -
oem
: använder standardkodningen för MS-DOS och konsolprogram. -
unicode
: Kodar i UTF-16-format med hjälp av little-endian byte order. -
utf7
: kodar i UTF-7-format. -
utf8
: kodar i UTF-8-format. -
utf8BOM
: kodar i UTF-8-format med Byte Order Mark (BOM) -
utf8NoBOM
: kodar i UTF-8-format utan Byte Order Mark (BOM) -
utf32
: kodar i UTF-32-format.
börjar med PowerShell 6.2 tillåter Kodningsparametern också numeriska ID för registrerade kodsidor (som -Encoding 1251
) eller strängnamn på registrerade kodsidor (som-Encoding "windows-1251"
). Mer information finns i. NET-dokumentationen förkodning.teckentabell.
Obs
UTF-7* rekommenderas inte längre att använda. I PowerShell 7.1 skrivs en varning om duAnge utf7
för Kodningsparametern.
Typ: | kodning |
accepterade värden: | 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. Ange ett banelement eller ett mönster, till exempel*.txt
. Jokertecken är tillåtna. Uteslutningsparametern är endast effektiv när kommandot innehåller innehållet i ett objekt, till exempel C:\Windows\*
, där jokertecknet anger innehållet i katalogen C:\Windows
.
Typ: | sträng |
Position: | namngiven |
standardvärde: | ingen |
Acceptera pipelineinmatning: | falskt |
Acceptera jokertecken: | True |
anger ett filter för att kvalificera sökvägsparametern. FileSystemprovider är den enda installerade PowerShell-leverantören som stöder användningen av filter. Du kan hitta syntaxen för filsystemets filterspråk i about_Wildcards.Filter är effektivare än andra parametrar, eftersom leverantören tillämpar dem när cmdletgets objekten snarare än att ha PowerShell filtrera objekten efter att de har hämtats.
Typ: | sträng |
Position: | namngiven |
standardvärde: | ingen |
Acceptera pipelineinmatning: | falskt | Acceptera jokertecken: | True |
åsidosätter attributet skrivskyddad, så att du kan lägga till innehåll i en skrivskyddad fil. Force kommer till exempel att åsidosätta skrivskyddat attribut eller skapa kataloger för att slutföra en filsökväg, mendet kommer inte att försöka ändra filbehörigheter.
Typ: | SwitchParameter |
Position: | namngiven |
standardvärde: | ingen |
Acceptera pipelineinmatning: | falskt | Acceptera jokertecken: | falskt |
anger, som en strängmatris, ett objekt eller objekt som denna cmdlet innehåller i operationen. Värdet av denna parameter kvalificerar sökvägsparametern. Ange ett banelement eller ett mönster, till exempel"*.txt"
. Jokertecken är tillåtna. Parametern Include är endast effektiv när kommandot innehåller innehållet i ett objekt, till exempel C:\Windows\*
, där jokertecknet anger innehållet i katalogen C:\Windows
.
Typ: | sträng |
Position: | namngiven |
standardvärde: | ingen |
Acceptera pipelineinmatning: | falskt |
Acceptera jokertecken: | True |
anger en sökväg till en eller flera platser. Värdet på LiteralPath används exakt som det ärskriven. Inga tecken tolkas som jokertecken. Om sökvägen innehåller escape-tecken, bifoga det i enstaka citattecken. Enstaka citattecken säger till PowerShell att inte tolka några teckensom flyktsekvenser.
För mer information, se about_Quoting_Rules.
Typ: | sträng |
Alias: | PSPath, LP |
Position: | namngiven |
standardvärde: | ingen |
Acceptera pipelineinmatning: | True |
Acceptera jokertecken: | false |
indikerar att denna cmdlet inte lägger till en ny rad eller vagnretur till innehållet.
strängrepresentationerna för inmatningsobjekten sammanfogas för att bilda utmatningen. Inga mellanslag ellernylinjer sätts in mellan utgångssträngarna. Ingen nyrad läggs till efter den sista utmatningssträngen.
Typ: | SwitchParameter |
Position: | namngiven |
standardvärde: | ingen |
Acceptera pipelineinmatning: | false |
Acceptera jokertecken: | false |
returnerar ett objekt som representerar det tillagda innehållet. Som standard genererar denna cmdlet ingenutgång.
Typ: | Switchparametrar |
Position: | namngivna |
standardvärde: | ingen |
Acceptera pipelineinmatning: | falskt |
Acceptera jokertecken: | false |
anger sökvägen till de objekt som tar emot det extra innehållet.Jokertecken är tillåtna.Banorna måste vara vägar till objekt, inte till containrar.Du måste till exempel ange en sökväg till en eller flera filer, inte en sökväg till en katalog.Om du anger flera sökvägar använder du kommatecken för att separera sökvägarna.
Typ: | sträng |
Position: | 0 | standardvärde: | ingen |
Acceptera pipelineinmatning: | True |
Acceptera jokertecken: | true |
Obs
denna parameter är endast tillgänglig i Windows.
anger en alternativ dataström för innehåll. Om strömmen inte existerar skapar den här cmdletendet. Jokertecken stöds inte.
Stream är en dynamisk parameter som filsystemleverantören lägger till Add-Content
. Thisparameter fungerar endast i filsystemenheter.
Du kan använda Add-Content
cmdlet för att ändra innehållet i någon alternatedataström, till exempel Zone.Identifier
. Vi rekommenderar dock inte detta somett sätt att eliminera säkerhetskontroller som blockerar filer som laddas ner frånInternet. Om du verifierar att en nedladdad fil är säker använder duUnblock-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. Skriv en citerad sträng, till exempel dessa data är endast avsedda för intern användning, eller ange ett objekt som innehåller innehåll, till exempel det datetime-objekt som Get-Date
genererar.
Du kan inte ange innehållet i en fil genom att skriva dess sökväg, eftersom sökvägen bara är en sträng.Du kan använda kommandot Get-Content
för att få innehållet och skicka det till Värdeparametern.
Typ: | objekt |
Position: | 1 |
standardvärde: | ingen |
Acceptera pipelineinmatning: | 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 |
ingångar
systemet.Objekt, System.Förvaltning.Automation.PSCredential
Du kan ange värden, sökvägar eller referenser tillSet-Content
.
utgångar
ingen eller systemet.String
När du använder parametern PassThru genererarAdd-Content
ett system.Strängobjekt somrepresenterar innehållet. Annars genererar denna cmdlet ingen utgång.
anteckningar
- när du rör ett objekt till
Add-Content
konverteras objektet till en sträng innan det läggs tillobjektet. Objekttypen bestämmer strängformatet, men formatet kan vara annorlunda än objektets standardvisning. För att styra strängformatet, använd formateringsparametrarna förskicka cmdlet. - du kan också referera till
Add-Content
med dess inbyggda alias,ac
. För mer information, seabout_aliases. -
Add-Content
cmdlet är utformad för att fungera med data som exponeras av någon leverantör. För att listaleverantörer som är tillgängliga i din session, skrivGet-PSProvider
. För mer information, seabout_providers.
- about_Aliases
- about_Providers
- Clear-Content
- Get-Content
- Get-Item
- New-Item
- Set-Content