adaugă conținut la elementele specificate, cum ar fi adăugarea de cuvinte într-un fișier.
- sintaxă
- descriere
- Exemple
- Exemplul 1: Adăugați un șir la toate fișierele text cu o excepție
- Exemplul 2: Adăugați o dată la sfârșitul fișierelor specificate
- Exemplul 3: Adăugați conținutul unui fișier specificat într-un alt fișier
- Exemplul 4: Adăugați conținutul unui fișier specificat într-un alt fișier folosind conducta
- exemplul 5: Crearea unui fișier nou și copierea conținutului
- exemplul 6: Adăugați conținut într-un fișier numai în citire
- exemplul 7: Utilizarea filtrelor cu Add-Content
- parametri
- intrări
- ieșiri
- Note
sintaxă
Add-Content <string> <Object> >] >] Add-Content <Object> -LiteralPath <string> >] >] descriere
Add-Content cmdletul adaugă conținut la un element sau fișier specificat. Puteți specifica conținutulprin tastarea conținutului în comandă sau prin specificarea unui obiect care conține conținutul.
dacă trebuie să creați fișiere sau directoare pentru următoarele exemple, consultați element nou.
Exemple
Exemplul 1: Adăugați un șir la toate fișierele text cu o excepție
acest exemplu adaugă o valoare fișierelor text din directorul curent, dar exclude fișierele bazate pe numele fișierului.
Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'parametrul Path Specifică toate fișierele.txt din directorul curent, dar Excludeparameter ignoră numele fișierelor care se potrivesc cu modelul specificat. Parametrul valoare specifică șir de text care este scris în fișiere.
Exemplul 2: Adăugați o dată la sfârșitul fișierelor specificate
Acest exemplu adaugă data la fișierele din directorul curent și afișează data înconsola PowerShell.
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 AMAdd-Content cmdletul creează două fișiere noi în directorul curent. Parametrul de valoare conțineeșireaGet-Date cmdlet. Parametrul PassThru scoate conținutul adăugat în conductă.Deoarece nu există alt cmdlet pentru a primi ieșirea, acesta este afișat în consola PowerShell.CmdletulGet-Content afișează fișierul actualizat,DateTimeFile1.log.
Exemplul 3: Adăugați conținutul unui fișier specificat într-un alt fișier
acest exemplu obține conținutul dintr-un fișier și stochează conținutul într-o variabilă. Variabila este utilizată pentru a adăuga conținutul într-un alt fișier.
$From = Get-Content -Path .\CopyFromFile.txtAdd-Content -Path .\CopyToFile.txt -Value $FromGet-Content -Path .\CopyToFile.txt-
Get-Contentcmdletul primește conținutulCopyFromFile.txtși stochează conținutul în variabila$From. -
Add-Contentcmdletul actualizează fișierulCopyToFile.txtfolosind conținutul variabilei$From. -
Get-Contentcmdletul afișează CopyToFile.txt.
Exemplul 4: Adăugați conținutul unui fișier specificat într-un alt fișier folosind conducta
acest exemplu obține conținutul dintr-un fișier și îl direcționează cătreAdd-Content cmdlet.
Get-Content -Path .\CopyFromFile.txt | Add-Content -Path .\CopyToFile.txtGet-Content -Path .\CopyToFile.txtGet-Content cmdletul primește conținutulCopyFromFile.txt. Rezultatele sunt transmise laAdd-Content cmdlet, care actualizeazăCopyToFile.txt.UltimulGet-Content cmdlet afișeazăCopyToFile.txt.
exemplul 5: Crearea unui fișier nou și copierea conținutului
acest exemplu creează un fișier nou și copiază conținutul unui fișier existent în noul fișier.
Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)Get-Content -Path .\NewFile.txt-
Add-Contentcmdletul utilizează parametrii cale și valoare pentru a crea un fișier nou în directorul curent. -
Get-Contentcmdletul primește conținutul unui fișier existent,CopyFromFile.txtși îl transmite parametrului de valoare. Parantezele din jurulGet-Contentcmdlet asigură că comanda se termină înainte de începerea comenziiAdd-Content. -
Get-Contentcmdletul afișează conținutul noului fișier,NewFile.txt.
exemplul 6: Adăugați conținut într-un fișier numai în citire
această comandă adaugă o valoare fișierului chiar dacă atributul de fișier IsReadOnly este setat la True.Pașii pentru crearea unui fișier numai în citire sunt incluși în exemplu.
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-
New-Itemcmdletul utilizează calea și parametrii ItemType pentru a crea fișierulIsReadOnlyTextFile.txtîn directorul curent. -
Set-ItemPropertycmdletul utilizează parametrii nume și valoare pentru a schimba proprietatea file ‘ isreadonly la True. -
Get-ChildItemcmdletul arată că fișierul este gol (0) și are atributul read-only (r). -
Add-Contentcmdletul utilizează parametrul Path pentru a specifica fișierul. Parametrul de Valoareinclude șirul de text pentru a adăuga la fișier. Parametrul forței scrie textul cătrefișier numai pentruead. -
Get-Contentcmdletul utilizează parametrul Path pentru a afișa conținutul fișierului.
pentru a elimina atributul numai în citire, utilizați comandaSet-ItemProperty cu parametrul de valoare setat laFalse.
exemplul 7: Utilizarea filtrelor cu Add-Content
puteți specifica un filtru laAdd-Content cmdlet. Când utilizați filtre pentru a califica Pathparameter, trebuie să includeți un asterisc final (*) pentru a indica conținutul căii.
următoarea comandă adaugă cuvântul „terminat” conținutul tuturor fișierelor*.txt din DirectorulC:\Temp.
Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"parametri
specifică faptul că conținutul trebuie citit ca un flux de octeți. Acest parametru a fost introdus înpowershell 6.0.
un avertisment apare atunci când utilizați parametrul AsByteStream cu parametrul de codificare. 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 |
| pseudonime: | cf |
| poziție: | numit |
| valoare implicită: | fals |
| accepta intrare conducte: | false |
| Accept caractere wildcard: | false |
notă
acest parametru nu este acceptat de niciun furnizor instalat cu PowerShell.To personificați un alt utilizator sau ridicați acreditările atunci când rulați acest cmdlet,utilizați Invoke-Command.
| 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. Acestparametru funcționează numai în unitățile de sistem de fișiere.
valorile acceptabile pentru acest parametru sunt următoarele:
-
ascii: utilizează codificarea pentru setul de caractere ASCII (7 biți). -
bigendianunicode: codifică în format UTF-16 folosind ordinea octetului big-endian. -
bigendianutf32: codifică în format UTF-32 folosind ordinea octetului big-endian. -
oem: utilizează codificarea implicită pentru programele MS-DOS și console. -
unicode: Codifică în format UTF-16 folosind ordinul de octeți little-endian. -
utf7: codifică în format UTF-7. -
utf8: codifică în format UTF-8. -
utf8BOM: codifică în format UTF-8 cu byte Order Mark (BOM) -
utf8NoBOM: codifică în format UTF-8 fără Byte Order Mark (BOM) -
utf32: codifică în format UTF-32.
începând cu PowerShell 6.2, parametrul de codificare permite, de asemenea, ID-uri numerice ale paginilor de cod înregistrate (cum ar fi -Encoding 1251) sau nume de șiruri ale paginilor de cod înregistrate (cum ar fi-Encoding "windows-1251"). Pentru mai multe informații, consultați documentația.net pentrucodificare.Pagina de cod.
notă
UTF-7* nu se mai recomandă utilizarea. În PowerShell 7.1, Este scris un avertisment dacă suntețispecificați utf7 pentru parametrul de codificare.
| Tip: | codare |
| valori acceptate: | 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. Introduceți un element de cale sau un model, cum ar fi*.txt. Caracterele Wildcard sunt permise. Parametrul Exclude este eficient numai atunci când comanda include conținutul unui element, cum ar fiC:\Windows\*, unde caracterul wildcard specifică conținutul directoruluiC:\Windows.
| Tip: | String |
| poziție: | numit |
| valoare implicită: | niciunul |
| acceptă intrarea conductei: | false |
| accepta caractere wildcard: | True |
specifică un filtru pentru a califica parametrul Path. FileSystemprovider este singurul furnizor PowerShell instalat care acceptă utilizarea filtrelor. Puteți găsisintaxa pentru limba de filtrare a sistemului de fișiere în about_Wildcards.Filtrele sunt mai eficiente decât alți parametri, deoarece furnizorul le aplică atunci când cmdletdevine obiectele, mai degrabă decât să aibă PowerShell filtra obiectele după ce sunt preluate.
| Tip: | String |
| poziție: | numit |
| valoare implicită: | nici unul |
| accepta intrare conducte: | False | accepta caractere wildcard: | adevărat |
suprascrie atributul numai în citire, permițându-vă să adăugați conținut într-un fișier numai în citire. De exemplu, Force va suprascrie atributul read-only sau va crea directoare pentru a finaliza o cale de fișier, darnu va încerca să schimbe permisiunile fișierului.
| Tip: | SwitchParameter |
| poziție: | numit |
| valoare implicită: | nici unul |
| accepta intrare conducte: | False |
| accepta caractere wildcard: | False |
specifică, ca matrice șir, un element sau elemente pe care acest cmdlet le include în operație. Valoarea acestui parametru califică parametrul Path. Introduceți un element de cale sau un model, cum ar fi"*.txt". Caracterele Wildcard sunt permise. Parametrul Include este eficient numai atunci când thecommand include conținutul unui element, cum ar fiC:\Windows\*, unde caracterul wildcard specifică conținutul directoruluiC:\Windows.
| Tip: | String |
| poziție: | numit |
| valoare implicită: | niciunul |
| acceptă intrarea conductei: | false |
| accepta caractere wildcard: | True |
specifică o cale către una sau mai multe locații. Valoarea LiteralPath este folosită exact așa cum estetipat. Nu există caractere sunt interpretate ca metacaractere. Dacă calea include caractere de evacuare, anexațiîn ghilimele simple. Ghilimelele unice îi spun lui PowerShell să nu interpreteze Niciun caracterca secvențe de evadare.
pentru mai multe informații, consultați about_Quoting_Rules.
| Tip: | String |
| pseudonime: | PSPath, LP |
| poziție: | numit |
| valoare implicită: | nici unul |
| accepta intrare conducte: | adevărat |
| accepta caractere wildcard: | false |
indică faptul că acest cmdlet nu adaugă o nouă linie sau retur de transport la conținut.
reprezentările șirului obiectelor de intrare sunt concatenate pentru a forma ieșirea. Nu există spații saunoi linii sunt introduse între șirurile de ieșire. Nu se adaugă nicio linie nouă după ultimul șir de ieșire.
| Tip: | SwitchParameter |
| poziție: | numit |
| valoare implicită: | niciunul |
| acceptă intrarea conductei: | false |
| accepta caractere wildcard: | false |
returnează un obiect care reprezintă conținutul adăugat. În mod implicit, acest cmdlet nu generează niciunuloutput.
| Tip: | SwitchParameter |
| poziție: | numit |
| valoare implicită: | nici unul |
| accepta intrare conducte: | fals |
| accepta caractere wildcard: | false |
specifică calea către elementele care primesc conținutul suplimentar.Caracterele Wildcard sunt permise.Căile trebuie să fie căi către obiecte, nu către containere.De exemplu, trebuie să specificați o cale către unul sau mai multe fișiere, nu o cale către un director.Dacă specificați mai multe căi, utilizați virgule pentru a separa căile.
| Tip: | String |
| poziție: | 0 |
| valoare implicită: | niciunul |
| acceptă intrarea conductei: | true |
| accepta caractere wildcard: | true |
notă
acest parametru este disponibil numai pe Windows.
specifică un flux de date alternativ pentru conținut. Dacă fluxul nu există, acest cmdlet creeazăsit. Caracterele Wildcard nu sunt acceptate.
Stream este un parametru dinamic pe care furnizorul sistemului de fișiere îl adaugă laAdd-Content. Acestparametru funcționează numai în unitățile de sistem de fișiere.
puteți utilizaAdd-Content cmdletul pentru a modifica conținutul oricărui flux alternatedata, cum ar fiZone.Identifier. Cu toate acestea, nu recomandăm acest lucru cao modalitate de a elimina verificările de securitate care blochează fișierele descărcate de pe Internet. Dacă verificați că un fișier descărcat este sigur, utilizațiUnblock-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. Tastați un șir Citat, cum ar fi aceste date este pentru uz internonly, sau specificați un obiect care conține conținut, cum ar fi obiectul DateTime care Get-Dategenerează.
nu puteți specifica conținutul unui fișier tastând calea acestuia, deoarece calea este doar un șir.Puteți utiliza o comandă Get-Content pentru a obține conținutul și a-l transmite parametrului de valoare.
| Tip: | obiect |
| poziție: | 1 |
| valoare implicită: | niciunul |
| acceptă intrarea conductei: | 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 |
intrări
sistem.Obiect, Sistem.Management.Automatizare.PSCredential
puteți țeava valori, căi sau acreditări laSet-Content.
ieșiri
nici unul sau sistem.String
când utilizați parametrul PassThru,Add-Content generează un sistem.String obiect carereprezintă conținutul. În caz contrar, acest cmdlet nu generează nicio ieșire.
Note
- când introduceți un obiect în
Add-Content, obiectul este convertit într-un șir înainte de a fi adăugat la element. Tipul de obiect determină formatul șirului, dar formatul poate fi diferit de afișarea implicită a obiectului. Pentru a controla formatul șirului, utilizați parametrii de formatare atrimiterea cmdlet-ului. - puteți consulta, de asemenea,
Add-Contentprin aliasul său încorporat,ac. Pentru mai multe informații, consultați despre_aliases. -
Add-Contentcmdletul este proiectat să funcționeze cu datele expuse de orice furnizor. Pentru a lista furnizorii disponibili în sesiunea dvs., tastațiGet-PSProvider. Pentru mai multe informații, consultațiabout_providers.
- about_Aliases
- about_Providers
- Clear-Content
- Get-Content
- Get-Item
- New-Item
- set-Content