Set-Content

Syntaxis

Path (Default) - FileSystem provider

Set-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 - FileSystem provider

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

Path (Default) - All providers

Set-Content
    [-Path] <string[]>
    [-Value] <Object[]>
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

LiteralPath - All providers

Set-Content
    [-Value] <Object[]>
    -LiteralPath <string[]>
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Voorbeelden

Voorbeeld 1: De inhoud van meerdere bestanden in een map vervangen

Get-ChildItem -Path .\Test*.txt

Test1.txt
Test2.txt
Test3.txt

Set-Content -Path .\Test*.txt -Value 'Hello, World'
Get-Content -Path .\Test*.txt

Hello, World
Hello, World
Hello, World

Voorbeeld 2: Een nieuw bestand maken en inhoud schrijven

Set-Content -Path .\DateTime.txt -Value (Get-Date)
Get-Content -Path .\DateTime.txt

1/30/2019 09:55:08

Voorbeeld 3: Tekst in een bestand vervangen

Get-Content -Path .\Notice.txt

Warning
Replace Warning with a new word.
The word Warning was replaced.

(Get-Content -Path .\Notice.txt) |
    ForEach-Object {$_ -replace 'Warning', 'Caution'} |
        Set-Content -Path .\Notice.txt
Get-Content -Path .\Notice.txt

Caution
Replace Caution with a new word.
The word Caution was replaced.

Voorbeeld 4: Filters gebruiken met Set-Content

Set-Content -Path C:\Temp\* -Filter *.txt -Value "Empty"

Parameters

-AsByteStream

Dit is een dynamische parameter die beschikbaar wordt gesteld door de FileSystem provider. Zie about_FileSystem_Providervoor meer informatie.

Hiermee geeft u op dat de inhoud moet worden geschreven 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 geschreven als een stroom bytes.

Parametereigenschappen

Parametersets

-Confirm

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

Parametereigenschappen

Parametersets

-Credential

Parametereigenschappen

Parametersets

-Encoding

Dit is een dynamische parameter die beschikbaar wordt gesteld door de FileSystem provider. Zie about_FileSystem_Providervoor meer informatie.

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

Encoding is een dynamische parameter die de Bestandssysteemprovider toevoegt aan Set-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

Dwingt de cmdlet om de inhoud van een bestand in te stellen, zelfs als het bestand het kenmerk Alleen-lezen heeft. Implementatie varieert van provider tot provider. Zie about_Providersvoor meer informatie. De parameter Forceren overschrijft geen beveiligingsbeperkingen.

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

Dit is een dynamische parameter die beschikbaar wordt gesteld door de FileSystem provider. Zie about_FileSystem_Providervoor meer informatie.

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 inhoud vertegenwoordigt. Deze cmdlet genereert standaard geen uitvoer.

Parametereigenschappen

Parametersets

-Path

Hiermee geeft u het pad op van het item dat de inhoud ontvangt. Jokertekens zijn toegestaan.

Parametereigenschappen

Parametersets

-Stream

Dit is een dynamische parameter die beschikbaar wordt gesteld door de FileSystem provider. Deze parameter is alleen beschikbaar in Windows. Zie about_FileSystem_Providervoor meer informatie.

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 FileSystem-provider toevoegt aan Set-Content. Deze parameter werkt alleen in bestandsysteemschijven.

U kunt de cmdlet Set-Content gebruiken om de inhoud van een alternatieve gegevensstroom te maken of bij te werken, 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 kan Set-Content de inhoud van alternatieve gegevensstromen uit mappen en bestanden instellen.

Parametereigenschappen

Parametersets

-Value

Hiermee geeft u de nieuwe inhoud voor het item.

Parametereigenschappen

Parametersets

-WhatIf

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

Parametereigenschappen

Parametersets

CommonParameters

Invoerwaarden

Object

Uitvoerwaarden

None

String

Notities

Verwante koppelingen

• about_Aliases
• about_Automatic_Variables.md
• about_Aanbieders
• Inhoud toevoegen
• Clear-Content
• Get-ChildItem
• Get-Content
• ForEach-Object
• Nieuw-Item