wysyła wyjście do pliku.
składnia
opis
Out-File cmdlet wysyła wyjście do pliku. Domyślnie używa systemu formatowania PowerShell towrite do pliku. Plik otrzymuje taką samą reprezentację wyświetlacza jak terminal. Oznacza to, że wyjście może nie być idealne do przetwarzania programowego, chyba że wszystkie obiekty wejściowe są ciągami znaków.,Gdy musisz podać parametry wyjścia, użyj Out-File zamiast redirectionoperator (>). Aby uzyskać więcej informacji na temat przekierowania, zobacz about_Redirection.
przykłady
przykład 1: Wyślij wyjście i utwórz plik
Ten przykład pokazuje, jak wysłać listę procesów lokalnego komputera do pliku. Jeśli plik nie istnieje,Out-File tworzy plik w podanej ścieżce.
Get-Process cmdlet pobiera listę procesów uruchomionych na komputerze lokalnym., Processobjects są wysyłane w dół potoku doOut-File cmdlet. Out-File używa parametru FilePathparameter i tworzy plik w bieżącym katalogu o nazwie proces.txt. PolecenieGet-Contentpobiera zawartość z pliku i wyświetla ją w konsoli PowerShell.
przykład 2: zapobiega nadpisywaniu istniejącego pliku
Ten przykład zapobiega nadpisywaniu istniejącego pliku. Domyślnie Out-File nadpisuje istniejące pliki.,
Get-Process cmdlet pobiera listę procesów uruchomionych na komputerze lokalnym. Processobjects są wysyłane w dół potoku doOut-File cmdlet. Out-File używa parametru FilePathparameter i próbuje zapisać plik w bieżącym katalogu o nazwie proces.txt. Parametr TheNoClobber zapobiega nadpisywaniu pliku i wyświetla komunikat, że plik już istnieje.
przykład 3: wysyłanie danych wyjściowych do pliku w formacie ASCII
Ten przykład pokazuje, jak kodować dane wyjściowe za pomocą określonego typu kodowania.,
$Procs = Get-ProcessOut-File -FilePath .\Process.txt -InputObject $Procs -Encoding ASCII -Width 50Get-Process cmdlet pobiera listę procesów uruchomionych na komputerze lokalnym. Processobjects są przechowywane w zmiennej $Procs. Out-File używa parametru FilePath i tworzy plik w bieżącym katalogu o nazwie proces.txt. Parametr InputObject przekazuje obiektprocess w $Procs do procesu plikowego.txt. Parametr Encoding konwertuje output do formatu ASCII. Parametr Width ogranicza każdą linię w pliku do 50 znaków.,
przykład 4: Użyj dostawcy i wyślij wyjście do pliku
Ten przykład pokazuje, jak używaćOut-File cmdlet, gdy nie jesteś w systemie plików providerdrive. Użyj cmdlet Get-PSProvider, aby wyświetlić dostawców na komputerze lokalnym. Więcej informacji można znaleźć w about_Providers.
Set-Location polecenie używa parametru Path, aby ustawić bieżącą lokalizację na registryproviderAlias:. Get-Location cmdlet wyświetla pełną ścieżkę dla Alias:.,Get-ChildItem wysyła obiekty w dół potoku do cmdletaOut-File. Out-File używa parametrufilepath do określenia pełnej ścieżki i nazwy pliku dla wyjścia,C:\TestDir\AliasNames.txt. Get-Content cmdlet używa parametru Path i wyświetla zawartość pliku w konsoli PowerShell.
parametry
dodaje wyjście na koniec istniejącego pliku.,
| 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 |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the type of encoding for the target file. The default value is utf8NoBOM.,
dopuszczalne wartości dla tego parametru są następujące:
-
ascii: używa kodowania dla zestawu znaków ASCII (7-bitowych). -
bigendianunicode: koduje w formacie UTF-16 przy użyciu porządku bajtów big-endian. -
bigendianutf32: koduje w formacie UTF-32 za pomocą porządku bajtów big-endian. -
oem: używa domyślnego kodowania dla programów MS-DOS i konsoli. -
unicode: koduje w formacie UTF-16 używając porządku bajtów little-endian., -
utf7: koduje w formacie UTF-7. -
utf8: koduje w formacie UTF-8. -
utf8BOM: kodowanie w formacie UTF-8 ze znakiem kolejności bajtów (BOM) -
utf8NoBOM: kodowanie w formacie UTF-8 bez znaku kolejności bajtów (BOM) -
utf32: koduje w formacie UTF-32.
zaczynając od PowerShell 6.,2, parametr kodowania umożliwia również numeryczne identyfikatory zarejestrowanych stron kodowych (takie jak -Encoding 1251) lub nazwy łańcuchów zarejestrowanych stron kodowych (takie jak-Encoding "windows-1251"). Aby uzyskać więcej informacji, zobacz dokumentację. NET do kodowania.Kod.
Uwaga
UTF-7* nie jest już zalecany do użycia. W PowerShell 7.1 ostrzeżenie jest zapisywane, jeśli określisz utf7 dla parametru kodowania.,
| Type: | Encoding |
| Accepted values: | ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
| Position: | 1 |
| Default value: | UTF8NoBOM |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the path to the output file.,
| Type: | String |
| Aliases: | Path |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Overrides the read-only attribute and overwrites an existing read-only file. The Force parameterdoes not override security restrictions.,
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | false |
| Akceptuj znaki wieloznaczne: | false |
określa obiekty, które mają być zapisane w pliku. Wprowadź zmienną zawierającą polecenie objects lub typea lub wyrażenie, które pobiera obiekty.,
| Type: | PSObject |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | true |
| accept wildcard characters: | false |
określa ścieżkę do pliku wyjściowego. Parametr LiteralPath jest używany dokładnie tak, jak jest wpisany.Znaki wieloznaczne nie są akceptowane. Jeśli ścieżka zawiera znaki specjalne, należy umieścić je w znakach cytowania., Pojedyncze cudzysłowy mówią Powershellowi, aby nie interpretował żadnych znaków jako sekwencji ucieczek. Aby uzyskać więcej informacji, zobacz about_Quoting_Rules.,
| Type: | String |
| Aliases: | PSPath, LP |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
NoClobber prevents an existing file from being overwritten and displays a message that the filealready exists., Domyślnie, jeśli plik istnieje w podanej ścieżce, Out-File nadpisuje Ostrzeżenie filewithout.,
| Type: | SwitchParameter |
| Aliases: | NoOverwrite |
| Position: | Named |
| Default value: | None |
| accept pipeline input: | false | accept wildcard characters: | false |
określa, że zawartość zapisana do pliku nie kończy się znakiem nowej linii. Stringrepresentations obiektów wejściowych są łączone w celu utworzenia wyjścia., Pomiędzy wyjściowymi ciągami nie są wstawiane spacje ani znaki nowego wiersza. Po ostatnim ciągu wyjściowym nie jest dodawany nowy wiersz.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | false |
| accept wildcard characters: | false |
pokazuje, co się stanie, jeśli cmdlet zostanie uruchomiony. Cmdlet nie jest uruchomiony.,
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the number of characters in each line of output. Any additional characters are truncated,not wrapped., Jeśli ten parametr nie jest używany, szerokość jest określona przez charakterystykę hosta. Domyślną wartością dla konsoli PowerShell jest 80 znaków.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | false |
| Akceptuj znaki wieloznaczne: | false |
wejścia
PSObject
możesz przesłać dowolny obiekt do Out-File.,
wyjścia
brak
Out-File nie generuje żadnego wyjścia.
uwagi
Obiekty wejściowe są automatycznie formatowane tak, jak w terminalu, ale możesz użyćFormat-* cmdlet, aby jawnie kontrolować formatowanie wyjścia do pliku. Na przykładGet-Date | Format-List | Out-File out.txt
aby wysłać polecenie PowerShell do cmdleta Out-File, użyj potoku. Alternatywnie można zapisać dane w zmiennej i użyć parametru InputObject, aby przekazać dane doOut-Filecmdlet.,
Out-File zapisuje dane do pliku, ale nie tworzy żadnych obiektów wyjściowych do potoku.
- about_Providers
- about_Quoting_Rules
- Out-Default
- Out-Host
- Out-null
- Out-String
- Tee-Object
Dodaj komentarz