Tartalom hozzáadása a megadott elemekhez, például szavak hozzáadása egy fájlhoz.
- szintaxis
- leírás
- példák
- 1. példa: adjon hozzá egy karakterláncot az összes szöveges fájlhoz, kivéve
- 2. példa: Add a date to the end of the specified files
- 3. példa: adja hozzá a megadott fájl tartalmát egy másik fájlhoz
- 4. példa: adja hozzá egy adott fájl tartalmát egy másik fájlhoz a
- 5. példa: új fájl létrehozása és tartalom másolása
- 6. példa: tartalom hozzáadása csak olvasható fájlhoz
- 7. példa: a
- paraméterek
- bemenetek
- kimenetek
- Megjegyzések
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
aCopyFromFile.txt
tartalmát a$From
változóban tárolja. - a
Add-Content
cmdlet frissíti aCopyToFile.txt
fájlt a$From
változó tartalmával. - a
Get-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-Content
cmdlet megkapja egy meglévő fájl tartalmát,CopyFromFile.txt
és átadja az Értékparaméternek. AGet-Content
cmdlet körüli zárójelek biztosítják, hogy a parancs befejeződik, mielőtt aAdd-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-ChildItem
cmdlet azt mutatja, hogy a fájl üres (0), és csak olvasható attribútummal rendelkezik (r
). - a
Add-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. - a
Get-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:\Temp
könyvtárban.
Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"
paraméterek
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 objektumot
Add-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 a
Add-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 aGet-PSProvider
parancsot. További információ: seeabout_Providers.
- about_Aliases
- about_Providers
- Clear-Content
- Get-Item
- New-Item
- Set-Content
Get-Content