Add-Innhold

Modul: Microsoft. PowerShell.Administrasjon

Legger til innhold i de angitte elementene, for eksempel å legge til ord i en fil.

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$Fromvariabelen.
  • 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.txtog sender den til Verdiparameteren. Parentesene rundt Get-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 filen IsReadOnlyTextFile.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:\Tempkatalogen.

Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"

Parametere

-AsByteStream

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

Prompts you for confirmation before running the cmdlet.

Type: Godta pipeline inngang: false
godta jokertegn: false
-credential

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
-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 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.
  • unicode: Koder I utf-16 format ved hjelp av little-endian byte rekkefølge.

  • utf7: Koder i utf-7-format.
  • utf8: Koder i utf-8-format.
  • utf8BOM: Koder I utf-8-format med Byte Order Mark (BOM)

  • utf8NoBOM: Koder i utf-8-format uten Byte Order Mark (BOM)
  • utf32: Koder i utf-32-format.

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

-Filter

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

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

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

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

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

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

– path

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

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

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

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
-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: 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 du Get-PSProvider. For mer informasjon, seabout_providers.
  • Clear-Content
  • Get-Item
  • New-Item
  • Set-Content

Related Posts

Legg igjen en kommentar

Din e-postadresse vil ikke bli publisert. Obligatoriske felt er merket med *