Delen via

Add-Content

  • Referentie
Module:
Microsoft.PowerShell.Management

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

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

De Add-Content cmdlet voegt inhoud toe aan een opgegeven item of bestand. U kunt de inhoud opgeven door de inhoud in de opdracht te typen of door een object op te geven dat de inhoud bevat.

Als u bestanden of mappen wilt maken voor de volgende voorbeelden, raadpleegt u New-Item.

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 Add-Content cmdlet gebruikt de path-parameter om alle .txt bestanden in de huidige map op te geven. De parameter Exclude negeert bestandsnamen die overeenkomen met het opgegeven patroon. De waardeparameter 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

De Add-Content cmdlet gebruikt de parameters Pad en Waarde om twee nieuwe bestanden in de huidige map te maken. De waardeparameter geeft de Get-Date cmdlet op om de datum op te halen en geeft de datum door aan Add-Content. De Add-Content cmdlet schrijft de datum naar elk bestand. De parameter PassThru geeft een object door dat het datumobject vertegenwoordigt. Omdat er geen andere cmdlet is om het doorgegeven object te ontvangen, wordt het weergegeven in de PowerShell-console. De Get-Content cmdlet 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 toegevoegd aan een ander bestand.

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

De Add-Content cmdlet gebruikt de path-parameter om het nieuwe bestand in de huidige map op te geven, CopyToFile.txt. De waardeparameter gebruikt de Get-Content cmdlet om de inhoud van het bestand op te halen, CopyFromFile.txt. De haakjes rond de Get-Content cmdlet zorgen ervoor dat de opdracht wordt voltooid voordat de Add-Content opdracht begint. De waardeparameter wordt doorgegeven aan Add-Content. De Add-Content cmdlet voegt de gegevens toe aan het CopyToFile.txt-bestand. De Get-Content cmdlet geeft het bijgewerkte bestand weer, CopyToFile.txt.

Voorbeeld 4: een variabele gebruiken om de inhoud van een opgegeven bestand toe te voegen 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 Get-Content cmdlet haalt de inhoud van CopyFromFile.txt op en slaat de inhoud op in de $From variabele. De Add-Content cmdlet gebruikt de path parameter om het CopyToFile.txt bestand in de huidige map op te geven. De waardeparameter gebruikt de $From variabele en geeft de inhoud door aan Add-Content. De Add-Content cmdlet werkt het CopyToFile.txt-bestand bij. De Get-Content cmdlet geeft CopyToFile.txt weer.

Voorbeeld 5: een nieuw bestand Creatie 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 Add-Content cmdlet gebruikt de parameters Pad en Waarde om een nieuw bestand in de huidige map te maken. De parameter Value gebruikt de Get-Content cmdlet om de inhoud van een bestaand bestand op te halen, CopyFromFile.txt. De haakjes rond de Get-Content cmdlet zorgen ervoor dat de opdracht wordt voltooid voordat de Add-Content opdracht begint. De waardeparameter geeft de inhoud door Add-Content waarnaar het NewFile.txt-bestand wordt bijgewerkt. De Get-Content cmdlet 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 de waarde aan het bestand toegevoegd, zelfs als het bestandskenmerk IsReadOnly is ingesteld op True. De stappen voor het maken van een bestand met het kenmerk Alleen-lezen zijn 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 IsReadOnlyTextFile.txt in de huidige map te maken. De Set-ItemProperty cmdlet gebruikt de parameters Naam en Waarde om de eigenschap IsReadOnly van het bestand te wijzigen in Waar. De Get-ChildItem cmdlet geeft aan dat het bestand leeg is (0) en het kenmerk Alleen-lezen heeft (r). De Add-Content cmdlet gebruikt de padparameter om het bestand op te geven. De parameter Value bevat de tekenreeks die aan het bestand moet worden toegevoegd. De parameter Force schrijft de tekst naar het alleen-lezen bestand. De Get-Content cmdlet gebruikt de parameter Path om de inhoud van het bestand weer te geven.

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

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Credential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om deze actie uit te voeren. Standaard is dit de huidige gebruiker.

Typ een gebruikersnaam, zoals User01 of Domain01\User01, of voer een PSCredential-object in, zoals een object dat wordt gegenereerd door de Get-Credential cmdlet. Als u een gebruikersnaam typt, wordt u gevraagd om een wachtwoord.

Waarschuwing

Deze parameter wordt niet ondersteund door providers die zijn geïnstalleerd met PowerShell.

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

-Encoding

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

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 Gebruikt UTF-32 met de bytevolgorde big-endian.
  • Byte Codeert een reeks tekens in een reeks bytes.
  • Standaard 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.
  • Tekenreeks Hetzelfde als Unicode.
  • Unicode Gebruikt UTF-16 met de bytevolgorde little-endian.
  • Onbekende 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 bestandssysteemprovider toevoegt aan de Add-Content cmdlet. Deze parameter werkt alleen in bestandssysteemstations.

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

Laat de opgegeven items weg. De waarde van deze parameter komt in aanmerking voor de path-parameter . Voer een padelement of -patroon in, zoals *.txt. Jokertekens zijn toegestaan.

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

-Filter

Hiermee geeft u een filter op in de indeling of taal van de provider. De waarde van deze parameter komt in aanmerking voor de path-parameter . De syntaxis van het filter, inclusief het gebruik van jokertekens, is afhankelijk van de provider. Filters zijn efficiënter dan andere parameters omdat de provider filters toepast wanneer objecten worden opgehaald. Anders worden filters door PowerShell verwerkt nadat de objecten zijn opgehaald.

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

-Force

Hiermee overschrijft u het kenmerk Alleen-lezen, zodat u inhoud kunt toevoegen aan een bestand met het kenmerk Alleen-lezen. Force overschrijft bijvoorbeeld het kenmerk Alleen-lezen of maakt mappen om een bestandspad te voltooien, maar er wordt niet geprobeerd de bestandsmachtigingen te wijzigen.

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

-Include

Hiermee voegt u alleen de opgegeven items toe. De waarde van deze parameter komt in aanmerking voor de path-parameter . Voer een padelement of -patroon in, zoals *.txt. Jokertekens zijn toegestaan.

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

-LiteralPath

Hiermee geeft u het pad naar de items die de aanvullende inhoud ontvangen. In tegenstelling tot Path wordt de waarde van LiteralPath precies gebruikt zoals deze is getypt. Geen tekens worden geïnterpreteerd als jokertekens. Als het pad escape-tekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens geven PowerShell aan dat geen tekens als escape-reeksen worden geïnterpreteerd.

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

-NoNewline

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

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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

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

-Path

Hiermee geeft u het pad naar de items die de aanvullende inhoud ontvangen. Jokertekens zijn toegestaan. Als u meerdere paden opgeeft, gebruikt u komma's om de paden van elkaar te scheiden.

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

-Stream

Hiermee geeft u een alternatieve gegevensstroom voor inhoud. Als de stroom niet bestaat, wordt deze met deze cmdlet gemaakt. Jokertekens worden niet ondersteund.

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

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

Deze parameter is geïntroduceerd in PowerShell 3.0.

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

-UseTransaction

Hiermee wordt de opdracht opgenomen in de actieve transactie. Deze parameter is alleen geldig wanneer een transactie wordt uitgevoerd. Zie about_Transactions voor meer informatie.

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

-Value

Hiermee geeft u de inhoud moet worden toegevoegd. Typ een tekenreeks met aanhalingstekens, zoals Deze gegevens zijn alleen voor intern gebruik, of geef een object op dat inhoud bevat, zoals het datetime-object dat Get-Date wordt gegenereerd.

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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

System.Object, System.Management.Automation.PSCredential

U kunt waarden, paden of referenties doorsluizen naar Set-Content.

Uitvoerwaarden

None or System.String

Wanneer u de parameter PassThru gebruikt, Add-Content wordt een System.String-object gegenereerd dat de inhoud vertegenwoordigt. Anders genereert deze cmdlet geen uitvoer.

Notities

Wanneer u een object doorsluist naar Add-Content, wordt het object geconverteerd naar een tekenreeks voordat het aan het item wordt toegevoegd. 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.

U kunt ook verwijzen naar door de Add-Content ingebouwde alias, ac. Zie about_Aliases voor meer informatie.

De Add-Content cmdlet 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_Providers voor meer informatie.