Add-Content

Syntaxis

Path (Standaard)

Add-Content
    [-Path] <string[]>
    [-Value] <Object[]>
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-NoNewline]
    [-Encoding <Encoding>]
    [-AsByteStream]
    [-Stream <string>]
    [<CommonParameters>]

LiteralPath

Add-Content
    [-Value] <Object[]>
    -LiteralPath <string[]>
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-NoNewline]
    [-Encoding <Encoding>]
    [-AsByteStream]
    [-Stream <string>]
    [<CommonParameters>]

Description

Voorbeelden

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

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

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

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

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

$From = Get-Content -Path .\CopyFromFile.txt
Add-Content -Path .\CopyToFile.txt -Value $From
Get-Content -Path .\CopyToFile.txt

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

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

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

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

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

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

Voorbeeld 7: Filters gebruiken met Add-Content

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

Parameters

-AsByteStream

Hiermee geeft u op dat de inhoud moet worden gelezen als een stroom van bytes. Deze parameter is geïntroduceerd in PowerShell 6.0.

Er treedt een waarschuwing op wanneer u de parameter AsByteStream gebruikt met de parameter encoding. De parameter AsByteStream negeert alle coderingen en de uitvoer wordt geretourneerd als een stroom bytes.

Parametereigenschappen

Parametersets

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Parametersets

-Credential

Parametereigenschappen

Parametersets

-Encoding

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

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

De acceptabele waarden voor deze parameter zijn als volgt:

• ascii: maakt gebruik van de codering voor de ASCII-tekenset (7-bits).
• ansi: gebruikt de codering voor de ANSI-codepagina van de huidige cultuur. Deze optie is toegevoegd in PowerShell 7.4.
• bigendianunicode: Codeert in UTF-16-indeling met behulp van de bytevolgorde big-endian.
• bigendianutf32: Codeert in UTF-32-indeling met behulp van de bytevolgorde big-endian.
• oem: maakt gebruik van de standaardcodering voor MS-DOS- en consoleprogramma's.
• unicode: Encodeert in UTF-16-indeling met de little-endian-bytevolgorde.
• utf7: Codeert in UTF-7-formaat.
• utf8: Codeert in de UTF-8-indeling.
• utf8BOM: Codeert in UTF-8-formaat met Byte Order Mark (BOM)
• utf8NoBOM: Codeert in UTF-8-indeling zonder Byte Order Mark (BOM)
• utf32: Codeert in UTF-32-indeling.

Vanaf PowerShell 6.2 staat de parameter Coderings- ook numerieke id's toe van geregistreerde codepagina's (zoals -Encoding 1251) of tekenreeksnamen van geregistreerde codepagina's (zoals -Encoding "windows-1251"). Zie de .NET-documentatie voor Encoding.CodePagevoor meer informatie.

Vanaf PowerShell 7.4 kunt u de Ansi waarde voor de -coderingsparameter gebruiken om de numerieke id voor de ANSI-codepagina van de huidige cultuur door te geven zonder deze handmatig op te geven.

Parametereigenschappen

Parametersets

-Exclude

Hiermee specificeert u, als een tekenreeks, één of meerdere items die door deze cmdlet worden uitgesloten van 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.

Parametereigenschappen

Parametersets

-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 kunt de syntaxis voor de FileSystem filtertaal vinden 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.

Parametereigenschappen

Parametersets

-Force

Overschrijft het kenmerk Alleen-lezen, zodat u inhoud aan een alleen-lezenbestand kunt toevoegen. Bijvoorbeeld, Force overschrijft het kenmerk Alleen-lezen, maar veranderen de bestandsmachtigingen niet.

Parametereigenschappen

Parametersets

-Include

Hiermee specificeert u, in de vorm van een tekenreeksarray, een item of items die deze cmdlet bij de bewerking betrekt. 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.

Parametereigenschappen

Parametersets

-LiteralPath

Specificeert 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 escape-tekens bevat, zet het dan tussen enkele aanhalingstekens. Enkele aanhalingstekens zorgen ervoor dat PowerShell geen tekens als escapesequenties interpreteert.

Zie about_Quoting_Rulesvoor meer informatie.

Parametereigenschappen

Parametersets

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

Parametereigenschappen

Parametersets

-PassThru

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

Parametereigenschappen

Parametersets

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

Parametereigenschappen

Parametersets

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

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. Vanaf PowerShell 7.2 kunnen Add-Content alternatieve gegevensstromen toepassen op zowel bestanden als mappen.

Parametereigenschappen

Parametersets

-Value

Hiermee wordt de inhoud gespecificeerd 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.

Parametereigenschappen

Parametersets

-WhatIf

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

Parametereigenschappen

Parametersets

CommonParameters

Invoerwaarden

Object

PSCredential

Uitvoerwaarden

None

String

Notities

Verwante koppelingen

• about_Aliases
• about_Aanbieders
• Clear-Content
• Get-Content
• Get-Item
• Nieuw-Item
• Set-Content