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]
[-UseTransaction]
[-NoNewline]
[-Encoding <FileSystemCmdletProviderEncoding>]
[-Stream <string>]
[<CommonParameters>]
LiteralPath
Add-Content
[-Value] <Object[]>
-LiteralPath <string[]>
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-NoNewline]
[-Encoding <FileSystemCmdletProviderEncoding>]
[-Stream <string>]
[<CommonParameters>]
Description
A Add-Content parancsmag egy adott elemhez vagy fájlhoz fűzi a tartalmat. A tartalmat úgy adhatja meg, hogy beírja a tartalmat a parancsba, vagy megad egy objektumot, amely tartalmazza a tartalmat.
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 Add-Content parancsmag az Path paraméterrel adja meg az aktuális könyvtárban található összes .txt fájlt. Az Exclude paraméter figyelmen kívül hagyja a megadott mintának megfelelő fájlneveket. Az Érték paraméter a fájlokba írt szöveges sztringet adja meg.
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
A Add-Content parancsmag az Elérési út és az Érték paraméterekkel hoz létre két új fájlt az aktuális könyvtárban. A Value paraméter megadja a Get-Date dátum lekéréséhez szükséges parancsmagot, és átadja a dátumot Add-Content. A Add-Content parancsmag minden fájlba beírja a dátumot. A PassThru paraméter átad egy objektumot, amely a date objektumot jelöli. Mivel nincs más parancsmag az átadott objektum fogadására, 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 hozzáfűzi a tartalmat egy másik fájlhoz.
Add-Content -Path .\CopyToFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)
Get-Content -Path .\CopyToFile.txt
A Add-Content parancsmag az Path paraméterrel adja meg az új fájlt az aktuális könyvtárban, CopyToFile.txt. A Value paraméter a Get-Content parancsmag használatával lekéri a fájl tartalmát, CopyFromFile.txt. A Get-Content parancsmag zárójelei biztosítják, hogy a parancs a Add-Content parancs megkezdése előtt befejeződjön. A Value paramétert a rendszer átadja a következőnek: Add-Content. A Add-Content parancsmag hozzáfűzi az adatokat a CopyToFile.txt fájlhoz. A Get-Content parancsmag megjeleníti a frissített fájlt, CopyToFile.txt.
4. példa: Adott fájl tartalmának hozzáadása egy másik fájlhoz változóval
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-Content parancsmag lekéri a CopyFromFile.txt tartalmát, és a változóban $From tárolja a tartalmat. A Add-Content parancsmag az Path paraméterrel adja meg az aktuális könyvtárban található CopyToFile.txt fájlt. A Value paraméter a változót $From használja, és átadja a tartalmat a Add-Content. A Add-Content parancsmag frissíti a CopyToFile.txt fájlt. A Get-Content parancsmag CopyToFile.txtjelenít meg.
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-Content parancsmag a Elérési út és Érték paraméterekkel hoz létre új fájlt az aktuális könyvtárban. A Value paraméter a Get-Content parancsmag használatával lekéri egy meglévő fájl tartalmát, CopyFromFile.txt. A Get-Content parancsmag zárójelei biztosítják, hogy a parancs a Add-Content parancs megkezdése előtt befejeződjön. A Value paraméter átadja azt a tartalmat Add-Content , amelyre frissíti a NewFile.txt fájlt. A Get-Content parancsmag 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áadja az értéket a fájlhoz, ha az IsReadOnly fájlattribútum True értékre van állítva. 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-Item parancsmag az Path és az ItemType paraméterekkel hozza létre a fájlt IsReadOnlyTextFile.txt az aktuális könyvtárban. A Set-ItemProperty parancsmag a Név és Érték paraméterekkel módosítja a fájl IsReadOnly tulajdonságát Igazra. A Get-ChildItem parancsmag azt mutatja, hogy a fájl üres (0), és csak olvasható attribútummal ()r rendelkezik. A Add-Content parancsmag 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-Content parancsmag 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.
Paraméterek
-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
A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Az alapértelmezett az aktuális felhasználó.
Írjon be egy felhasználónevet(például User01 vagy Domain01\User01), vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által létrehozott objektumot. Ha felhasználónevet ír be, a rendszer jelszót fog kérni.
Figyelmeztetés
Ezt a paramétert a PowerShell-lel telepített szolgáltatók nem támogatják.
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 következő: Alapértelmezett.
A paraméter elfogadható értékei a következők:
- ASCII ASCII (7 bites) karakterkészletet használ.
- BigEndianUnicode UTF-16-ot használ a big-endian bájtsorrenddel.
- BigEndianUTF32 UTF-32-t használ a big-endian bájtsorrenddel.
- Bájt bájtok sorozatába kódol egy karaktersorozatot.
- Alapértelmezett A rendszer aktív kódlapjának (általában ANSI) megfelelő kódolást használja.
- OEM A rendszer aktuális OEM-kódlapjának megfelelő kódolást használja.
Unicode- .sztring - Unicode UTF-16-ot használ a kis-endian bájtsorrenddel.
- Ismeretlen Ugyanaz, mint Unicode.
- UTF7 UTF-7-et használ.
- UTF8 UTF-8-at használ.
- UTF32 UTF-32-t használ a kis végű bájtsorrenddel.
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.
Paramétertulajdonságok
| Típus: | FileSystemCmdletProviderEncoding |
| Alapértelmezett érték: | Default |
| Elfogadott értékek: | ASCII, BigEndianUnicode, BigEndianUTF32, Byte, Default, OEM, String, Unicode, Unknown, UTF7, UTF8, 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
Kihagyja a megadott elemeket. Ennek a paraméternek az értéke a Elérési út paramétert minősíti. Írjon be egy görbeelemet vagy mintát, például *.txt. Helyettesítő karakterek használata engedélyezett.
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
A szűrőt a szolgáltató formátumában vagy nyelvén adja meg. Ennek a paraméternek az értéke a Elérési út paramétert minősíti. A szűrő szintaxisa, beleértve a helyettesítő karakterek használatát, a szolgáltatótól függ. A szűrők hatékonyabbak, mint a többi paraméter, mivel a szolgáltató szűrőket alkalmaz az objektumok lekérésekor. Ellenkező esetben a PowerShell feldolgozza a szűrőket az objektumok lekérése 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 a Force felülbírálja az írásvédett attribútumot, vagy könyvtárakat hoz létre a fájl elérési útjának befejezéséhez, de nem fog próbálkozni a fájlengedélyek módosításával.
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
Csak a megadott elemeket adja hozzá. Ennek a paraméternek az értéke a Elérési út paramétert minősíti. Írjon be egy görbeelemet vagy mintát, például *.txt. Helyettesítő karakterek használata engedélyezett.
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
Megadja a további tartalmat fogadó elemek elérési útját. A Path-tal ellentétben a LiteralPath értéke pontosan a beíráskor lesz használva. 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.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | PSPath |
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
Azt jelzi, hogy ez a parancsmag nem ad hozzá új sort vagy kocsit 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. Helyettesítő karakterek használata engedélyezett. 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
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 a Zone.Identifier alternatív adatfolyam tartalmát. 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.
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 |
-UseTransaction
Tartalmazza a parancsot az aktív tranzakcióban. Ez a paraméter csak akkor érvényes, ha egy tranzakció folyamatban van. További információ: about_Transactions.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | usetx |
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 karakterlánc.
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 parancsmag nem fut.
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
System.Object, System.Management.Automation.PSCredential
Az értékeket, elérési utakat vagy hitelesítő adatokat a Set-Content.
Kimenetek
None or System.String
Ha a PassThru paramétert használja, Add-Content létrehoz egy System.String objektumot, amely a tartalmat jelöli. Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.
Jegyzetek
Amikor egy objektumot Add-Contenttovábbít , az objektum karakterlánccá alakul, 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-Content is hivatkozhat a beépített aliasára, ac. További információ: about_Aliases.
A Add-Content parancsmag ú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 a Get-PSProvider. További információért lásd a about_Providerscímű részt.