Add-Content
Přidá obsah do zadaných položek, například přidání slov do souboru.
Syntax
Path (Výchozí)
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
Rutina Add-Content připojí obsah k zadané položce nebo souboru. Obsah můžete určit zadáním obsahu do příkazu nebo určením objektu, který obsahuje obsah.
Pokud potřebujete vytvořit soubory nebo adresáře pro následující příklady, přečtěte si New-Item .
Příklady
Příklad 1: Přidání řetězce do všech textových souborů s výjimkou
Tento příklad připojí hodnotu k textovým souborům v aktuálním adresáři, ale vyloučí soubory na základě jejich názvu.
Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'
Rutina Add-Content používá parametr Path k určení všech souborů .txt v aktuálním adresáři.
Parametr Exclude ignoruje názvy souborů, které odpovídají zadanému vzoru. Parametr Hodnota určuje textový řetězec, který je zapsán do souborů.
Příklad 2: Přidání data na konec zadaných souborů
Tento příklad připojí datum k souborům v aktuálním adresáři a zobrazí datum v konzole PowerShellu.
Add-Content -Path .\DateTimeFile1.log, .\DateTimeFile2.log -Value (Get-Date) -PassThru
Get-Content -Path .\DateTimeFile1.log
Rutina Add-Content používá parametry Path a Value k vytvoření dvou nových souborů v aktuálním adresáři. Parametr Value určuje rutinu Get-Date pro získání data a předá datum .Add-Content Rutina Add-Content zapíše datum do každého souboru.
Parametr PassThru předá objekt, který představuje objekt date. Vzhledem k tomu, že neexistuje žádná jiná rutina, která by předaný objekt přijala, zobrazí se v konzole PowerShellu. Rutina Get-Content zobrazí aktualizovaný soubor DateTimeFile1.log.
Příklad 3: Přidání obsahu zadaného souboru do jiného souboru
Tento příklad získá obsah ze souboru a připojí tento obsah do jiného souboru.
Add-Content -Path .\CopyToFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)
Get-Content -Path .\CopyToFile.txt
Rutina Add-Content používá parametr Path k určení nového souboru v aktuálním adresáři, CopyToFile.txt. Parametr Value používá rutinu Get-Content k získání obsahu souboru, CopyFromFile.txt. Závorky kolem cmdletu Get-Content zajistí, že se příkaz dokončí, než začne příkaz Add-Content. Parametr Value je předán do Add-Content. Rutina Add-Content připojí data k souboru CopyToFile.txt. Rutina Get-Content zobrazí aktualizovaný soubor CopyToFile.txt.
Příklad 4: Použití proměnné k přidání obsahu určeného souboru do jiného souboru
Tento příklad získá obsah ze souboru a uloží obsah do proměnné. Proměnná se používá k připojení obsahu do jiného souboru.
$From = Get-Content -Path .\CopyFromFile.txt
Add-Content -Path .\CopyToFile.txt -Value $From
Get-Content -Path .\CopyToFile.txt
Rutina Get-Content získá obsah CopyFromFile.txt a uloží obsah do proměnné $From . Rutina Add-Content používá parametr Path k určení souboru CopyToFile.txt v aktuálním adresáři.
Parametr Value používá proměnnou $From a předá obsah .Add-Content Rutina Add-Content aktualizuje soubor CopyToFile.txt. Cmdlet Get-Content zobrazí CopyToFile.txt.
Příklad 5: Vytvoření nového souboru a zkopírování obsahu
Tento příklad vytvoří nový soubor a zkopíruje obsah existujícího souboru do nového souboru.
Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)
Get-Content -Path .\NewFile.txt
Rutina Add-Content používá parametry Path a Value k vytvoření nového souboru v aktuálním adresáři. Parametr Value používá rutinu Get-Content k získání obsahu existujícího souboru, CopyFromFile.txt. Závorky kolem cmdletu Get-Content zajistí, že se příkaz dokončí, než začne příkaz Add-Content.
Parametr Value předá obsah, na Add-Content který se aktualizuje NewFile.txt soubor. Rutina Get-Content zobrazí obsah nového souboru NewFile.txt.
Příklad 6: Přidání obsahu do souboru jen pro čtení
Tento příkaz přidá hodnotu do souboru i v případě, že je atribut souboru IsReadOnly nastaven na hodnotu True. Kroky k vytvoření souboru jen pro čtení jsou zahrnuty v příkladu.
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
Rutina New-Item používá parametry Path a ItemType k vytvoření IsReadOnlyTextFile.txt souboru v aktuálním adresáři. Rutina Set-ItemProperty používá parametry Name a Value ke změně vlastnosti IsReadOnly souboru na True. Rutina Get-ChildItem ukazuje, že soubor je prázdný (0) a má atribut pouze pro čtení (r). Rutina Add-Content k zadání souboru používá parametr Path. Parametr obsahuje textový řetězec, který má být připojen k souboru. Parametr Force zapíše text do souboru jen pro čtení. Rutina Get-Content používá k zobrazení obsahu souboru parametr Path.
Pokud chcete odebrat atribut jen pro čtení, použijte příkaz Set-ItemProperty s parametrem Value nastaveným na False.
Parametry
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Credential
Určuje uživatelský účet, který má oprávnění k provedení této akce. Výchozí hodnota je aktuální uživatel.
Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte objekt PSCredential, například objekt vygenerovaný rutinou Get-Credential. Pokud zadáte uživatelské jméno, zobrazí se výzva k zadání hesla.
Výstraha
Tento parametr nejsou podporovány žádnými poskytovateli nainstalovanými v PowerShellu.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Encoding
Určuje typ kódování cílového souboru. Výchozí hodnota je Default.
Přijatelné hodnoty pro tento parametr jsou následující:
- ASCII používá znakovou sadu ASCII (7bitová).
- BigEndianUnicode používá UTF-16 s pořadím velkých bajtů.
- BigEndianUTF32 Používá UTF-32 s pořadím velkých bajtů.
- Bajt Zakóduje sadu znaků do posloupnosti bajtů.
- Výchozí Používá kódování odpovídající aktivní znakové stránce systému (obvykle ANSI).
- OEM Používá kódování odpovídající aktuální znakové stránce OEM systému.
- řetězec stejné jako unicode.
- Unicode používá UTF-16 s minimálním pořadím bajtů.
neznámé stejné jakounicode. - UTF7 používá UTF-7.
- UTF8 používá UTF-8.
- UTF32 používá UTF-32 s malým pořadím bajtů.
Kódování je dynamický parametr, který zprostředkovatel FileSystem přidá do rutiny Add-Content. Tento parametr funguje jenom na jednotkách systému souborů.
Vlastnosti parametru
| Typ: | FileSystemCmdletProviderEncoding |
| Default value: | Default |
| Přípustné hodnoty: | ASCII, BigEndianUnicode, BigEndianUTF32, Byte, Default, OEM, String, Unicode, Unknown, UTF7, UTF8, UTF32 |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Exclude
Vynechá zadané položky. Hodnota tohoto parametru kvalifikuje parametr Path. Zadejte element nebo vzorek cesty, například *.txt. Jsou povoleny zástupné symboly.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Filter
Určuje filtr ve formátu nebo jazyce poskytovatele. Hodnota tohoto parametru kvalifikuje parametr Path. Syntaxe filtru, včetně použití zástupných znaků, závisí na poskytovateli. Filtry jsou efektivnější než jiné parametry, protože poskytovatel používá filtry při načítání objektů. V opačném případě PowerShell zpracuje filtry po načtení objektů.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Force
Přepíše atribut jen pro čtení, který umožňuje přidat obsah do souboru jen pro čtení. Například Vynutit přepíše atribut jen pro čtení nebo vytvoří adresáře pro dokončení cesty k souboru, ale nebude se pokoušet změnit oprávnění k souboru.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Include
Přidá pouze určené položky. Hodnota tohoto parametru kvalifikuje parametr Path. Zadejte element nebo vzorek cesty, například *.txt. Jsou povoleny zástupné symboly.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-LiteralPath
Určuje cestu k položkám, které přijímají další obsah. Na rozdíl od cestyse hodnota LiteralPath používá přesně tak, jak je zadána. Žádný znak není interpretován jako zástupný znak. Pokud cesta obsahuje únikové znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, aby žádné znaky neinterpretoval jako únikové sekvence.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSPath |
Sady parametrů
LiteralPath
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-NoNewline
Označuje, že tato rutina nepřidá do obsahu nový řádek nebo znak konce řádku.
Řetězcové reprezentace vstupních objektů jsou zřetězeny tak, aby vytvořily výstup. Mezi výstupní řetězce se nevkládají žádné mezery ani nové čáry. Za poslední výstupní řetězec se nepřidá žádný nový řádek.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-PassThru
Vrátí objekt představující přidaný obsah. Ve výchozím nastavení tato rutina negeneruje žádný výstup.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Path
Určuje cestu k položkám, které přijímají další obsah. Jsou povoleny zástupné symboly. Pokud zadáte více cest, oddělte cesty čárkami.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
Path
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Stream
Určuje alternativní datový proud pro obsah. Pokud stream neexistuje, tato rutina ho vytvoří. Zástupné znaky nejsou podporovány.
Stream je dynamický parametr, který zprostředkovatel FileSystem přidává do Add-Content. Tento parametr funguje jenom na jednotkách systému souborů.
Pomocí rutiny Add-Content můžete změnit obsah Zone.Identifier alternativní datový proud. Nedoporučujeme to ale jako způsob, jak eliminovat kontroly zabezpečení, které blokují soubory stažené z internetu. Pokud ověříte, že je stažený soubor v bezpečí, použijte rutinu Unblock-File.
Tento parametr byl představen v PowerShellu 3.0.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-UseTransaction
Zahrnuje příkaz v aktivní transakci. Tento parametr je platný pouze v případě, že probíhá transakce. Další informace najdete v tématu about_Transactions.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | usetx |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Value
Určuje obsah, který se má přidat. Zadejte uvozovaný řetězec, například Tato data se používají pouze pro interní použití, nebo zadejte objekt, který obsahuje obsah, například objekt DateTime, který Get-Date generuje.
Obsah souboru nemůžete určit zadáním jeho cesty, protože cesta je pouze řetězec.
Obsah můžete získat pomocí příkazu Get-Content a předat ho parametru Value.
Vlastnosti parametru
| Typ: | Object[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 1 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
System.Object, System.Management.Automation.PSCredential
Hodnoty, cesty nebo přihlašovací údaje můžete přesměrovat do Set-Contentrozhraní .
Výstupy
None or System.String
Pokud použijete parametr PassThru, Add-Content vygeneruje objekt System.String, který představuje obsah. Jinak tento příkaz negeneruje žádný výstup.
Poznámky
Když předáte objekt do Add-Content, objekt se před přidáním k položce převede na řetězec. Typ objektu určuje formát řetězce, ale formát se může lišit od výchozího zobrazení objektu. K řízení formátu řetězce použijte formátovací parametry odesílací rutiny.
Můžete také odkazovat na Add-Content jeho předdefinovaný alias ac. Další informace viz about_Aliases.
Rutina Add-Content je navržená tak, aby fungovala s daty vystavenými jakýmkoli poskytovatelem. Chcete-li zobrazit seznam poskytovatelů dostupných ve vaší relaci, napište Get-PSProvider. Pro více informací viz about_Providers.