přidá obsah k zadaným položkám, například přidání slov do souboru.
- Syntax
- Popis
- Příklady
- Příklad 1: Přidat řetězec na všechny textové soubory, s výjimkou
- příklad 2: Přidat datum na konec zadaných souborů
- příklad 3: Přidání obsahu zadaného souboru do jiného souboru
- Příklad 4: Přidejte obsah zadaného souboru do druhého pomocí potrubí
- příklad 5: Vytvoření nového souboru a kopírování obsahu
- příklad 6: Přidání obsahu do souboru jen pro čtení
- příklad 7: Použijte filtry s Add-Content
- Parametry
- vstupy
- výstupy
- Poznámky
Syntax
Add-Content <string> <Object> >] >] Add-Content <Object> -LiteralPath <string> >] >] Popis
Add-Content rutiny připojí obsah zadané položky nebo souboru. Obsah můžete zadat zadáním obsahu do příkazu nebo zadáním objektu, který Obsah obsahuje.
Pokud potřebujete vytvořit soubory nebo adresáře pro následující příklady, viz Nová položka.
Příklady
Příklad 1: Přidat řetězec na všechny textové soubory, s výjimkou
Tento příklad přidá hodnoty do textových souborů v aktuálním adresáři, ale nezahrnuje soubory na základě najejich název souboru.
Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'parametr Path určuje všechny .txt soubory v aktuálním adresáři, ale Excludeparameter ignoruje názvy souborů, které odpovídají zadanému vzoru. Parametr hodnota specifikujetext řetězec, který je zapsán do souborů.
příklad 2: Přidat datum na konec zadaných souborů
tento příklad připojí Datum k souborům v aktuálním adresáři a zobrazí datum v konzoli 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 rutina vytvoří dva nové soubory v aktuálním adresáři. Parametr hodnoty obsahujevýstup rutiny Get-Date. Parametr PassThru vypíše přidaný obsah do potrubí.Protože neexistuje žádná jiná rutina pro příjem výstupu, je zobrazena v konzole PowerShell.Get-Content rutina zobrazuje 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 uloží obsah do proměnné. Proměnná se používá k přidání obsahu do jiného souboru.
$From = Get-Content -Path .\CopyFromFile.txtAdd-Content -Path .\CopyToFile.txt -Value $FromGet-Content -Path .\CopyToFile.txt-
Get-Contentcmdlet dostane obsah zCopyFromFile.txta ukládá obsah v$Fromproměnné. -
Add-Contentcmdlet aktualizaceCopyToFile.txtsoubor pomocí obsah$Fromproměnné. -
Get-Contentrutina zobrazuje CopyToFile.txt.
Příklad 4: Přidejte obsah zadaného souboru do druhého pomocí potrubí
Tento příklad dostane obsah ze souboru a trubky do Add-Content rutiny.
Get-Content -Path .\CopyFromFile.txt | Add-Content -Path .\CopyToFile.txtGet-Content -Path .\CopyToFile.txtGet-Content cmdlet dostane obsah z CopyFromFile.txt. Výsledky jsou směrovány doAdd-Content rutina, která aktualizuje CopyToFile.txt.Poslední Get-Content cmdlet zobrazuje CopyToFile.txt.
příklad 5: Vytvoření nového souboru a kopí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-
Add-Contentrutiny používá Cesty a Hodnoty parametrů vytvořit nový soubor v aktuální složce. - rutina
Get-Contentzíská obsah existujícího souboru,CopyFromFile.txta předá jej parametru Value. Závorky kolemGet-Contentcmdlet zajišťují, že příkaz skončí dříve, než začne příkazAdd-Content. -
Get-Contentrutina zobrazuje obsah nového souboru,NewFile.txt.
příklad 6: Přidání obsahu do souboru jen pro čtení
Tento příkaz přidá hodnotu souboru, i když je atribut souboru IsReadOnly nastaven na hodnotu True.Kroky k vytvoření souboru pouze pro čtení jsou zahrnuty v příkladu.
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-Itemrutiny používá Cestu a ItemType parametry k vytvoření souboruIsReadOnlyTextFile.txtv aktuálním adresáři. - rutina
Set-ItemPropertypoužívá parametry názvu a hodnoty ke změně vlastnosti isreadonly souboru na hodnotu True. -
Get-ChildItemcmdlet ukazuje, že soubor je prázdný (0) a má atribut jen pro čtení (r). - rutina
Add-Contentpoužívá parametr Path k určení souboru. Hodnota parameterincludes textový řetězec připojit k souboru. Parametr Force zapíše text do souboru pouze pro čtení. - rutina
Get-Contentpoužívá parametr Path k zobrazení obsahu souboru.
odebrat atribut jen pro čtení, použijte Set-ItemProperty příkaz s Hodnotou parameterset False.
příklad 7: Použijte filtry s Add-Content
můžete zadat filtr do Add-Content rutina. Pokud používáte filtry pro kvalifikaci Pathparameter, musíte zahrnout koncovou hvězdičku (*), abyste označili obsah cesty.
následující příkaz přidá slovo „Hotovo“ obsah *.txt soubory C:\Tempadresář.
Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"Parametry
Určuje, že obsah by měl být chápán jako proud bajtů. Tento parametr byl zaveden vpowershell 6.0.
varování nastane, když použijete parametr AsByteStream s parametrem kódování. 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 |
| Aliasů: | viz |
| Poloha: | Jménem |
| Výchozí hodnota: | False |
| Přijmout potrubí vstup: | False |
| použít zástupné znaky: | False |
Poznámka:
Tento parametr není podporován poskytovatelů nainstalován s PowerShell.Vydávat se za jiného uživatele, nebo zvýšit vaše pověření při spuštění této rutiny,pomocí 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. Thisparameter funguje pouze v souborových systémových jednotkách.
přípustné hodnoty pro tento parametr jsou následující:
-
ascii: Používá kódování ASCII (7-bit) znakovou sadu. -
bigendianunicode: Kóduje v UTF-16 formátu big-endian byte order. -
bigendianutf32: Kóduje v UTF-32 formátu big-endian byte order. -
oem: používá výchozí kódování pro programy MS-DOS a konzoly. -
unicode: Kóduje ve formátu UTF-16 pomocí little-endian byte order. -
utf7: kódování ve formátu UTF-7. -
utf8: kódování ve formátu UTF-8. -
utf8BOM: Kóduje v UTF-8 formátu s Byte Order Mark (BOM) -
utf8NoBOM: Kóduje v UTF-8 formátu bez Značka Pořadí Bajtů (BOM) -
utf32: Kóduje v UTF-32 formát.
počínaje PowerShell 6.2, Kódování parametr také umožňuje číselné Identifikátory registrované codepages (jako -Encoding 1251) nebo řetězec názvů registrovaných kód stránky (jako-Encoding "windows-1251"). Další informace naleznete v dokumentaci.NET pro kód.kódování.
Poznámka
UTF-7 * se již nedoporučuje používat. V PowerShell 7.1 je napsáno varování, pokud vypsat utf7 pro parametr kódování.
| Typ: | Kódování |
| povolené hodnoty: | 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. Zadejte prvek cesty nebo vzor, například*.txt. Zástupné znaky jsou povoleny. Vyloučit parametr je účinný pouze tehdy, když příkazovém obsahuje obsah položky, jako je C:\Windows\*, kde zástupný characterspecifies obsah C:\Windows adresář.
| Typ: | String |
| Poloha: | Jménem |
| Výchozí hodnota: | None |
| Přijmout potrubí vstup: | False |
| použít zástupné znaky: | True |
určuje filtr pro kvalifikaci parametru Path. FileSystemprovider je jediný nainstalovaný poskytovatel PowerShell, který podporuje použití filtrů. Syntaxi pro jazyk filtru souborového systému najdete v about_Wildcards.Filtry jsou účinnější než jiné parametry, protože poskytovatel aplikuje je při cmdletgets objekty, spíše než s PowerShell filtrovat objekty poté, co jsou načtena.
| Typ: | String |
| pozice: | Jménem |
| Výchozí hodnota: | None |
| Přijmout potrubí vstup: | False |
| použít zástupné znaky: | True |
Přepíše atribut jen pro čtení, což vám umožní přidat obsah do read-only soubor. Například Force přepíše atribut pouze pro čtení nebo vytvoří adresáře pro dokončení cesty k souboru, ale nepokusí se změnit oprávnění k souboru.
| Typ: | SwitchParameter |
| Pozice: | Jménem |
| Výchozí hodnota: | None |
| Přijmout potrubí vstup: | False |
| použít zástupné znaky: | False |
Určuje, jak je pole řetězců, položku nebo položky, které této rutiny obsahuje v provozu. Hodnota tohoto parametru kvalifikuje parametr cesta. Zadejte prvek cesty nebo vzor, například"*.txt". Zástupné znaky jsou povoleny. Zahrnout parametr je účinný pouze tehdy, když příkazovém obsahuje obsah položky, jako je C:\Windows\*, kde zástupný characterspecifies obsah C:\Windows adresář.
| Typ: | String |
| Poloha: | Jménem |
| Výchozí hodnota: | None |
| Přijmout potrubí vstup: | False |
| použít zástupné znaky: | True |
Určuje cestu, na jednom nebo více místech. Hodnota LiteralPath se používá přesně tak, jak jetyp. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje escape znaky, přiložte jej do jednotlivých uvozovek. Jednotlivé uvozovky říkají PowerShell ne interpretovat žádné charactersas escape sekvence.
Další informace naleznete v about_Quoting_Rules.
| Typ: | String |
| aliasy: | PSPath, LP |
| Poloha: | Jménem |
| Výchozí hodnota: | None |
| Přijmout potrubí vstup: | True |
| použít zástupné znaky: | False |
Označuje, že tato rutina není přidat nový řádek a návrat vozíku do obsahu.
reprezentace řetězců vstupních objektů jsou zřetězeny pro vytvoření výstupu. Mezi výstupní řetězce nejsou vloženy žádné mezery nebonovinky. Po posledním výstupním řetězci není přidán žádný nový řádek.
| Typ: | SwitchParameter |
| Poloha: | Jménem |
| Výchozí hodnota: | None |
| Přijmout potrubí vstup: | False |
| použít zástupné znaky: | False |
Vrací objekt představující přidaný obsah. Ve výchozím nastavení Tato rutina negeneruje žádnévýstup.
| Typ: | SwitchParameter |
| Poloha: | Jménem |
| Výchozí hodnota: | None |
| Přijmout potrubí vstup: | False |
| použít zástupné znaky: | False |
Určuje cestu pro zboží, které obdrží dodatečný obsah.Zástupné znaky jsou povoleny.Cesty musí být cesty k položkám, ne ke kontejnerům.Například musíte zadat cestu k jednomu nebo více souborům, nikoli cestu k adresáři.Pokud zadáte více cest, použijte čárky k oddělení cest.
| Typ: | String |
| Poloha: | 0 |
| Výchozí hodnota: | None |
| Přijmout potrubí vstup: | True |
| použít zástupné znaky: | True |
Poznámka:
Tento Parametr je k dispozici pouze v systému Windows.
určuje alternativní datový tok pro obsah. Pokud stream neexistuje, vytvoří se tato rutina. Zástupné znaky nejsou podporovány.
Stream je dynamický parametr, který poskytovatel souborového systému přidá do Add-Content. Thisparameter funguje pouze v souborových systémových jednotkách.
můžete použít Add-Content rutinu změnit obsah alternatedata stream, například Zone.Identifier. Nedoporučujeme to však jakozpůsob, jak eliminovat bezpečnostní kontroly, které blokují soubory, které jsou staženy zinternetu. Pokud ověříte, že stažený soubor je Bezpečný, použijte rutinuUnblock-File.
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. Zadejte citovaný řetězec, například tato data jsou určena pouze pro interní použití, nebo zadejte objekt, který obsahuje obsah, například objekt DateTime, který generuje Get-Date.
nemůžete zadat obsah souboru zadáním jeho cesty, protože cesta je pouze řetězec.Pomocí příkazu Get-Content můžete získat obsah a předat jej parametru Value.
| Typ: | Objektu |
| Poloha: | 1 |
| Výchozí hodnota: | None |
| Přijmout potrubí vstup: | 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 |
vstupy
systém.Objekt, Systém.Řízení.Automatizace.PSCredential
hodnoty potrubí, cesty nebo pověření můžete zadat do Set-Content.
výstupy
žádný nebo systém.Řetězec
při použití parametru PassThru vygeneruje Add-Content systém.Řetězec objekt, kterýpředstavuje obsah. V opačném případě tato rutina negeneruje žádný výstup.
Poznámky
- Když jste potrubí objekt
Add-Content, objekt je převeden na řetězec dříve, než je přidána do položky. Typ objektu určuje formát řetězce, ale formát se může lišit od výchozího zobrazení objektu. Chcete-li ovládat formát řetězce, použijte parametry formátováníodesílání rutiny. - můžete také odkazovat na
Add-Contentjeho vestavěným aliasem,ac. Pro více informací vizo_aliases. - rutina
Add-Contentje navržena pro práci s daty vystavenými jakýmkoli poskytovatelem. Chcete-li zobrazit seznam poskytovatelů dostupných ve vaší relaci, zadejteGet-PSProvider. Pro více informací vizo_providers.
- about_Aliases
- about_Providers
- Vymazat-Obsah
- Get-Obsah
- Položka
- Nová-Položka
- Nastavení-Obsahu