segédprogram kimenetet küld egy fájlba.
szintaxis
leírás
a Out-File
cmdlet kimenetet küld egy fájlba. Ez implicit módon használja PowerShell formázási rendszer towrite a fájlt. A fájl ugyanazt a megjelenítési ábrázolást kapja, mint a terminál. Ez azt jelenti, hogy a kimenet nem lehet ideális a programozott feldolgozáshoz, kivéve, ha az összes bemeneti objektum karakterlánc.,Ha meg kell adnia a kimenet paramétereit, használja a Out-File
parancsot az átirányítás helyettoperátor (>
). Az átirányítással kapcsolatos további információkért lásd: about_Redirection.
példák
1. példa: kimenet küldése és fájl létrehozása
Ez a példa megmutatja, hogyan küldhetünk el egy listát a helyi számítógép folyamatairól egy fájlba. Ha a fájl nem létezik, Out-File
létrehozza a fájlt a megadott útvonalon.
a Get-Process
cmdlet megkapja a helyi számítógépen futó folyamatok listáját., A Processobjects a Out-File
cmdlet-re kerül. Out-File
A Filepathparametert használja, majd létrehoz egy fájlt a Process nevű aktuális könyvtárban.txt. A Get-Content
parancs tartalmat kap a fájlból, majd megjeleníti azt a PowerShell konzolon.
2. példa: egy meglévő fájl felülírásának megakadályozása
Ez a példa megakadályozza a meglévő fájl felülírását. Alapértelmezés szerint a Out-File
felülírja meglévő fájlokat.,
a Get-Process
cmdlet megkapja a helyi számítógépen futó folyamatok listáját. A Processobjects a Out-File
cmdlet-re kerül. Out-File
A Filepathparametert használja, és megpróbál írni egy fájlba a Process nevű aktuális könyvtárban.txt. Ezután a clobber paraméter megakadályozza a fájl felülírását, majd egy üzenetet jelenít meg, hogy a fájl már létezik.
3. példa: kimenet küldése ASCII formátumú fájlba
Ez a példa bemutatja, hogyan kell kódolni a kimenetet egy adott kódolási típussal.,
$Procs = Get-ProcessOut-File -FilePath .\Process.txt -InputObject $Procs -Encoding ASCII -Width 50
a Get-Process
a cmdlet megkapja a helyi számítógépen futó folyamatok listáját. A Processobjects a $Procs
változóban van tárolva. Out-File
A FilePath paramétert használja, és a Process nevű aktuális könyvtárban hozza létre a fájlt.txt. Az InputObject paraméter átmegy aprocess objektumok $Procs
a fájl folyamat.txt. A kódolási paraméter átalakítja autput ASCII formátumba. A Width paraméter korlátozza minden sorban a fájl 50 karakter sosome ADATOK lehet csonka.,
4. példa: használj egy szolgáltatót és küldj kimenetet egy
fájlba ez a példa megmutatja, hogyan kell használni a Out-File
cmdlet, ha nem vagy egy fájlrendszer-providerdrive fájlban. Használja aGet-PSProvider
cmdlet a szolgáltatók megtekintéséhez a helyi számítógépen. További információért lásd: about_Providers.
aSet-Location
parancs a Path paramétert használja az aktuális hely beállításához a registryproviderAlias:
. A Get-Location
cmdlet megjeleníti a Alias:
teljes elérési útját.,Get-ChildItem
objektumok a Out-File
parancsmagra kerülnek. Out-File
a filePath paraméter segítségével adja meg a kimenet teljes elérési útját és fájlnevét,C:\TestDir\AliasNames.txt. AGet-Content
cmdlet az elérési út paramétert használja, a fájl tartalmát pedig a PowerShell konzolban jeleníti meg.
paraméterek
hozzáadja a kimenetet egy meglévő fájl végéhez.,
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
.,
a paraméter elfogadható értékei a következők:
ascii
: az ASCII (7 bites) karakterkészlet kódolását használja.-
bigendianunicode
: UTF-16 formátumban kódolja a big-endian byte sorrendet. -
bigendianutf32
: UTF-32 formátumban kódolja a big-endian byte sorrendet. -
oem
: az MS-DOS és konzolprogramok alapértelmezett kódolását használja. -
unicode
: kódolja UTF-16 formátumban a little-endian byte sorrendben., -
utf7
: kódolja UTF-7 formátumban. -
utf8
: kódolja UTF-8 formátumban. -
utf8BOM
: kódolja UTF-8 formátumban Byte rendelési jellel (BOM) -
utf32
: kódolja UTF-32 formátumban.
utf8NoBOM
: kódolja UTF-8 formátumban Byte rendelési jel (BOM) nélkül
kezdve PowerShell 6.,2, a kódolási paraméter lehetővé teszi a regisztrált kódlapok numerikus azonosítóit (például -Encoding 1251
) vagy a regisztrált kódoldalak karakterláncneveit (például-Encoding "windows-1251"
). További információért lásd a. net dokumentációjátkódolás.Kódfejtés.
Megjegyzés
UTF-7 * használata már nem ajánlott. A PowerShell 7.1-ben figyelmeztetést írunk, ha önadja meg autf7
kódolási paramétert.,
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.,
Típus: | SwitchParameter |
Beosztása: | Nevű |
Alapértelmezett érték: | Nem |
Elfogadni vezeték bemenet: | False |
Elfogadja a helyettesítő karaktereket: | False |
Megadja, hogy a tárgyak kell írni, hogy a fájlt. Adjon meg egy változót, amely tartalmazza az objektumokat vagy típustegy parancs vagy kifejezés, amely megkapja az objektumokat.,
Típus: | PSObject |
Beosztása: | Nevű |
Alapértelmezett érték: | Nem |
Elfogadni vezeték bemenet: | True |
Elfogadja a helyettesítő karaktereket: | False |
elérési útvonalát Határozza meg a kimeneti fájl. A LiteralPath paramétert pontosan úgy használják, ahogy be van írva.Helyettesítő karakterek nem fogadhatók el. Ha az útvonal menekülési karaktereket tartalmaz, csatolja azt singlequotation marks-ba., Az egyetlen idézőjelek azt mondják a Powershellnek, hogy ne értelmezzen semmilyen karaktert escapesequences-ként. További információ: 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., Alapértelmezés szerint, ha egy fájl létezik a megadott elérési útvonalon, a Out-File
felülírja a fájlotfigyelmeztetés nélkül.,
Típus: | SwitchParameter |
Álneve: | NoOverwrite |
Beosztása: | Nevű |
Alapértelmezett érték: | Nem |
Elfogadni vezeték bemenet: | False |
Elfogadja a helyettesítő karakterek használatát: | False |
Megadja, hogy a tartalom írva, hogy a fájl nem ér véget egy newline karakter. A bemeneti objektumok stringreprezentációi össze vannak kötve, hogy a kimenetet képezzék., A kimeneti karakterláncok között nincs szóköz vagy újsor. Az utolsó kimeneti karakterlánc után nem kerül hozzáadásra újsor.
Típus: | SwitchParameter |
Beosztása: | Nevű |
Alapértelmezett érték: | Nem |
Elfogadni vezeték bemenet: | False |
Elfogadja a helyettesítő karaktereket: | False |
azt Mutatja, hogy mi történne, ha a parancsmag fut. A cmdlet nem fut.,
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., Ha ezt a paramétert nem használják, akkor a szélességet a kiszolgáló jellemzői határozzák meg. A PowerShell konzol alapértelmezett értéke 80 karakter.
Típus: | Int32 | |
pozíció: | ||
alapértelmezett érték: | None | |
/td> | false | |
fogadja helyettesítő karakterek: | false |
bemenetek
PSObject
.,
kimenetek
nincs
Out-File
nem generál kimenetet.
Megjegyzések
A bemeneti objektumok automatikusan formázódnak, ahogy azok a terminálon lennének, de aFormat-*
cmdlet segítségével kifejezetten szabályozhatja a fájl kimenetének formázását. Például:Get-Date | Format-List | Out-File out.txt
a PowerShell parancs kimenetét a Out-File
cmdlet parancshoz használja a csővezetéket. Alternatív megoldásként tárolhatja az adatokat egy változóban, majd az InputObject paraméterrel továbbíthatja az adatokat a Out-File
cmdlet-nek.,
Out-File
adatokat ment egy fájlba, de nem hoz létre kimeneti objektumokat a csővezetékhez.
- about_Providers
- about_Quoting_Rules
- Out-Host
- Out-String
- Tee-Object
Out-Default
Out-Null
Vélemény, hozzászólás?