voegt inhoud toe aan de opgegeven items, zoals het toevoegen van woorden aan een bestand.
- syntaxis
- beschrijving
- voorbeelden
- Voorbeeld 1: voeg een tekenreeks toe aan alle tekstbestanden met een uitzondering
- Voorbeeld 2: Voeg een datum toe aan het einde van de opgegeven bestanden
- Voorbeeld 3: Voeg de inhoud van een opgegeven bestand toe aan een ander bestand
- Voorbeeld 4: Voeg de inhoud van een opgegeven bestand toe aan een ander bestand met behulp van de pijplijn
- Voorbeeld 5: Maak een nieuw bestand aan en kopieer inhoud
- Voorbeeld 6: inhoud toevoegen aan een alleen-lezen bestand
- Voorbeeld 7: Gebruik Filters met Add-Content
- Parameters
- Inputs
- uitgangen
- Notes
syntaxis
Add-Content <string> <Object> >] >] Add-Content <Object> -LiteralPath <string> >] >] beschrijving
de Add-Content cmdlet voegt inhoud toe aan een bepaald 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 aanmaken voor de volgende voorbeelden, zie nieuw-Item.
voorbeelden
Voorbeeld 1: voeg een tekenreeks toe aan alle tekstbestanden met een uitzondering
dit voorbeeld voegt een waarde toe aan tekstbestanden in de huidige map, maar sluit bestanden uit op basis van hun bestandsnaam.
Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'De parameter pad specificeert alle .txt bestanden in de huidige map, maar de Excludeparameter negeert bestandsnamen die overeenkomen met het opgegeven patroon. De waarde parameter specificeert de tekst string die naar de bestanden wordt geschreven.
Voorbeeld 2: Voeg een datum toe aan het einde van de opgegeven bestanden
dit voorbeeld voegt de datum toe aan bestanden in de huidige map en toont de datum in de PowerShell console.
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 AMDe Add-Content cmdlet maakt twee nieuwe bestanden aan in de huidige map. De Waardeparameter bevat de uitvoer van deGet-Date cmdlet. 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 cmdletGet-Content toont het bijgewerkte bestand, DateTimeFile1.log.
Voorbeeld 3: Voeg de inhoud van een opgegeven bestand toe aan een ander bestand
dit voorbeeld haalt de inhoud uit een bestand en slaat de inhoud op in een variabele. De variabele wordt gebruikt om de inhoud toe te voegen aan een ander bestand.
$From = Get-Content -Path .\CopyFromFile.txtAdd-Content -Path .\CopyToFile.txt -Value $FromGet-Content -Path .\CopyToFile.txt- De
Get-Contentcmdlet krijgt de inhoud vanCopyFromFile.txten slaat de inhoud op in de$Fromvariabele. - de
Add-Contentcmdlet werkt deCopyToFile.txtbestand bij met behulp van de inhoud van de$Fromvariabele. - de
Get-Contentcmdlet geeft Copytobestand weer.txt.
Voorbeeld 4: Voeg de inhoud van een opgegeven bestand toe aan een ander bestand met behulp van de pijplijn
Dit voorbeeld krijgt de inhoud van een bestand en pipes het naar deAdd-Content cmdlet.
Get-Content -Path .\CopyFromFile.txt | Add-Content -Path .\CopyToFile.txtGet-Content -Path .\CopyToFile.txtde Get-Content cmdlet krijgt de inhoud van CopyFromFile.txt. De resultaten worden doorgeleid naar deAdd-Content cmdlet, die deCopyToFile.txtbijwerkt.De laatste Get-Content cmdlet displays CopyToFile.txt.
Voorbeeld 5: Maak een nieuw bestand aan en kopieer inhoud
dit voorbeeld maakt een nieuw bestand aan en kopieert de inhoud van een bestaand bestand naar het nieuwe bestand.
Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)Get-Content -Path .\NewFile.txt- De
Add-Contentcmdlet gebruikt de parameters pad en waarde om een nieuw bestand in de huidige map aan te maken. - de
Get-Contentcmdlet krijgt de inhoud van een bestaand bestand,CopyFromFile.txten geeft het door aan de Waardeparameter. De haakjes rond hetGet-Contentcmdlet zorgen ervoor dat het commando eindigt voordat hetAdd-ContentCommando begint. - de
Get-Contentcmdlet toont de inhoud van het nieuwe bestand,NewFile.txt.
Voorbeeld 6: inhoud toevoegen aan een alleen-lezen bestand
Dit commando voegt een waarde toe aan het bestand, zelfs als het IsReadOnly file attribuut is ingesteld op True.De stappen om een alleen-lezen bestand te maken zijn opgenomen in het voorbeeld.
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- De
New-Itemcmdlet gebruikt de parameters Path en ItemType om het bestandIsReadOnlyTextFile.txtin de huidige map aan te maken. - de
Set-ItemPropertycmdlet gebruikt de naam-en Waardeparameters om de eigenschap ‘isreadonly’ van het bestand te veranderen in ‘True’. - de
Get-ChildItemcmdlet toont dat het bestand leeg is (0) en heeft het alleen-lezen attribuut (r). - de
Add-Contentcmdlet gebruikt de parameter pad om het bestand te specificeren. De waarde parameterbevat de tekstreeks die aan het bestand wordt toegevoegd. De Force parameter schrijft de tekst naar het alleen-lezen bestand. - de
Get-Contentcmdlet gebruikt de parameter Path om de inhoud van het bestand weer te geven.
om het alleen-lezen attribuut te verwijderen, gebruik je het Set-ItemProperty commando met de waarde parameterset op False.
Voorbeeld 7: Gebruik Filters met Add-Content
u kunt een filter opgeven aan deAdd-Content cmdlet. Als u filters gebruikt om de Pathparameter te kwalificeren, moet u een achterliggende sterretje (*) toevoegen om de inhoud van het pad aan te geven.
het volgende commando voegt het woord “Done”toe aan de inhoud van alle *.txt bestanden in de C:\Tempmap.
Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"Parameters
geeft aan dat de inhoud moet worden gelezen als een stroom van bytes. Deze parameter werd geïntroduceerd in PowerShell 6.0.
een waarschuwing treedt op wanneer u de asbytestream parameter gebruikt met de codering parameter. 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 |
Prompts you for confirmation before running the cmdlet.
| Type: | SwitchParameter |
| Aliassen: | cf |
| Plaats: | Naam |
| Standaard waarde: | False |
| Accepteren pijplijn invoer: | False |
| Accepteren wildcard tekens: | False |
Opmerking
met Deze parameter wordt niet ondersteund door alle providers geïnstalleerd met PowerShell.Om de identiteit van een andere gebruiker, of verheffen uw referenties bij het uitvoeren van dit commando,gebruik Beroepen-Opdracht.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
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. Ditparameter werkt alleen in het bestandssysteem schijven.
de aanvaardbare waarden voor deze parameter zijn als volgt:
-
ascii: gebruikt de codering voor de ASCII (7-bit) tekenset. -
bigendianunicode: codeert in UTF-16 formaat met behulp van de big-endian bytevolgorde. -
bigendianutf32: codeert in UTF-32 formaat met behulp van de big-endian bytevolgorde. -
oem: gebruikt de standaardcodering voor MS-DOS en console programma ‘ s. -
unicode: Codeert in UTF-16 formaat met behulp van de little-endian byte volgorde. -
utf7: codeert in UTF-7-formaat. -
utf8: codeert in UTF-8-formaat. -
utf8BOM: codeert in UTF-8 formaat met Byte Order Mark (BOM) -
utf8NoBOM: codeert in UTF-8 formaat zonder Byte Order Mark (BOM) -
utf32: codeert in UTF-32 formaat.
beginnend met PowerShell 6.2, de coderingsparameter staat ook numerieke ID ’s toe van geregistreerde codepagina’ s (zoals -Encoding 1251) of stringnamen van geregistreerde codepagina ‘ s (zoals-Encoding "windows-1251"). Zie de.net-documentatie voor codering voor meer informatie.codetabel.
Note
UTF-7 * wordt niet langer aanbevolen. In PowerShell 7.1 wordt een waarschuwing geschreven als u utf7 specificeert voor de Coderingsparameter.
| Type: | codering |
| geaccepteerde waarden: | ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
| Position: | Named |
| Default value: | UTF8NoBOM |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies, as a string array, an item or items that this cmdlet excludes in the operation. The valueof this parameter qualifies the Path parameter. Voer een pad-element of patroon in, zoals*.txt. Jokertekens zijn toegestaan. De parameter Exclude is alleen effectief als het commando de inhoud van een item bevat, zoals C:\Windows\*, waar het jokerteken de inhoud van de C:\Windows map specificeert.
| Type: | String | positie: | Named | standaardwaarde: | geen | Accept pipeline input: | False |
| jokertekens accepteren: | True |
specificeert een filter om de parameter pad te kwalificeren. De FileSystemprovider is de enige geà Nstalleerde PowerShell provider die het gebruik van filters ondersteunt. U kunt de syntaxis voor de filtertaal van het bestandssysteem vinden in about_Wildcards.Filters zijn efficiënter dan andere parameters, omdat de provider ze toepast wanneer de cmdletgets de objecten in plaats van PowerShell de objecten te filteren nadat ze zijn opgehaald.
| Type: | String | positie: | Named | standaardwaarde: | geen |
| pipeline-invoer accepteren: | False | accept jokertekens: | True |
overschrijft het alleen-lezen attribuut, zodat u inhoud kunt toevoegen aan een alleen-lezen bestand. Forceer bijvoorbeeld het alleen-lezen attribuut of maak mappen om een bestandspad te voltooien, maar het zal niet proberen om bestandsmachtigingen te wijzigen.
| Type: | SwitchParameter | positie: | Named | standaardwaarde: | geen | pipeline-invoer accepteren: | False |
| jokertekens accepteren: | False |
specificeert, als een string-array, een item of items die deze cmdlet in de bewerking opneemt. De waarde van deze parameter kwalificeert de parameter Path. Voer een pad-element of patroon in, zoals"*.txt". Jokertekens zijn toegestaan. De parameter Include is alleen effectief als het commando de inhoud van een item bevat, zoals C:\Windows\*, waar het jokerteken de inhoud van de C:\Windows map specificeert.
| Type: | String | positie: | Named | standaardwaarde: | geen | Accept pipeline input: | False |
| jokertekens accepteren: | True |
specificeert een pad naar een of meer locaties. De waarde van LiteralPath wordt precies gebruikt zoals het is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escape-tekens bevat, omsluit het in enkele aanhalingstekens. Enkele aanhalingstekens vertellen PowerShell geen tekens te interpreteren als escape sequences.
voor meer informatie, zie about_Quoting_Rules.
| Type: | String |
| aliassen: | PSPath, LP |
| positie: | Named | standaardwaarde: | geen |
| pipeline-invoer accepteren: | True | jokertekens accepteren: | False |
geeft aan dat deze cmdlet geen nieuwe regel of carriage return aan de inhoud toevoegt.
de tekenreeksen van de invoerobjecten worden samengevoegd om de uitvoer te vormen. Er worden geen spaties of nieuwe regels ingevoegd tussen de uitvoerstrings. Er wordt geen nieuwe regel toegevoegd na de laatste uitvoerstring.
| Type: | SwitchParameter |
| Plaats: | Naam |
| Standaard waarde: | Geen |
| Accepteren pijplijn invoer: | False |
| Accepteren wildcard tekens: | False |
Geeft als resultaat een object waarmee de toegevoegde inhoud. Standaard genereert deze cmdlet geen uitvoer.
| Type: | SwitchParameter | positie: | Named | standaardwaarde: | geen |
| pipeline input: | False | Accept jokertekens: | False |
geeft het pad aan naar de items die de aanvullende inhoud ontvangen.Jokertekens zijn toegestaan.De paden moeten paden zijn naar items, 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 |
| Plaats: | 0 |
| Standaard waarde: | Geen |
| Accepteren pijplijn invoer: | True |
| Accepteren wildcard tekens: | True |
Opmerking
Deze Parameter is alleen beschikbaar op Windows.
specificeert een alternatieve datastroom voor inhoud. Als de stream niet bestaat, maakt deze cmdlet het aan. Jokertekens worden niet ondersteund.
Stream is een dynamische parameter die de provider van het bestandssysteem toevoegt aan Add-Content. Ditparameter werkt alleen in het bestandssysteem schijven.
u kunt de cmdlet Add-Content gebruiken om de inhoud van een andere gegevensstroom te wijzigen, zoals Zone.Identifier. Echter, we raden deze asa manier om veiligheidscontroles die bestanden die worden gedownload van het Internet te blokkeren elimineren. Als u controleert of een gedownload bestand veilig is, gebruik dan deUnblock-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 |
Specifies the content to be added. Typ een geciteerde tekenreeks, zoals deze gegevens alleen voor intern gebruik zijn, of geef een object op dat inhoud bevat, zoals het DateTime-object dat Get-Dategenereert.
u kunt de inhoud van een bestand niet specificeren door het pad te typen, omdat het pad slechts een tekenreeks is.U kunt een Get-Content commando gebruiken om de inhoud te krijgen en door te geven aan de waarde parameter.
| Type: | Object | positie: | 1 | standaardwaarde: | geen | accepteer pijplijn-invoer: | True |
| Accept wildcard characters: | False |
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: | False |
Inputs
systeem.Object, Systeem.Management.Automatisering.PSCredential
u kunt waarden, paden of referenties doorsluizen naar Set-Content.
uitgangen
geen of systeem.Tekenreeks
wanneer u de parameter Pasthru gebruikt, genereert Add-Content een systeem.String object dat de inhoud vertegenwoordigt. Anders genereert deze cmdlet geen uitvoer.
Notes
- wanneer u een object doorsluipt naar
Add-Content, wordt het object geconverteerd naar een tekenreeks voordat het aan het item wordt toegevoegd. Het objecttype bepaalt het formaat van de tekenreeks, maar het formaat kan anders zijn dan de standaardweergave van het object. Gebruik de opmaakparameters van de verzendende cmdlet om het stringformaat te bepalen. - u kunt ook naar
Add-Contentverwijzen door de ingebouwde alias,ac. Zie voor meer informatie over_aliases. - de
Add-Contentcmdlet is ontworpen om te werken met de gegevens die door elke aanbieder worden blootgesteld. TypGet-PSProviderom de beschikbare aanbieders in uw sessie weer te geven. Voor meer informatie, zie over_providers.
- about_Aliases
- about_Providers
- Clear-Content
- Get-Content
- Get-Item
- New-Item
- Set-Content