Add-Content

modul: Microsoft.PowerShell.Hantering

lägger till innehåll i de angivna objekten, till exempel att lägga till ord i en fil.

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-Contentcmdlet 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 i CopyFromFile.txt och lagrar innehållet i$From variabel.
  • Add-Content cmdlet uppdaterarCopyToFile.txt fil med innehållet i$Fromvariabel.
  • 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-Contentcmdlet 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.txtoch 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

-AsByteStream

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
-Confirm

Prompts you for confirmation before running the cmdlet.

Type: Switchparametrar
Alias: cf
Position: namngiven
standardvärde: falskt
Acceptera pipelineinmatning: False
Acceptera jokertecken: false
-credential

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
-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. 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
-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. 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

-Filter

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
-Force

å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
-inkludera

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
-LiteralPath

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
-nonewline

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
-passthru

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

-sökväg

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
-ström

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
-Value

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-Dategenererar.

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
-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

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, skriv Get-PSProvider. För mer information, seabout_providers.
  • about_Aliases
  • about_Providers
  • Clear-Content
  • Get-Content
  • Get-Item
  • New-Item
  • Set-Content

Related Posts

Lämna ett svar

Din e-postadress kommer inte publiceras. Obligatoriska fält är märkta *