tilføjer indhold til de angivne elementer, f.eks. tilføjelse af ord til en fil.
- syntaks
- Description
- eksempler
- eksempel 1: Føj en streng til alle tekstfiler med undtagelse
- eksempel 2: Tilføj en dato til slutningen af de angivne filer
- eksempel 3: Føj indholdet af en bestemt fil til en anden fil
- eksempel 4: Føj indholdet af en specificeret fil til en anden fil ved hjælp af pipeline
- eksempel 5: Opret en ny fil og kopier indhold
- eksempel 6: Føj indhold til en skrivebeskyttet fil
- eksempel 7: Brug filtre med Tilføjelsesindhold
- parametre
- indgange
- udgange
- noter
syntaks
Add-Content <string> <Object> >] >]
Add-Content <Object> -LiteralPath <string> >] >]
Description
Add-Content
cmdlet tilføjer indhold til en bestemt vare eller fil. Du kan angive indholdetved at skrive indholdet i kommandoen eller ved at angive et objekt, der indeholder indholdet.
Hvis du har brug for at oprette filer eller mapper til følgende eksempler, skal du se nyt element.
eksempler
eksempel 1: Føj en streng til alle tekstfiler med undtagelse
dette eksempel tilføjer en værdi til tekstfiler i den aktuelle mappe, men ekskluderer filer baseret på deres filnavn.
Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'
Path-parameteren angiver alle.txt
filer i den aktuelle mappe, men Udelukkelseparameter ignorerer filnavne, der matcher det angivne mønster. Værdiparameteren specificerertekststreng, der er skrevet til filerne.
eksempel 2: Tilføj en dato til slutningen af de angivne filer
dette eksempel føjer datoen til filer i den aktuelle mappe og viser datoen i kraftværkskonsollen.
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 opretter to nye filer i den aktuelle mappe. Værdiparameteren indeholderudgangen fra Get-Date
cmdlet. PassThru-parameteren udsender det tilføjede indhold til rørledningen.Da der ikke er nogen anden cmdlet til at modtage output, vises den i Kraftshell-konsollen.Get-Content
cmdlet viser den opdaterede fil, DateTimeFile1.log
.
eksempel 3: Føj indholdet af en bestemt fil til en anden fil
dette eksempel henter indholdet fra en fil og gemmer indholdet i en variabel. Variablen bruges til at tilføje indholdet til en anden fil.
$From = Get-Content -Path .\CopyFromFile.txtAdd-Content -Path .\CopyToFile.txt -Value $FromGet-Content -Path .\CopyToFile.txt
-
Get-Content
cmdlet får indholdet afCopyFromFile.txt
og gemmer indholdet i$From
variablen. -
Add-Content
cmdlet opdatererCopyToFile.txt
filen ved hjælp af indholdet af$From
variablen. -
Get-Content
cmdlet viser CopyToFile.TST.
eksempel 4: Føj indholdet af en specificeret fil til en anden fil ved hjælp af pipeline
dette eksempel henter indholdet fra en fil og rør det tilAdd-Content
cmdlet.
Get-Content -Path .\CopyFromFile.txt | Add-Content -Path .\CopyToFile.txtGet-Content -Path .\CopyToFile.txt
Get-Content
cmdlet får indholdet afCopyFromFile.txt
. Resultaterne ledes tilAdd-Content
cmdlet, som opdaterer CopyToFile.txt
.Den sidste Get-Content
cmdlet viser CopyToFile.txt
.
eksempel 5: Opret en ny fil og kopier indhold
dette eksempel opretter en ny fil og kopierer en eksisterende fils indhold til den nye fil.
Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)Get-Content -Path .\NewFile.txt
-
Add-Content
cmdlet bruger stien og Værdiparametrene til at oprette en ny fil inuværende mappe. -
Get-Content
cmdlet får indholdet af en eksisterende fil,CopyFromFile.txt
og sender det til Værdiparameteren. Parenteserne omkringGet-Content
cmdlet sikrer, at kommandoen slutter, før kommandoenAdd-Content
begynder. -
Get-Content
cmdlet viser indholdet af den nye fil,NewFile.txt
.
eksempel 6: Føj indhold til en skrivebeskyttet fil
denne kommando tilføjer en værdi til filen, selvom attributten IsReadOnly file er indstillet til True.Trinene til oprettelse af en skrivebeskyttet fil er inkluderet 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
cmdlet bruger Path and ItemType parametre til at oprette filenIsReadOnlyTextFile.txt
i den aktuelle mappe. -
Set-ItemProperty
cmdlet bruger navn og værdi parametre til at ændre filens isreadonly ejendom til sand. -
Get-ChildItem
cmdlet viser filen er tom (0) og har skrivebeskyttet attribut (r
). -
Add-Content
cmdlet bruger Path-parameteren til at specificere filen. Værdiparameteretomfatter den tekststreng, der skal føjes til filen. Kraftparameteren skriver teksten tillæs kun fil. -
Get-Content
cmdlet bruger Path-parameteren til at vise filens indhold.
for at fjerne skrivebeskyttet attribut skal du bruge kommandoenSet-ItemProperty
med Værdiparametersæt tilFalse
.
eksempel 7: Brug filtre med Tilføjelsesindhold
Du kan angive et filter til Add-Content
cmdlet. Når du bruger filtre til at kvalificere Stienparameter, skal du medtage en efterfølgende stjerne (*
) for at angive indholdet afsti.
følgende kommando tilføjer ordet “udført” indholdet af alle*.txt
filer iC:\Temp
mappe.
Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"
parametre
angiver, at indholdet skal læses som en strøm af bytes. Denne parameter blev introduceret imagt 6.0.
der vises en advarsel, når du bruger parameteren asbytestream med Kodningsparameteren. 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: | Skifteparameter |
aliaser: | cf |
Position: | navngivet |
Standardværdi: | falsk |
Accepter pipeline input: | false |
accepter jokertegn: | false |
bemærk
denne parameter understøttes ikke af nogen udbydere installeret med PowerShell.To efterligne en anden bruger,eller ophøje dine legitimationsoplysninger, når du kører denne cmdlet, bruge 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. Detteparameter fungerer kun i filsystemdrev.
de acceptable værdier for denne parameter er som følger:
-
ascii
: bruger kodningen til ASCII (7-bit) tegnsæt. -
bigendianunicode
: koder i UTF-16-format ved hjælp af big-endian byte-ordren. -
bigendianutf32
: koder i UTF-32-format ved hjælp af big-endian byte-ordren. -
oem
: bruger standardkodningen til MS-DOS og konsolprogrammer. -
unicode
: Koder i UTF-16-format ved hjælp af little-endian byte-ordren. -
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 uden Byte Order Mark (BOM) -
utf32
: koder i UTF-8 format uden Byte Order Mark (BOM) -
utf32
: koder i UTF-32 format.
begynder med Strømshell 6.2 tillader Kodningsparameteren også numeriske id ‘ er for registrerede kodesider (som -Encoding 1251
) eller strengnavne på registrerede kodesider (som-Encoding "windows-1251"
). For mere information, se. net dokumentation forkodning.tegntabel.
Bemærk
UTF-7* anbefales ikke længere at bruge. I Kraftshell 7.1 skrives en advarsel, hvis duAngiv utf7
for Kodningsparameteren.
Type: | kodning |
accepterede værdier: | 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. Indtast et stielement eller et mønster, såsom*.txt
. Jokertegn er tilladt. Parameteren Ekskluder er kun effektiv, nårkommandoen indeholder indholdet af et element, f.eks C:\Windows\*
, hvor jokertegnet angiver indholdet af C:\Windows
mappe.
Type: | String |
Position: | navngivet | Standardværdi: | ingen |
Accepter pipeline input: | falsk |
accepter jokertegn: | True |
angiver et filter for at kvalificere Path-parameteren. Den FileSystemprovider er den eneste installerede Strømshell udbyder, der understøtter brugen af filtre. Du kan finde syntaksen for filsystemfiltersproget i om_kort.Filtre er mere effektive end andre parametre, fordi udbyderen anvender dem, når cmdletgets objekterne i stedet for at have Strømshell filtrere objekterne, efter at de er hentet.
Type: | String |
Position: | navngivet |
Standardværdi: | ingen |
Accepter pipeline input: | False |
Accepter jokertegn: | True |
tilsidesætter skrivebeskyttet attribut, så du kan tilføje indhold til en skrivebeskyttet fil. For eksempel vil Force tilsidesætte skrivebeskyttet attributten eller oprette mapper for at fuldføre en filsti, mendet vil ikke forsøge at ændre filtilladelser.
Type: | Skiftparameter |
Position: | navngivet |
Standardværdi: | ingen |
Accepter pipeline input: | False |
Accepter jokertegn: | False |
angiver som et strengarray et element eller elementer, som denne cmdlet inkluderer i operationen. Værdien af denne parameter kvalificerer Path-parameteren. Indtast et stielement eller et mønster, såsom"*.txt"
. Jokertegn er tilladt. Parameteren Inkluder er kun effektiv, nårkommandoen indeholder indholdet af et element, f.eks C:\Windows\*
, hvor jokertegnet angiver indholdet af C:\Windows
mappe.
Type: | String |
Position: | navngivet | Standardværdi: | ingen |
Accepter pipeline input: | falsk |
accepter jokertegn: | True |
angiver en sti til en eller flere steder. Værdien af LiteralPath bruges nøjagtigt som den ertypet. Ingen tegn fortolkes som jokertegn. Hvis stien indeholder escape-tegn, skal du omslutte det i enkelte anførselstegn. Enkelte anførselstegn fortælle Magtskal ikke at fortolke nogen tegnsom flugt sekvenser.
For mere information, se about_citation_rules.
Type: | streng |
aliaser: | PSPath, LP |
Position: | navngivet | Standardværdi: | ingen |
Accepter pipeline input: | sand |
Accepter jokertegn: | false |
angiver, at denne cmdlet ikke tilføjer en ny linje eller vognretur til indholdet.
strengrepræsentationerne af inputobjekterne sammenkædes for at danne output. Ingen mellemrum ellernyheder indsættes mellem outputstrengene. Ingen ny linje tilføjes efter den sidste outputstreng.
Type: | Skifteparameter |
Position: | navngivet | Standardværdi: | ingen |
accepter pipeline input: | false |
accepter jokertegn: | false |
returnerer et objekt, der repræsenterer det tilføjede indhold. Som standard genererer denne cmdlet ikke nogenoutput.
Type: | Skifteparameter |
Position: | navngivet | Standardværdi: | ingen |
Accepter pipeline input: | False |
Accepter jokertegn: | false |
angiver stien til de elementer, der modtager det ekstra indhold.Jokertegn er tilladt.Stierne skal være stier til genstande, ikke til containere.Du skal f.eks. angive en sti til en eller flere filer, Ikke en sti til en mappe.Hvis du angiver flere stier, skal du bruge kommaer til at adskille stierne.
Type: | String |
Position: | 0 |
Standardværdi: | ingen |
Accepter pipeline input: | true |
accepter jokertegn: | true |
Bemærk
denne parameter er kun tilgængelig på vinduer.
angiver en alternativ datastrøm for indhold. Hvis strømmen ikke findes, opretter denne cmdletdet. Jokertegn understøttes ikke.
Stream er en dynamisk parameter, som filsystemudbyderen tilføjer til Add-Content
. Detteparameter fungerer kun i filsystemdrev.
Du kan brugeAdd-Content
cmdlet til at ændre indholdet af enhver alternatedata-strøm, såsomZone.Identifier
. Vi anbefaler dog ikke dette somen måde at fjerne sikkerhedskontrol, der blokerer filer, der hentes frainternettet. Hvis du bekræfter, at en hentet fil er sikker, skal du brugeUnblock-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 Citeret streng, som disse data kun er til intern brug, eller angiv et objekt, der indeholder indhold, f.eks. det DateTime-objekt, som Get-Date
genererer.
Du kan ikke angive indholdet af en fil ved at skrive dens sti, fordi stien kun er en streng.Du kan bruge en Get-Content
kommando for at få indholdet og videregive det til Værdiparameteren.
Type: | objekt |
Position: | 1 |
Standardværdi: | ingen |
Accepter pipeline input: | 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 |
indgange
System.Objekt, System.Forvaltning.Automation.PSCredential
Du kan pipe værdier, stier eller legitimationsoplysninger tilSet-Content
.
udgange
ingen eller System.String
Når du bruger PassThru-parameteren,Add-Content
genererer et System.String objekt, somrepræsenterer indholdet. Ellers genererer denne cmdlet ikke noget output.
noter
- når du Piper et objekt til
Add-Content
, konverteres objektet til en streng, før det tilføjes tilelementet. Objekttypen bestemmer strengformatet, men formatet kan være anderledes end default visning af objektet. For at styre strengformatet skal du bruge formateringsparametrene afsender cmdlet. - du kan også henvise til
Add-Content
ved dets indbyggede alias,ac
. For mere information, seabout_aliases. -
Add-Content
cmdlet er designet til at arbejde med de data, der udsættes af enhver udbyder. For at liste de udbydere, der er tilgængelige i din session, skal du skriveGet-PSProvider
. For mere information, seabout_providers.
- about_Aliases
- about_Providers
- Clear-Content
- Get-Content
- Get-Item
- ny-Item
- Set-Content