składnia

Add-Content <string> <Object> >] >] 

Add-Content <Object> -LiteralPath <string> >] >] 

opis

Add-Content cmdlet dołącza zawartość do określonego elementu lub pliku. Możesz określić zawartość wpisując zawartość w poleceniu lub określając obiekt, który zawiera zawartość.

Jeśli chcesz utworzyć pliki lub katalogi dla poniższych przykładów, zobacz New-Item.

przykłady

przykład 1: Dodaj łańcuch znaków do wszystkich plików tekstowych z wyjątkiem

Ten przykład dodaje wartość do plików tekstowych w bieżącym katalogu, ale wyklucza pliki oparte na ich nazwie pliku.

Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'

parametr Path określa wszystkie pliki.txt w bieżącym katalogu, ale Excludeparameter ignoruje nazwy plików pasujące do podanego wzorca. Parametr Value określa ciąg tekstowy, który jest zapisywany do plików.

przykład 2: Dodaj datę na końcu określonych plików

Ten przykład dołącza datę do plików w bieżącym katalogu i wyświetla datę w konsoli powłoki.

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

polecenie poleceniaAdd-Content tworzy dwa nowe pliki w bieżącym katalogu. Parametr Value zawiera wyjście poleceniaGet-Date. Parametr PassThru wyprowadza dodaną zawartość do potoku.Ponieważ nie ma innego cmdleta do odbioru wyjścia, jest on wyświetlany w konsoli PowerShell.Polecenie poleceniaGet-Content wyświetla zaktualizowany plik,DateTimeFile1.log.

przykład 3: Dodaj zawartość podanego pliku do innego pliku

Ten przykład pobiera zawartość z pliku i przechowuje ją w zmiennej. Zmienna służy do dołączenia zawartości do innego pliku.

$From = Get-Content -Path .\CopyFromFile.txtAdd-Content -Path .\CopyToFile.txt -Value $FromGet-Content -Path .\CopyToFile.txt

• polecenie cmdletGet-Content pobiera zawartośćCopyFromFile.txt I zapisuje zawartość w zmiennej$From.
• polecenie poleceniaAdd-Content aktualizuje plikCopyToFile.txt używając zawartości zmiennej$From.
• Get-Content cmdlet wyświetla plik CopyToFile.txt.

przykład 4: Dodaj zawartość podanego pliku do innego pliku za pomocą potoku

Ten przykład pobiera zawartość z pliku i kieruje ją do poleceniaAdd-Content.

Get-Content -Path .\CopyFromFile.txt | Add-Content -Path .\CopyToFile.txtGet-Content -Path .\CopyToFile.txt

Get-Content cmdlet pobiera zawartośćCopyFromFile.txt. Wyniki są przesyłane do poleceniaAdd-Content, który aktualizujeCopyToFile.txt.OstatniGet-Content cmdlet wyświetlaCopyToFile.txt.

przykład 5: Utwórz nowy plik i skopiuj zawartość

Ten przykład tworzy nowy plik i kopiuje zawartość istniejącego pliku do nowego pliku.

Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)Get-Content -Path .\NewFile.txt

• polecenie poleceniaAdd-Content używa parametrów ścieżki i wartości do utworzenia nowego pliku w bieżącym katalogu.
• Get-Content cmdlet pobiera zawartość istniejącego pliku,CopyFromFile.txtI przekazuje go do parametru Value. Nawiasy wokół poleceniaGet-Content zapewniają, że polecenie kończy się przed rozpoczęciem polecenia Add-Content.
• polecenie poleceniaGet-Content wyświetla zawartość nowego pliku,NewFile.txt.

przykład 6: Dodaj zawartość do pliku Tylko do odczytu

To polecenie dodaje wartość do pliku, nawet jeśli atrybut IsReadOnly file jest ustawiony na True.Kroki tworzenia pliku Tylko do odczytu są zawarte w przykładzie.

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

• polecenie cmdletNew-Item używa parametrów Path i ItemType do utworzenia plikuIsReadOnlyTextFile.txt w bieżącym katalogu.
• polecenie poleceniaSet-ItemProperty używa parametrów Nazwa i wartość, aby zmienić właściwość file ’ sisreadonly na True.
• polecenie poleceniaGet-ChildItem pokazuje, że plik jest pusty (0) i ma atrybut Tylko do odczytu (r).
• polecenie poleceniaAdd-Content używa parametru Path do określenia pliku. Parametr Value zawiera łańcuch tekstowy, który ma być dołączony do pliku. Parametr Force zapisuje tekst do pliku tylko dla użytkownika.
• polecenie poleceniaGet-Content używa parametru Path do wyświetlenia zawartości pliku.

aby usunąć atrybut Tylko do odczytu, użyj poleceniaSet-ItemProperty z parametrami wartości naFalse.

przykład 7: Użyj filtrów Z Add-Content

możesz określić filtr do poleceniaAdd-Content. Podczas używania filtrów do zakwalifikowania parametru ścieżki należy dołączyć końcową gwiazdkę (*), aby wskazać zawartość ścieżki.

poniższe polecenie dodaje słowo „gotowe” do zawartości wszystkich plików*.txt w kataloguC:\Temp.

Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"

parametry

wejścia

System.Obiekt, System.Zarządzanie.Automatyzacja.PSCredential

możesz podać wartości, ścieżki lub poświadczenia doSet-Content.

wyjścia

brak lub System.String

Gdy używasz parametru PassThru, Add-Content generuje System.Obiekt String, który przedstawia zawartość. W przeciwnym razie, ten cmdlet nie generuje żadnych danych wyjściowych.

uwagi

• podczas wprowadzania obiektu do Add-Content obiekt jest konwertowany na łańcuch znaków przed dodaniem go do elementu. Typ obiektu określa format ciągu znaków, ale format może być inny niż domyślne wyświetlanie obiektu. Aby sterować formatem łańcucha znaków, użyj parametrów formatowania tego cmdleta.
• Możesz również odwołać się doAdd-Content poprzez wbudowany alias,ac. Aby uzyskać więcej informacji, zobaczabout_aliases.
• polecenie poleceniaAdd-Content jest przeznaczone do pracy z danymi ujawnionymi przez dowolnego dostawcę. Aby wyświetlić listę programów dostępnych w twojej sesji, wpisz Get-PSProvider. Aby uzyskać więcej informacji, zobaczabout_providers.

• o_aliases
• o_providers
• Clear-Content
• Get-Content
• Get-Item
• New-Item
• Set-Content