Delen via

Add-Content

  • Referentie
Module:
Microsoft.PowerShell.Management

Hiermee voegt u inhoud toe aan de opgegeven items, zoals woorden toevoegen aan een bestand.

Syntaxis

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

De Add-Content cmdlet voegt inhoud toe aan een opgegeven item of bestand. Inhoud kan worden doorgegeven vanuit de pijplijn of worden opgegeven met behulp van de parameter Waarde.

Zie New-Itemals u bestanden of mappen wilt maken voor de volgende voorbeelden.

Voorbeelden

Voorbeeld 1: Een tekenreeks toevoegen aan alle tekstbestanden met een uitzondering

In dit voorbeeld wordt een waarde toegevoegd aan tekstbestanden in de huidige map, maar worden bestanden uitgesloten op basis van hun bestandsnaam.

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

De parameter Path geeft alle .txt bestanden in de huidige map op, maar de parameter Uitsluiten negeert bestandsnamen die overeenkomen met het opgegeven patroon. De parameter Waarde geeft de tekenreeks op die naar de bestanden wordt geschreven.

Gebruik Get-Content- om de inhoud van deze bestanden weer te geven.

Voorbeeld 2: Een datum toevoegen aan het einde van de opgegeven bestanden

In dit voorbeeld wordt de datum toegevoegd aan bestanden in de huidige map en wordt de datum weergegeven in de PowerShell-console.

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

Tuesday, May 14, 2019 8:24:27 AM
Tuesday, May 14, 2019 8:24:27 AM
5/14/2019 8:24:27 AM

De cmdlet Add-Content maakt twee nieuwe bestanden in de huidige map. De parameter Value bevat de uitvoer van de cmdlet Get-Date. De parameter PassThru voert de toegevoegde inhoud uit aan de pijplijn. Omdat er geen andere cmdlet is om de uitvoer te ontvangen, wordt deze weergegeven in de PowerShell-console. De cmdlet Get-Content geeft het bijgewerkte bestand weer, DateTimeFile1.log.

Voorbeeld 3: De inhoud van een opgegeven bestand toevoegen aan een ander bestand

In dit voorbeeld wordt de inhoud uit een bestand opgehaald en wordt de inhoud opgeslagen in een variabele. De variabele wordt gebruikt om de inhoud toe te voegen aan een ander bestand.

$From = Get-Content -Path .\CopyFromFile.txt
Add-Content -Path .\CopyToFile.txt -Value $From
Get-Content -Path .\CopyToFile.txt
  • De cmdlet Get-Content haalt de inhoud van CopyFromFile.txt op en slaat de inhoud op in de variabele $From.
  • De Add-Content-cmdlet werkt het CopyToFile.txt-bestand bij met behulp van de inhoud van de variabele $From.
  • De cmdlet Get-Content geeft CopyToFile.txtweer.

Voorbeeld 4: De inhoud van een opgegeven bestand toevoegen aan een ander bestand met behulp van de pijplijn

In dit voorbeeld wordt de inhoud opgehaald uit een bestand en wordt deze door de Add-Content-cmdlet gebuit.

Get-Content -Path .\CopyFromFile.txt | Add-Content -Path .\CopyToFile.txt
Get-Content -Path .\CopyToFile.txt

De cmdlet Get-Content haalt de inhoud van CopyFromFile.txtop. De resultaten worden doorgesluisd naar de Add-Content-cmdlet, waarmee de CopyToFile.txtwordt bijgewerkt. In de laatste Get-Content cmdlet wordt CopyToFile.txtweergegeven.

Voorbeeld 5: Een nieuw bestand maken en inhoud kopiëren

In dit voorbeeld wordt een nieuw bestand gemaakt en wordt de inhoud van een bestaand bestand gekopieerd naar het nieuwe bestand.

Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)
Get-Content -Path .\NewFile.txt
  • De cmdlet Add-Content maakt gebruik van de parameters Path en Value om een nieuw bestand in de huidige map te maken.
  • Met de cmdlet Get-Content wordt de inhoud van een bestaand bestand opgehaald, CopyFromFile.txt en doorgegeven aan de parameter Waarde. De haakjes rond de Get-Content cmdlet zorgen ervoor dat de opdracht is voltooid voordat de Add-Content opdracht begint.
  • De cmdlet Get-Content geeft de inhoud van het nieuwe bestand weer, NewFile.txt.

Voorbeeld 6: Inhoud toevoegen aan een bestand met het kenmerk Alleen-lezen

Met deze opdracht wordt een waarde aan het bestand toegevoegd, zelfs als het kenmerk IsReadOnly- is ingesteld op True. De stappen voor het maken van een alleen-lezenbestand worden opgenomen in het voorbeeld.

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
  • De New-Item-cmdlet gebruikt de parameters Path en ItemType om het bestand te maken IsReadOnlyTextFile.txt in de huidige map.
  • De cmdlet Set-ItemProperty gebruikt de parameters Name en Value om de eigenschap IsReadOnly van het bestand te wijzigen in Waar.
  • De Get-ChildItem cmdlet toont dat het bestand leeg is (0) en heeft het kenmerk Alleen-lezen (r).
  • De cmdlet Add-Content gebruikt de parameter Path om het bestand op te geven. De parameter Waarde bevat de tekenreeks die aan het bestand moet worden toegevoegd. De parameter Forceren schrijft de tekst naar het bestand met het kenmerk Alleen-lezen.
  • De cmdlet Get-Content maakt gebruik van de parameter Path om de inhoud van het bestand weer te geven.

Als u het kenmerk Alleen-lezen wilt verwijderen, gebruikt u de opdracht Set-ItemProperty met de parameter Waarde ingesteld op False.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Notitie

Deze parameter wordt niet ondersteund door providers die zijn geïnstalleerd met PowerShell. Als u een andere gebruiker wilt imiteren of uw referenties wilt verhogen bij het uitvoeren van deze cmdlet, gebruikt u Invoke-Command-.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Encoding

Hiermee geeft u het type codering voor het doelbestand. De standaardwaarde is Default.

De acceptabele waarden voor deze parameter zijn als volgt:

  • Ascii maakt gebruik van ASCII-tekenset (7-bits).
  • BigEndianUnicode gebruikt UTF-16 met de bytevolgorde big-endian.
  • BigEndianUTF32 maakt gebruik van UTF-32 met de big-endian bytevolgorde.
  • Byte codeert een reeks tekens in een reeks bytes.
  • Default gebruikt de codering die overeenkomt met de actieve codepagina van het systeem (meestal ANSI).
  • Oem gebruikt de codering die overeenkomt met de huidige OEM-codepagina van het systeem.
  • String Hetzelfde als Unicode-.
  • Unicode gebruikt UTF-16 met de bytevolgorde little-endian.
  • Unknown Hetzelfde als Unicode-.
  • UTF7 maakt gebruik van UTF-7.
  • UTF8 maakt gebruik van UTF-8.
  • UTF32 gebruikt UTF-32 met de bytevolgorde little-endian.

Encoding is een dynamische parameter die de FileSystem-provider toevoegt aan de cmdlet Add-Content. Deze parameter werkt alleen in bestandssysteemstations.

Type:FileSystemCmdletProviderEncoding
Geaccepteerde waarden:ASCII, BigEndianUnicode, BigEndianUTF32, Byte, Default, OEM, String, Unicode, Unknown, UTF7, UTF8, UTF32
Position:Named
Default value:Default
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Exclude

Hiermee geeft u, als een tekenreeksmatrix, een item of items op die door deze cmdlet worden uitgesloten in de bewerking. De waarde van deze parameter komt in aanmerking voor de parameter Path. Voer een padelement of patroon in, zoals *.txt. Jokertekens zijn toegestaan. De parameter Uitsluiten is alleen van kracht wanneer de opdracht de inhoud van een item bevat, zoals C:\Windows\*, waarbij het jokerteken de inhoud van de C:\Windows map aangeeft.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-Filter

Hiermee geeft u een filter op om de parameter Path te kwalificeren. De FileSystem-provider is de enige geïnstalleerde PowerShell-provider die het gebruik van filters ondersteunt. U vindt de syntaxis voor de Bestandssysteem filtertaal in about_Wildcards. Filters zijn efficiënter dan andere parameters, omdat de provider deze toepast wanneer de cmdlet de objecten ophaalt in plaats van PowerShell de objecten te filteren nadat ze zijn opgehaald.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-Force

Overschrijft het kenmerk Alleen-lezen, zodat u inhoud aan een alleen-lezenbestand kunt toevoegen. Forceert bijvoorbeeld het kenmerk Alleen-lezen, maar wijzigt geen bestandsmachtigingen.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Include

Hiermee geeft u, als tekenreeksmatrix, een item of items op die deze cmdlet in de bewerking bevat. De waarde van deze parameter komt in aanmerking voor de parameter Path. Voer een padelement of patroon in, zoals "*.txt". Jokertekens zijn toegestaan. De parameter Opnemen is alleen van kracht wanneer de opdracht de inhoud van een item bevat, zoals C:\Windows\*, waarbij het jokerteken de inhoud van de C:\Windows map aangeeft.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-LiteralPath

Hiermee geeft u een pad naar een of meer locaties. De waarde van LiteralPath- wordt precies gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens geven PowerShell aan dat er geen tekens als escapereeksen moeten worden geïnterpreteerd.

Zie about_Quoting_Rulesvoor meer informatie.

Type:String[]
Aliassen:PSPath
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-NoNewline

Geeft aan dat deze cmdlet geen nieuwe regel of regelterugloop toevoegt aan de inhoud.

De tekenreeksweergaven van de invoerobjecten worden samengevoegd om de uitvoer te vormen. Er worden geen spaties of nieuwe regels ingevoegd tussen de uitvoertekenreeksen. Er wordt geen nieuwe regel toegevoegd na de laatste uitvoertekenreeks.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PassThru

Retourneert een object dat de toegevoegde inhoud vertegenwoordigt. Deze cmdlet genereert standaard geen uitvoer.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

Hiermee geeft u het pad naar de items die de aanvullende inhoud ontvangen. Jokertekens zijn toegestaan. De paden moeten paden naar items zijn, niet naar containers. U moet bijvoorbeeld een pad naar een of meer bestanden opgeven, niet een pad naar een map. Als u meerdere paden opgeeft, gebruikt u komma's om de paden te scheiden.

Type:String[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

-Stream

Hiermee geeft u een alternatieve gegevensstroom voor inhoud op. Als de stream niet bestaat, maakt deze cmdlet deze. Jokertekens worden niet ondersteund.

Stream is een dynamische parameter die de bestandssysteemprovider toevoegt aan Add-Content. Deze parameter werkt alleen in bestandssysteemstations.

U kunt de cmdlet Add-Content gebruiken om de inhoud van een alternatieve gegevensstroom te wijzigen, zoals Zone.Identifier. We raden dit echter niet aan als een manier om beveiligingscontroles te voorkomen die bestanden blokkeren die van internet worden gedownload. Als u controleert of een gedownload bestand veilig is, gebruikt u de cmdlet Unblock-File.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UseTransaction

Bevat de opdracht in de actieve transactie. Deze parameter is alleen geldig wanneer een transactie wordt uitgevoerd. Zie about_Transactionsvoor meer informatie.

Type:SwitchParameter
Aliassen:usetx
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Value

Hiermee geeft u de inhoud die moet worden toegevoegd. Typ een tekenreeks tussen aanhalingstekens, zoals Deze gegevens zijn alleen voor intern gebruikof geef een object op dat inhoud bevat, zoals het DateTime--object dat Get-Date genereert.

U kunt de inhoud van een bestand niet opgeven door het pad te typen, omdat het pad slechts een tekenreeks is. U kunt een Get-Content opdracht gebruiken om de inhoud op te halen en door te geven aan de parameter waarde.

Type:Object[]
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Object

U kunt waarden doorsluisen naar Add-Content.

PSCredential

U kunt referenties doorsluizen naar Add-Content.

Uitvoerwaarden

None

Deze cmdlet retourneert standaard geen uitvoer.

String

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een System.String object dat de inhoud vertegenwoordigt.

Notities

Windows PowerShell bevat de volgende aliassen voor Add-Content:

  • ac

  • Wanneer u een object doorsluist naar Add-Content, wordt het object geconverteerd naar een tekenreeks voordat het wordt toegevoegd aan het item. Het objecttype bepaalt de tekenreeksindeling, maar de indeling kan afwijken van de standaardweergave van het object. Als u de tekenreeksindeling wilt beheren, gebruikt u de opmaakparameters van de verzendende cmdlet.

  • De cmdlet Add-Content is ontworpen om te werken met de gegevens die door elke provider worden weergegeven. Als u de providers wilt weergeven die beschikbaar zijn in uw sessie, typt u Get-PSProvider. Zie about_Providersvoor meer informatie.