odešle výstup do souboru.
Syntax
popis
Out-File cmdlet odešle výstup do souboru. Implicitně používá formátovací systém PowerShell towrite do souboru. Soubor obdrží stejnou reprezentaci zobrazení jako terminál. To znamená, že výstup nemusí být ideální pro programové zpracování, pokud nejsou všechny vstupní objekty řetězce.,Pokud potřebujete zadat parametry výstupu, použijte Out-File spíše než přesměrování (>). Pro více informací o přesměrování, viz about_Redirection.
příklady
Příklad 1: Odeslat výstup a vytvořit soubor
tento příklad ukazuje, jak odeslat seznam procesů místního počítače do souboru. Pokud soubor neexistuje, Out-File vytvoří soubor v zadané cestě.
Get-Process cmdlet získá seznam procesů běžících v místním počítači., Procesobjekty jsou odesílány potrubím doOut-File cmdlet. Out-File používá FilePathparameter a vytvoří soubor v aktuálním adresáři s názvem Proces.txt. Příkaz Get-Contentzíská obsah ze souboru a zobrazí jej v konzole PowerShell.
příklad 2: zabraňte přepsání existujícího souboru
tento příklad zabraňuje přepsání existujícího souboru. Ve výchozím nastavení Out-File přepsatexistující soubory.,
Get-Process cmdlet získá seznam procesů běžících v místním počítači. Procesobjekty jsou odesílány potrubím doOut-File cmdlet. Out-File používá FilePathparameter a pokouší se zapsat do souboru v aktuálním adresáři s názvem Process.txt. Parametr TheNoClobber zabraňuje přepsání souboru a zobrazí zprávu, že soubor již existuje.
příklad 3: Odeslat výstup do souboru ve formátu ASCII
tento příklad ukazuje, jak kódovat výstup specifickým typem kódování.,
$Procs = Get-ProcessOut-File -FilePath .\Process.txt -InputObject $Procs -Encoding ASCII -Width 50Get-Process cmdlet získá seznam procesů běžících v místním počítači. Procesobjekty jsou uloženy v proměnné $Procs. Out-File používá parametr FilePath a vytváří soubor v aktuálním adresáři s názvem Process.txt. Parametr InputObject předáváproces objektů v $Procs do procesu souboru.txt. Parametr kódování převádívýstup do formátu ASCII. Parametr šířka omezuje každý řádek v souboru na 50 znaků sosome data mohou být zkrácena.,
příklad 4: Použijte poskytovatele a odešlete výstup do souboru
tento příklad ukazuje, jak používatOut-File cmdlet, když nejste v poskytovateli souborového systému. PomocíGet-PSProvider cmdlet zobrazte poskytovatele v místním počítači. Další informace naleznete v části about_Providers.
příkazSet-Location používá parametr Path k nastavení aktuálního umístění na registryprovider Alias:. Get-Location cmdlet zobrazuje úplnou cestu pro Alias:.,Get-ChildItem odesílá objekty po potrubí do Out-File cmdlet. Out-File používá parametr theFilePath k určení úplné cesty a názvu souboru pro výstup,C:\TestDir\AliasNames.txt. Get-Content cmdlet používá parametr cesta a zobrazuje obsah souboru v konzole PowerShell.
Parametry
Přidá výstup na konec existujícího souboru.,
| 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.,
přípustné hodnoty pro tento parametr jsou následující:
-
ascii: Používá kódování ASCII (7-bit) znakovou sadu. -
bigendianunicode: kóduje ve formátu UTF-16 pomocí příkazu big-endian byte. -
bigendianutf32: kóduje ve formátu UTF-32 pomocí příkazu big-endian byte. -
oem: používá výchozí kódování pro programy MS-DOS a konzoly. -
unicode: kóduje ve formátu UTF-16 pomocí příkazu little-endian byte., -
utf7: kóduje ve formátu UTF-7. -
utf8: kóduje 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.
začínající 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. NETKÓDOVÁNÍ.kódování.
Poznámka
UTF-7 * se již nedoporučuje používat. V PowerShell 7.1 je napsáno varování, pokud jste vyspecifyutf7 pro parametr kódování.,
| 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.,
| Typ: | SwitchParameter |
| Poloha: | Jménem |
| Výchozí hodnota: | None |
| Přijmout potrubí vstup: | False |
| použít zástupné znaky: | False |
Určuje objekty, které mají být zapsány do souboru. Zadejte proměnnou, která obsahuje objekty nebo typpřik nebo výraz, který dostane objekty.,
| Typ: | PSObject |
| Poloha: | Jménem |
| Výchozí hodnota: | None |
| Přijmout potrubí vstup: | True |
| použít zástupné znaky: | False |
Určuje cestu k výstupnímu souboru. Parametr LiteralPath se používá přesně tak, jak je napsán.Zástupné znaky nejsou akceptovány. Pokud cesta obsahuje únikové znaky, uzavřete ji do singlequotation značek., Jednotlivé uvozovky říkají PowerShell, aby interpretovat žádné znaky jako escapesequences. Pro více informací viz 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., Ve výchozím nastavení, pokud existuje soubor v zadané cestě, Out-File přepíše souborbez varování.,
| Typ: | SwitchParameter |
| Aliasů: | NoOverwrite |
| Poloha: | Jménem |
| Výchozí hodnota: | None |
| Přijmout potrubí vstup: | False |
| použít zástupné znaky: | False |
Určuje, že obsah zapsány do soubor nekončí znakem nového řádku. Stringreprezentace vstupních objektů jsou zřetězeny pro vytvoření výstupu., Mezi výstupními řetězci nejsou žádné mezery ani nové řádky. 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 |
Ukazuje, co by se stalo, kdyby rutiny běží. Cmdlet není spuštěn.,
| 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., Pokud se tento parametr nepoužívá, šířka je určena charakteristikamihost. Výchozí hodnota konzoly PowerShell je 80 znaků.
| Typ: | Int32 |
| Poloha: | Jménem |
| Výchozí hodnota: | None |
| Přijmout potrubí vstup: | False |
| použít zástupné znaky: | False |
Vstupy
PSObject
můžete potrubí jakýkoli objekt Out-File.,
výstupy
Žádný
Out-File nevytváří žádný výstup.
Poznámky
Vstupní objekty jsou automaticky formátovány tak, jak by být v terminálu, ale můžete použítFormat-* cmdlet explicitně ovládat formátování výstupního souboru. NapříkladGet-Date | Format-List | Out-File out.txt
pro odeslání výstupu příkazu PowerShell na Out-File cmdlet použijte potrubí. Případně můžete ukládat data do proměnné a pomocí parametru InputObject předávat data doOut-Filecmdlet.,
Out-File ukládá data do souboru, ale nevytváří žádné výstupní objekty do potrubí.
- about_Providers
- about_Quoting_Rules
- Výchozí
- Host
- Out-Null
- -Řetězec
- Tee-Object
Napsat komentář