Add-Content

modul: Microsoft.PowerShell.Management

Tartalom hozzáadása a megadott elemekhez, például szavak hozzáadása egy fájlhoz.

szintaxis

Add-Content <string> <Object> >] >] 
Add-Content <Object> -LiteralPath <string> >] >] 

leírás

a Add-Content cmdlet egy adott elemhez vagy fájlhoz csatolja a tartalmat. Megadhatja a tartalomata tartalom beírásával a parancsba vagy a tartalmat tartalmazó objektum megadásával.

Ha fájlokat vagy könyvtárakat kell létrehoznia a következő példákhoz, lásd az Új elemet.

példák

1. példa: adjon hozzá egy karakterláncot az összes szöveges fájlhoz, kivéve

Ez a példa értéket ad az aktuális könyvtárban lévő szöveges fájlokhoz, de kizárja a fájlok alapjánfájlnevüket.

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

az elérési út paraméter megadja az összes .txt fájlt az aktuális könyvtárban, de az Excludeparameter figyelmen kívül hagyja a megadott mintának megfelelő fájlneveket. Az Értékparaméter megadja a szövegszöveg, amely a fájlokra van írva.

2. példa: Add a date to the end of the specified files

this example appends the date to files in the current directory and displays the date in thePowerShell 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 AM

a Add-Content a cmdlet két új fájlt hoz létre az aktuális könyvtárban. Az Értékparaméter tartalmazzaa Get-Date cmdlet kimenete. A PassThru paraméter a hozzáadott tartalmat a csővezetékhez adja ki.Mivel nincs más cmdlet a kimenet fogadásához, a PowerShell konzolon jelenik meg.AGet-Content cmdlet megjeleníti a frissített fájlt,DateTimeFile1.log.

3. példa: adja hozzá a megadott fájl tartalmát egy másik fájlhoz

Ez a példa egy fájlból kapja a tartalmat, és egy változóban tárolja a tartalmat. A változó a tartalmat egy másik fájlba illeszti.

$From = Get-Content -Path .\CopyFromFile.txtAdd-Content -Path .\CopyToFile.txt -Value $FromGet-Content -Path .\CopyToFile.txt
  • The Get-Content a CopyFromFile.txt tartalmát a$From változóban tárolja.
  • a Add-Contentcmdlet frissíti a CopyToFile.txtfájlt a $From változó tartalmával.
  • aGet-Content cmdlet megjeleníti CopyToFile.txt.

4. példa: adja hozzá egy adott fájl tartalmát egy másik fájlhoz a

csővezeték segítségével ez a példa egy fájlból kapja a tartalmat, majd a Add-Content cmdletbe továbbítja.

The Get-Content cmdlet gets the content of CopyFromFile.txt. Az eredményeket aAdd-Content cmdletre továbbítják, amely frissíti a CopyToFile.txt.Az utolsó Get-Content cmdlet CopyToFile.txt.

5. példa: új fájl létrehozása és tartalom másolása

Ez a példa új fájlt hoz létre, és egy meglévő fájl tartalmát másolja az új fájlba.

Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)Get-Content -Path .\NewFile.txt
  • The Add-Content a cmdlet az elérési út és érték paramétereit használja egy új fájl létrehozásához a jelenlegi könyvtárban.
  • a Get-Contentcmdlet megkapja egy meglévő fájl tartalmát, CopyFromFile.txt és átadja az Értékparaméternek. A Get-Content cmdlet körüli zárójelek biztosítják, hogy a parancs befejeződik, mielőtt a Add-Content parancs megkezdődik.
  • a Get-Content cmdlet megjeleníti az új fájl tartalmát, NewFile.txt.

6. példa: tartalom hozzáadása csak olvasható fájlhoz

Ez a parancs értéket ad a fájlhoz akkor is, ha az IsReadOnly fájl attribútum True értékre van állítva.A példa tartalmazza a csak olvasható fájl létrehozásának lépéseit.

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
  • a New-Item cmdlet az elérési utat és az ItemType paramétereket használja aIsReadOnlyTextFile.txt fájl létrehozásához az aktuális könyvtárban.
  • a Set-ItemProperty cmdlet a név és érték paramétereit használja a fájl ‘ sisreadonly tulajdonság True-ra történő módosításához.
  • a Get-ChildItemcmdlet azt mutatja, hogy a fájl üres (0), és csak olvasható attribútummal rendelkezik (r).
  • aAdd-Content cmdlet az elérési út paramétert használja a fájl megadásához. Az érték paramétertartalmaz egy szöveges karakterláncot a fájlhoz. A Force paraméter írja a szöveget csak oda fájlba.
  • aGet-Content cmdlet a Path paramétert használja a fájl tartalmának megjelenítéséhez.

a csak olvasható attribútum eltávolításához használja a Set-ItemProperty parancsot az érték paraméterkészlettel False.

7. példa: a

kiegészítő tartalommal rendelkező szűrők használata a Add-Content cmdlet szűrőt adhat meg. Ha szűrőket használ a Pathparameter minősítéséhez, akkor egy hátsó csillagot (*) kell tartalmaznia a thepath tartalmának jelzéséhez.

a következő parancs hozzáadja a “kész” szót az összes *.txt fájl tartalmához a C:\Tempkönyvtárban.

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

paraméterek

-AsByteStream

meghatározza, hogy a tartalmat bájtfolyamként kell olvasni. Ezt a paramétert bevezettükpowershell 6.0.

figyelmeztetés akkor fordul elő, ha az Asbytream paramétert a kódolási paraméterrel használja. 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
-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Álneve: cf
Beosztása: Nevű
Alapértelmezett érték: False
Elfogadni vezeték bemenet: False
Elfogadja a helyettesítő karaktereket: False
-Hitelesítő

Megjegyzés:

Ez a paraméter nem használható az egyes szolgáltatók által telepített a PowerShell.Hogy utánozza egy másik felhasználó, vagy emelik a hitelesítő adatait, amikor fut ez a parancsmag,használja Hivatkozhat-Parancs.

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

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. Thisparameter csak akkor működik, fájlrendszer meghajtók.

a paraméter elfogadható értékei a következők:

  • ascii: az ASCII (7 bites) karakterkészlet kódolását használja.
  • bigendianunicode: UTF-16 formátumban kódolja a big-endian byte sorrendet.
  • bigendianutf32: UTF-32 formátumban kódolja a big-endian byte sorrendet.
  • oem: az MS-DOS és konzolprogramok alapértelmezett kódolását használja.
  • unicode: Kódolja UTF-16 formátumban a little-endian byte sorrendben.
  • utf7: kódolja UTF-7 formátumban.
  • utf8: kódolja UTF-8 formátumban.
  • utf8BOM: kódolja UTF-8 formátumban Byte Order Mark (BOM)
  • utf8NoBOM: kódolja UTF-8 formátumban Byte Order Mark (BOM) nélkül
  • utf32: kódolás UTF-32 formátumban.

kezdve PowerShell 6.2, a kódolási paraméter lehetővé teszi a regisztrált kódlapok numerikus azonosítóit (például -Encoding 1251) vagy a regisztrált kódoldalak karakterláncneveit (például-Encoding "windows-1251"). További információért lásd a. net dokumentációjátkódolás.Kódfejtés.

Megjegyzés

UTF-7 * használata már nem ajánlott. A PowerShell 7.1-ben figyelmeztetést írunk, ha önadja meg autf7 kódolási paramétert.

Típus:
elfogadott értékek: ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Position: Named
Default value: UTF8NoBOM
Accept pipeline input: False
Accept wildcard characters: False
-Exclude

Specifies, as a string array, an item or items that this cmdlet excludes in the operation. The valueof this parameter qualifies the Path parameter. Adjon meg egy görbeelemet vagy mintát, például*.txt. Helyettesítő karakterek megengedettek. Az Exclude paraméter csak akkor érvényes, ha aa Command tartalmazza egy elem tartalmát, például a C:\Windows\*, ahol a helyettesítő karakterekmeghatározza a C:\Windows könyvtár tartalmát.

Típus: String
Beosztása: Nevű
Alapértelmezett érték: Nem
Elfogadni vezeték bemenet: False
Elfogadni helyettesítő karakterek: True
-Filter

megad egy szűrőt a Path paraméter minősítéséhez. A FileSystemprovider az egyetlen telepített PowerShell szolgáltató, amely támogatja a szűrők használatát. A fájlrendszer szűrőnyelvének szintaxisát kb.A szűrők hatékonyabbak, mint más paraméterek, mivel a szolgáltató akkor alkalmazza őket, amikor a cmdlet az objektumokat ahelyett, hogy a PowerShell szűrné az objektumokat a beolvasás után.

Típus: String
pozíció: Nevű
Alapértelmezett érték: Nem
Elfogadni vezeték bemenet: False
Elfogadja a helyettesítő karakterek használatát: True
-Erő

Felülírja a csak olvasható tulajdonság, amely lehetővé teszi, hogy tartalom hozzáadása egy csak olvasható fájl. Például a Force felülbírálja a csak olvasható attribútumot, vagy könyvtárakat hoz létre a fájl elérési útjának kitöltéséhez, denem próbálja meg megváltoztatni a fájl engedélyeit.

Típus: SwitchParameter
pozíció: Nevű
Alapértelmezett érték: Nem
Elfogadni vezeték bemenet: False
Elfogadja a helyettesítő karakterek használatát: False
-Include

Megadja, mint egy string tömb, egy elemet vagy elemeket, hogy ez a parancsmag tartalmazza a művelet. Ennek a paraméternek az értéke megfelel az útvonal paraméternek. Adjon meg egy görbeelemet vagy mintát, például"*.txt". Helyettesítő karakterek megengedettek. Az Include paraméter csak akkor érvényes, ha aa Command tartalmazza egy elem tartalmát, például a C:\Windows\*, ahol a helyettesítő karakterekmeghatározza a C:\Windows könyvtár tartalmát.

Típus: String
Beosztása: Nevű
Alapértelmezett érték: Nem
Elfogadni vezeték bemenet: False
Elfogadni helyettesítő karakterek: True
-LiteralPath

egy vagy több hely elérési útját határozza meg. A LiteralPath értékét pontosan úgy használják, ahogy vanírta. A karakterek nem értelmezhetők helyettesítő karakterként. Ha az útvonal menekülési karaktereket tartalmaz, csatolja be egyetlen idézőjelbe. Egyetlen idézőjelek mondani PowerShell nem értelmezi semmilyen karaktersas menekülési szekvenciák.

további információért lásd: about_Quoting_Rules.

Típus: String
álnevek: PSPath, LP
Beosztása: Nevű
Alapértelmezett érték: Nem
Elfogadni vezeték bemenet: True
Elfogadja a helyettesítő karaktereket: False
-NoNewline

azt Jelzi, hogy ez a parancsmag nem tesz hozzá egy új sort, vagy carriage return, hogy a tartalmat.

a bemeneti objektumok karakterlánc-ábrázolásai össze vannak kötve a kimenet kialakításához. A kimeneti karakterláncok között nincs szóköz vagywlines. Az utolsó kimeneti karakterlánc után nem kerül hozzáadásra újsor.

Típus: SwitchParameter
Beosztása: Nevű
Alapértelmezett érték: Nem
Elfogadni vezeték bemenet: False
Elfogadja a helyettesítő karaktereket: False
-Jövedelmek

Visszatér egy objektum, ami a hozzáadott tartalom. Alapértelmezés szerint ez a cmdlet nem generál semmitput.

Típus: SwitchParameter
Beosztása: Nevű
Alapértelmezett érték: Nem
Elfogadni vezeték bemenet: False
Elfogadja a helyettesítő karaktereket: False
-Path

Megadja, hogy az utat az elemeket, hogy megkapja a kiegészítő tartalom.Helyettesítő karakterek megengedettek.Az útvonalaknak az elemekhez vezető útvonalaknak kell lennie, nem pedig a konténerekhez.Például meg kell adnia egy vagy több fájl elérési útját, nem pedig egy könyvtár elérési útját.Ha több görbét ad meg, vesszővel válassza el a görbéket.

Típus: String
Beosztása: 0
Alapértelmezett érték: Nem
Elfogadni vezeték bemenet: True
Elfogadja a helyettesítő karaktereket: True
-Patak

Megjegyzés:

Ez a Paraméter csak akkor áll rendelkezésre, a Windows.

egy alternatív adatfolyamot ad meg a tartalomhoz. Ha a patak nem létezik, ez a cmdlet létrehozzaezt. A helyettesítő karakterek nem támogatottak.

Stream egy dinamikus paraméter, amelyet a fájlrendszer-szolgáltató hozzáad a Add-Content – hoz. Thisparameter csak akkor működik, fájlrendszer meghajtók.

a Add-Content cmdlet segítségével módosíthatja bármely váltakozó adatfolyam tartalmát, például a Zone.Identifier. Ezt azonban nem javasoljukaz internetről letöltött fájlok blokkolására szolgáló biztonsági ellenőrzések kiküszöbölésének módja. Ha ellenőrzi, hogy a letöltött fájl biztonságos-e, használja aUnblock-File parancsmagot.

This parameter was introduced in PowerShell 3.0.

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

Specifies the content to be added. Írjon be egy idézett karakterláncot, például ezek az adatok csak belső használatra szolgálnak, vagy adjon meg egy tartalmat tartalmazó objektumot, például a Get-Dateáltal generált DateTime objektumot.

nem adhatja meg a fájl tartalmát az elérési út beírásával, mert az elérési út csak egy karakterlánc.AGet-Content parancs segítségével megkaphatja a tartalmat, majd átadhatja azt az Értékparaméternek.

Típus: objektum
pozíció: 1
alapértelmezett érték: None
: True
Accept wildcard characters: False
-WhatIf

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

bemenetek

rendszer.Tárgy, Rendszer.Menedzsment.Automatizálás.PSCredential

akkor cső értékek, utak, vagy hitelesítő adatok Set-Content.

kimenetek

nincs vagy rendszer.String

amikor a PassThru paramétert használja, Add-Content létrehoz egy rendszert.String objektum, amelya tartalmat képviseli. Ellenkező esetben ez a parancsmag nem generál kimenetet.

Megjegyzések

  • ha egy objektumotAdd-Content – ra pipál, az objektum karakterláncgá alakul, mielőtt hozzáadjákaz elem. Az objektum típusa határozza meg a karakterlánc formátumát, de a formátum eltérhet az objektum alapértelmezett megjelenítésétől. A karakterlánc formátumának vezérléséhez használja a következő formázási paramétereketa hajlító cmdlet.
  • hivatkozhat aAdd-Content beépített álnéven is,ac. További információ: seeabout_Aliases.
  • a Add-Content cmdlet célja, hogy működjön együtt az adatok által kitett bármely szolgáltató. A munkamenetben elérhető biztosítók listázásához írja be a Get-PSProviderparancsot. További információ: seeabout_Providers.
  • about_Aliases
  • about_Providers
  • Clear-Content
  • Get-Content

  • Get-Item
  • New-Item
  • Set-Content

Related Posts

Vélemény, hozzászólás?

Az e-mail-címet nem tesszük közzé. A kötelező mezőket * karakterrel jelöltük