Tilføj indhold

modul: Microsoft.Kraftskal.Management

tilføjer indhold til de angivne elementer, f.eks. tilføjelse af ord til en fil.

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 af CopyFromFile.txt og gemmer indholdet i$From variablen.
  • Add-Contentcmdlet opdaterer CopyToFile.txtfilen 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-Contentcmdlet 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.txtog sender det til Værdiparameteren. Parenteserne omkring Get-Content cmdlet sikrer, at kommandoen slutter, før kommandoen Add-Content begynder.
  • Get-Contentcmdlet 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-ChildItemcmdlet 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-ItemPropertymed 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*.txtfiler iC:\Temp mappe.

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

parametre

-AsByteStream

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

-Confirm

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

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

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

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

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
-ikke-ny linje

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

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

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

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

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

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

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-Contentved 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 skrive Get-PSProvider. For mere information, seabout_providers.
  • about_Aliases
  • about_Providers
  • Clear-Content
  • Get-Content
  • Get-Item
  • ny-Item
  • Set-Content

Related Posts

Skriv et svar

Din e-mailadresse vil ikke blive publiceret. Krævede felter er markeret med *