Dela via

Add-Content

  • Referens
Modul:
Microsoft.PowerShell.Management

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

Syntax

Add-Content
   [-Path] <string[]>
   [-Value] <Object[]>
   [-PassThru]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [-NoNewline]
   [-Encoding <FileSystemCmdletProviderEncoding>]
   [-Stream <string>]
   [<CommonParameters>]
Add-Content
   [-Value] <Object[]>
   -LiteralPath <string[]>
   [-PassThru]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [-NoNewline]
   [-Encoding <FileSystemCmdletProviderEncoding>]
   [-Stream <string>]
   [<CommonParameters>]

Description

Cmdleten Add-Content lägger till innehåll i ett angivet objekt eller en fil. Du kan ange innehållet genom 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 kan du läsa Nytt objekt.

Exempel

Exempel 1: Lägg till en sträng i alla textfiler med undantag

Det här exemplet lägger till ett värde i textfiler i den aktuella katalogen men exkluderar filer baserat på deras filnamn.

Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'

Cmdleten Add-Content använder parametern Path för att ange alla .txt filer i den aktuella katalogen. Parametern Exkludera ignorerar filnamn som matchar det angivna mönstret. Parametern Value anger den textsträng som skrivs till filerna.

Använd Get-Content för att visa innehållet i dessa filer.

Exempel 2: Lägg till ett datum i slutet av de angivna filerna

I det här exemplet läggs datumet till i filer i den aktuella katalogen och datumet visas i PowerShell-konsolen.

Add-Content -Path .\DateTimeFile1.log, .\DateTimeFile2.log -Value (Get-Date) -PassThru
Get-Content -Path .\DateTimeFile1.log

Cmdleten Add-Content använder parametrarna Path och Value för att skapa två nya filer i den aktuella katalogen. Parametern Value anger cmdleten Get-Date för att hämta datumet och skickar datumet till Add-Content. Cmdleten Add-Content skriver datumet till varje fil. Parametern PassThru skickar ett objekt som representerar datumobjektet. Eftersom det inte finns någon annan cmdlet som tar emot det skickade objektet visas den i PowerShell-konsolen. Cmdleten Get-Content visar den uppdaterade filen DateTimeFile1.log.

Exempel 3: Lägg till innehållet i en angiven fil i en annan fil

Det här exemplet hämtar innehållet från en fil och lägger till innehållet i en annan fil.

Add-Content -Path .\CopyToFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)
Get-Content -Path .\CopyToFile.txt

Cmdleten Add-Content använder parametern Path för att ange den nya filen i den aktuella katalogen, CopyToFile.txt. Parametern Value använder cmdleten Get-Content för att hämta innehållet i filen, CopyFromFile.txt. Parenteserna runt cmdleten Get-Content ser till att kommandot slutförs innan Add-Content kommandot börjar. Parametern Value skickas till Add-Content. Cmdleten Add-Content lägger till data i den CopyToFile.txt filen. Cmdleten Get-Content visar den uppdaterade filen CopyToFile.txt.

Exempel 4: Använd en variabel för att lägga till innehållet i en angiven fil i en annan fil

Det här exemplet 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.txt
Add-Content -Path .\CopyToFile.txt -Value $From
Get-Content -Path .\CopyToFile.txt

Cmdleten Get-Content hämtar innehållet i CopyFromFile.txt och lagrar innehållet i variabeln $From . Cmdleten Add-Content använder parametern Path för att ange den CopyToFile.txt filen i den aktuella katalogen. Parametern Value använder variabeln $From och skickar innehållet till Add-Content. Cmdleten Add-Content uppdaterar CopyToFile.txt-filen. Cmdleten Get-Content visar CopyToFile.txt.

Exempel 5: Skapa en ny fil och kopiera innehåll

Det här exemplet 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

Cmdleten Add-Content använder parametrarna Path och Value för att skapa en ny fil i den aktuella katalogen. Parametern Value använder cmdleten Get-Content för att hämta innehållet i en befintlig fil, CopyFromFile.txt. Parenteserna runt cmdleten Get-Content ser till att kommandot slutförs innan Add-Content kommandot börjar. Parametern Value skickar det innehåll som uppdaterar NewFile.txt filen till Add-Content . Cmdleten Get-Content visar innehållet i den nya filen NewFile.txt.

Exempel 6: Lägga till innehåll i en skrivskyddad fil

Det här kommandot lägger till värdet i filen även om filattributet IsReadOnly är inställt på True. Stegen för att skapa en skrivskyddad fil ingår i exemplet.

New-Item -Path .\IsReadOnlyTextFile.txt -ItemType File
Set-ItemProperty -Path .\IsReadOnlyTextFile.txt -Name IsReadOnly -Value $True
Get-ChildItem -Path .\IsReadOnlyTextFile.txt
Add-Content -Path .\IsReadOnlyTextFile.txt -Value 'Add value to read-only text file' -Force
Get-Content -Path .\IsReadOnlyTextFile.txt

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-ar---        1/28/2019     13:35              0 IsReadOnlyTextFile.txt

Cmdleten New-Item använder parametrarna Path och ItemType för att skapa filen IsReadOnlyTextFile.txt i den aktuella katalogen. Cmdleten Set-ItemProperty använder parametrarna Name och Value för att ändra filens IsReadOnly-egenskap till True. Cmdleten Get-ChildItem visar att filen är tom (0) och har det skrivskyddade attributet (r). Cmdleten Add-Content använder parametern Path för att ange filen. Parametern Value innehåller textsträngen som ska läggas till i filen. Parametern Force skriver texten till den skrivskyddade filen. Cmdleten Get-Content använder parametern Path för att visa filens innehåll.

Om du vill ta bort det skrivskyddade attributet använder Set-ItemProperty du kommandot med parametern Value inställd på False.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Anger ett användarkonto som har behörighet att utföra den här åtgärden. Standard är den aktuella användaren.

Ange ett användarnamn, till exempel User01 eller Domain01\User01, eller ange ett PSCredential-objekt , till exempel ett som genereras av cmdleten Get-Credential . Om du skriver ett användarnamn uppmanas du att ange ett lösenord.

Varning

Den här parametern stöds inte av några providers som är installerade med PowerShell.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Encoding

Anger typ av kodning för målfilen. Standardvärdet är Standard.

Godkända värden för den här parametern är följande:

  • ASCII Använder ASCII-teckenuppsättning (7-bitars).
  • BigEndianUnicode Använder UTF-16 med den stora byteordningen.
  • BigEndianUTF32 Använder UTF-32 med den stora byteordningen.
  • Byte Kodar en uppsättning tecken till en sekvens med byte.
  • Standard Använder den kodning som motsvarar systemets aktiva kodsida (vanligtvis ANSI).
  • OEM Använder den kodning som motsvarar systemets aktuella OEM-kodsida.
  • Sträng Samma som Unicode.
  • Unicode Använder UTF-16 med den lilla byteordningen.
  • Okänd Samma som Unicode.
  • UTF7 Använder UTF-7.
  • UTF8 Använder UTF-8.
  • UTF32 Använder UTF-32 med den lilla byteordningen.

Kodning är en dynamisk parameter som FileSystem-providern lägger till i cmdleten Add-Content . Den här parametern fungerar bara på filsystemenheter.

Type:FileSystemCmdletProviderEncoding
Accepted values:ASCII, BigEndianUnicode, BigEndianUTF32, Byte, Default, OEM, String, Unicode, Unknown, UTF7, UTF8, UTF32
Position:Named
Default value:Default
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Exclude

Utelämnar de angivna objekten. Värdet för den här parametern kvalificerar parametern Path . Ange ett sökvägselement eller mönster, till exempel *.txt. Jokertecken tillåts.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Filter

Anger ett filter i providerns format eller språk. Värdet för den här parametern kvalificerar parametern Path . Syntaxen för filtret, inklusive användningen av jokertecken, beror på providern. Filter är effektivare än andra parametrar eftersom providern tillämpar filter när objekt hämtas. Annars bearbetar PowerShell filter när objekten har hämtats.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Force

Åsidosätter det skrivskyddade attributet så att du kan lägga till innehåll i en skrivskyddad fil. Force åsidosätter till exempel det skrivskyddade attributet eller skapar kataloger för att slutföra en filsökväg, men försöker inte ändra filbehörigheter.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

Lägger bara till de angivna objekten. Värdet för den här parametern kvalificerar parametern Path . Ange ett sökvägselement eller mönster, till exempel *.txt. Jokertecken tillåts.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-LiteralPath

Anger sökvägen till de objekt som tar emot ytterligare innehåll. Till skillnad från Path används värdet för LiteralPath exakt som det skrivs. Inga tecken tolkas som jokertecken. Om sökvägen innehåller escape-tecken omger du den inom enkla citattecken. Enkla citattecken säger till PowerShell att inte tolka några tecken som escape-sekvenser.

Type:String[]
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoNewline

Anger att den här cmdleten inte lägger till en ny rad eller vagnretur till innehållet.

Strängrepresentationerna av indataobjekten sammanfogas för att bilda utdata. Inga blanksteg eller nya linjer infogas mellan utdatasträngarna. Ingen ny rad läggs till efter den senaste utdatasträngen.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Returnerar ett objekt som representerar det tillagda innehållet. Som standard genererar denna cmdlet inga utdata.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Anger sökvägen till de objekt som tar emot ytterligare innehåll. Jokertecken tillåts. Om du anger flera sökvägar använder du kommatecken för att avgränsa sökvägarna.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Stream

Anger en alternativ dataström för innehåll. Om strömmen inte finns skapar den här cmdleten den. Jokertecken stöds inte.

Stream är en dynamisk parameter som FileSystem-providern lägger till i Add-Content. Den här parametern fungerar bara i filsystemenheter.

Du kan använda cmdleten Add-Content för att ändra innehållet i den alternativa dataströmmen Zone.Identifier . Vi rekommenderar dock inte detta som ett sätt att eliminera säkerhetskontroller som blockerar filer som laddas ned från Internet. Om du kontrollerar att en nedladdad fil är säker använder du cmdleten Unblock-File .

Den här parametern introducerades i PowerShell 3.0.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseTransaction

Inkluderar kommandot i den aktiva transaktionen. Den här parametern är bara giltig medan en transaktion pågår. Mer information finns i about_Transactions.

Type:SwitchParameter
Aliases:usetx
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Value

Anger det innehåll som ska läggas till. Skriv en citerad sträng, till exempel Dessa data är endast för internt bruk, eller ange ett objekt som innehåller innehåll, till exempel DateTime-objektet 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 ett Get-Content kommando för att hämta innehållet och skicka det till parametern Value .

Type:Object[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

System.Object, System.Management.Automation.PSCredential

Du kan skicka värden, sökvägar eller autentiseringsuppgifter till Set-Content.

Utdata

None or System.String

När du använder parametern Add-ContentPassThru genererar ett System.String-objekt som representerar innehållet. Annars genererar denna cmdlet inga utdata.

Kommentarer

När du skickar ett objekt till Add-Contentkonverteras objektet till en sträng innan det läggs till i objektet. Objekttypen avgör strängformatet, men formatet kan skilja sig från standardvisningen av objektet. Om du vill styra strängformatet använder du formateringsparametrarna för den sändande cmdleten.

Du kan också referera till Add-Content med dess inbyggda alias, ac. Mer information finns i about_Aliases.

Cmdleten Add-Content är utformad för att fungera med data som exponeras av alla leverantörer. Om du vill visa en lista över de providrar som är tillgängliga i sessionen skriver du Get-PSProvider. Mer information finns i about_Providers.