Add-Content
Tartalmat ad hozzá a megadott elemekhez, például szavakat ad hozzá egy fájlhoz.
Syntax
Path (Alapértelmezett)
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
A Add-Content parancsmag egy adott elemhez vagy fájlhoz fűzi a tartalmat. A tartalom továbbítható a folyamatból, vagy a Érték paraméterrel adható meg.
Ha a következő példákhoz fájlokat vagy könyvtárakat kell létrehoznia, tekintse meg New-Item.
Példák
1. példa: Sztring hozzáadása az összes szövegfájlhoz kivétellel
Ez a példa hozzáfűz egy értéket az aktuális könyvtár szövegfájljaihoz, de a fájlnév alapján kizárja a fájlokat.
Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'
A Elérési út paraméter az aktuális könyvtárban lévő összes .txt fájlt megadja, de a Kizárás paraméter figyelmen kívül hagyja a megadott mintának megfelelő fájlneveket. A érték paraméter határozza meg a fájlokba írt karakterláncot.
A fájlok tartalmának megjelenítéséhez használja a Get-Content parancsot.
2. példa: Dátum hozzáadása a megadott fájlok végéhez
Ez a példa hozzáfűzi a dátumot az aktuális könyvtár fájljaihoz, és megjeleníti a dátumot a PowerShell-konzolon.
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
A Add-Content parancsmag két új fájlt hoz létre az aktuális könyvtárban. Az Value paraméter tartalmazza a Get-Date parancsmag kimenetét. A PassThru paraméter a hozzáadott tartalmat adja ki a csővezetékre. Mivel nincs más parancsmag a kimenet fogadásához, az megjelenik a PowerShell-konzolon. A Get-Content parancsmag megjeleníti a frissített fájlt, DateTimeFile1.log.
3. példa: Adott fájl tartalmának hozzáadása egy másik fájlhoz
Ez a példa lekéri a tartalmat egy fájlból, és egy változóban tárolja a tartalmat. A változó a tartalom egy másik fájlba való hozzáfűzésére szolgál.
$From = Get-Content -Path .\CopyFromFile.txt
Add-Content -Path .\CopyToFile.txt -Value $From
Get-Content -Path .\CopyToFile.txt
- A
Get-Contentparancsmag lekéri aCopyFromFile.txttartalmát, és a tartalmat a$Fromváltozóban tárolja. - A
Add-Contentparancsmag frissíti aCopyToFile.txtfájlt a$Fromváltozó tartalmával. - A
Get-Contentparancsmag CopyToFile.txtjelenít meg.
4. példa: Adott fájl tartalmának hozzáadása egy másik fájlhoz a folyamat használatával
Ez a példa lekéri a tartalmat egy fájlból, és a Add-Content parancsmagba csövezi.
Get-Content -Path .\CopyFromFile.txt | Add-Content -Path .\CopyToFile.txt
Get-Content -Path .\CopyToFile.txt
A Get-Content parancsmag lekéri a CopyFromFile.txttartalmát. Az eredmények az Add-Content parancsmagra kerülnek átirányításra, amely frissíti a CopyToFile.txt.
Az utolsó Get-Content parancsmag megjeleníti CopyToFile.txt.
5. példa: Új fájl létrehozása és tartalom másolása
Ez a példa létrehoz egy új fájlt, és átmásolja egy meglévő fájl tartalmát az új fájlba.
Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)
Get-Content -Path .\NewFile.txt
- A
Add-Contentparancsmag a Elérési út és Érték paraméterekkel hoz létre új fájlt az aktuális könyvtárban. - A
Get-Contentparancsmag lekéri egy meglévő fájl tartalmát,CopyFromFile.txtés továbbítja azt a Érték paraméternek. AGet-Contentparancsmag zárójelei biztosítják, hogy a parancs aAdd-Contentparancs megkezdése előtt befejeződjön. - A
Get-Contentparancsmag megjeleníti az új fájl tartalmát,NewFile.txt.
6. példa: Tartalom hozzáadása írásvédett fájlhoz
Ez a parancs akkor is hozzáad egy értéket a fájlhoz, ha a IsReadOnly fájlattribútum értéke True. Az írásvédett fájl létrehozásának lépései a példában szerepelnek.
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
- A
New-Itemparancsmag a Path és ItemType paraméterekkel hozza létre a fájlIsReadOnlyTextFile.txtaz aktuális könyvtárban. - A
Set-ItemPropertyparancsmag a Név és Érték paraméterekkel módosítja a fájl IsReadOnly tulajdonságát Igazra. - A
Get-ChildItemparancsmag azt mutatja, hogy a fájl üres (0), és írásvédett attribútummal (r) rendelkezik. - A
Add-Contentparancsmag a Path paramétert használja a fájl megadásához. Az Érték paraméter tartalmazza a fájlhoz fűzendő szövegsztringet. A Force paraméter a szöveget írásvédett fájlba írja. - A
Get-Contentparancsmag a Path paramétert használja a fájl tartalmának megjelenítéséhez.
Az írásvédett attribútum eltávolításához használja a Set-ItemProperty parancsot a érték paraméter Falsebeállításával.
7. példa: Szűrők használata Add-Content
Megadhat egy szűrőt a Add-Content parancsmaghoz. Ha szűrőkkel minősíti a Elérési út paramétert, egy záró csillagot (*) kell tartalmaznia az elérési út tartalmának jelzéséhez.
A következő parancs hozzáadja a "Kész" szót az *.txt könyvtárban lévő összes C:\Temp fájl tartalmához.
Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"
Paraméterek
-AsByteStream
Megadja, hogy a tartalmat bájtok adatfolyamaként kell olvasni. Ezt a paramétert a PowerShell 6.0-ban vezettük be.
Figyelmeztetés akkor fordul elő, ha a AsByteStream paramétert használja a Kódolás paraméterrel. Az AsByteStream paraméter figyelmen kívül hagyja a kódolást, és a kimenet bájtok adatfolyamaként lesz visszaadva.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Credential
Megjegyzés:
Ezt a paramétert a PowerShell-lel telepített szolgáltatók nem támogatják. Ha egy másik felhasználó szerepében szeretne fellépni, vagy emelni szeretné hitelesítő adatait a parancsmag futtatásakor, használja a Invoke-Command.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Encoding
Megadja a célfájl kódolási típusát. Az alapértelmezett érték a utf8NoBOM.
A kódolás egy dinamikus paraméter, amelyet a FileSystem-szolgáltató hozzáad a Add-Content parancsmaghoz. Ez a paraméter csak fájlrendszer-meghajtókon működik.
A paraméter elfogadható értékei a következők:
-
ascii: Az ASCII (7 bites) karakterkészlet kódolását használja. -
bigendianunicode: Az UTF-16 formátumú kódolást a big-endian bájtsorrend alkalmazásával végzi. -
bigendianutf32: UTF-32 formátumban kódol nagyvégű bájtsorrend használatával. -
oem: Az alapértelmezett kódolást használja MS-DOS és konzolprogramokhoz. -
unicode: Az UTF-16 formátumban kódol kis végű bájtsorrend használatával. -
utf7: UTF-7 formátumban kódol. -
utf8: UTF-8 formátumban kódol. -
utf8BOM: UTF-8 formátumban kódolódik bájt sorrendi jel (BOM) használatával -
utf8NoBOM: UTF-8 formátumban kódol byte order mark (BOM) nélkül -
utf32: UTF-32 formátumban kódol.
A PowerShell 6.2-től kezdődően a Kódolás paraméter lehetővé teszi a regisztrált kódlapok (például -Encoding 1251) numerikus azonosítóit vagy a regisztrált kódlapok sztringneveit (például -Encoding "windows-1251"). További információt a Encoding.CodePage.NET-dokumentációjában talál.
Megjegyzés:
UTF-7* már nem ajánlott. PowerShell 7.1-től kezdve figyelmeztetés jelenik meg, ha utf7-et ad meg a kódolás paraméterhez.
Paramétertulajdonságok
| Típus: | Encoding |
| Alapértelmezett érték: | UTF8NoBOM |
| Elfogadott értékek: | ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Exclude
Sztringtömbként olyan elemet vagy elemeket határoz meg, amelyeket ez a parancsmag kizár a műveletből. Ennek a paraméternek az értéke a Elérési út paramétert minősíti. Adjon meg egy elérési út elemet vagy mintát, például *.txt. A helyettesítő karakterek használata engedélyezett. A Kizárás paraméter csak akkor érvényes, ha a parancs egy elem tartalmát tartalmazza, például C:\Windows\*, ahol a helyettesítő karakter a C:\Windows könyvtár tartalmát adja meg.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Filter
Szűrőt ad meg a útvonal paraméter minősítéséhez. A Fájlrendszer szolgáltató az egyetlen telepített PowerShell-szolgáltató, amely támogatja a szűrők használatát. A FileSystem szűrőnyelvének szintaxisát az about_Wildcards-ban találhatja meg. A szűrők hatékonyabbak, mint a többi paraméter, mivel a szolgáltató akkor alkalmazza őket, amikor a parancsmag lekéri az objektumokat, és nem azt, hogy a PowerShell szűrje az objektumokat a lekérés után.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Force
Felülbírálja az írásvédett attribútumot, így tartalmat adhat hozzá egy írásvédett fájlhoz. Például Kényszer felülírja az írásvédett attribútumot, de nem módosítja a fájlengedélyeket.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Include
Sztringtömbként egy elemet vagy elemet határoz meg, amelyet ez a parancsmag tartalmaz a műveletben. Ennek a paraméternek az értéke a Elérési út paramétert minősíti. Adjon meg egy elérési út elemet vagy mintát, például "*.txt". A helyettesítő karakterek használata engedélyezett. Az Include paraméter csak akkor érvényes, ha a parancs egy elem tartalmát tartalmazza, például C:\Windows\*, ahol a helyettesítő karakter a C:\Windows könyvtár tartalmát adja meg.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-LiteralPath
Egy vagy több hely elérési útját adja meg. A LiteralPath értékét pontosan a beírt módon használja a rendszer. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési útvonal escape karaktereket tartalmaz, tedd azt egyes idézőjelek közé. Az egyes idézőjelek azt mondják a PowerShellnek, hogy egyetlen karaktert se értelmezzen escape szekvenciaként.
További információk az about_Quoting_Rules oldalon találhatók: .
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | PSPath, LP |
Paraméterkészletek
LiteralPath
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-NoNewline
Ez a parancsmag azt jelzi, hogy nem ad hozzá új sort vagy kocsivisszatérítést a tartalomhoz.
A bemeneti objektumok sztringreprezentációi összefűzve jelennek meg a kimenet létrehozásához. A kimeneti sztringek között nincsenek szóközök vagy új sorok. Az utolsó kimeneti sztring után nincs új vonal hozzáadva.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-PassThru
A hozzáadott tartalmat képviselő objektumot ad vissza. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Path
Megadja a további tartalmat fogadó elemek elérési útját. A helyettesítő karakterek használata engedélyezett. Az elérési utaknak nem tárolókhoz, hanem elemekhez vezető elérési utaknak kell lenniük. 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 elérési utat ad meg, vesszővel válassza el egymástól az útvonalakat.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
Path
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Stream
Megjegyzés:
Ez a paraméter csak Windows rendszeren érhető el.
Alternatív adatfolyamot ad meg a tartalomhoz. Ha a stream nem létezik, ez a parancsmag hozza létre. A helyettesítő karakterek nem támogatottak.
Stream egy dinamikus paraméter, amelyet a Fájlrendszer-szolgáltató a Add-Content-höz ad hozzá. Ez a paraméter csak fájlrendszer-meghajtókon működik.
A Add-Content parancsmaggal módosíthatja bármely alternatív adatfolyam tartalmát, például Zone.Identifier. Ezt azonban nem javasoljuk, hogy kiküszöbölje az internetről letöltött fájlokat letiltó biztonsági ellenőrzéseket. Ha ellenőrzi, hogy egy letöltött fájl biztonságos-e, használja a Unblock-File parancsmagot.
Ezt a paramétert a PowerShell 3.0-ban vezettük be. A PowerShell 7.2-ből Add-Content alternatív adatfolyamokat célozhat meg fájlokon és könyvtárakon egyaránt.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Value
Megadja a hozzáadni kívánt tartalmat. Írjon be egy idézett sztringet, például Ezek az adatok csak belső használatra szolgálnak, vagy adjon meg egy tartalmat tartalmazó objektumot, például a által létrehozott Get-Date objektumot.
A fájl tartalmát nem adhatja meg az elérési út beírásával, mert az elérési út csak egy sztring.
Egy Get-Content paranccsal lekérheti a tartalmat, és átadhatja a Érték paraméternek.
Paramétertulajdonságok
| Típus: | Object[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 1 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsprogram nem lett futtatva.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
Object
Az értékeket átirányíthatja a Add-Content-hoz.
PSCredential
A hitelesítő adatokat a Add-Content-ra irányíthatja.
Kimenetek
None
Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.
String
A PassThru paraméter használatakor ez a parancsmag egy System.String objektumot ad vissza, amely a tartalmat jelöli.
Jegyzetek
A PowerShell a következő aliasokat tartalmazza Add-Content:
Windows:
ac
Amikor egy objektumot csövön keresztül továbbít a
Add-Content-hoz, a rendszer karakterlánccá alakítja az objektumot, mielőtt hozzáadná az elemhez. Az objektumtípus határozza meg a sztring formátumát, de a formátum eltérhet az objektum alapértelmezett megjelenítésének formátumától. A sztringformátum szabályozásához használja a küldő parancsmag formázási paramétereit.A
Add-Contentparancsmag úgy lett kialakítva, hogy bármely szolgáltató által közzétett adatokkal működjön együtt. A munkamenetben elérhető szolgáltatók listájához írja be aGet-PSProvider. További információért lásd a about_Providerscímű részt.