Start-Transcript
Egy PowerShell-munkamenet egészének vagy egy részének rekordját hozza létre egy szövegfájlba.
Syntax
ByPath (Alapértelmezett)
Start-Transcript
[[-Path] <String>]
[-Append]
[-Force]
[-NoClobber]
[-IncludeInvocationHeader]
[-UseMinimalHeader]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByLiteralPath
Start-Transcript
[[-LiteralPath] <String>]
[-Append]
[-Force]
[-NoClobber]
[-IncludeInvocationHeader]
[-UseMinimalHeader]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByOutputDirectory
Start-Transcript
[[-OutputDirectory] <String>]
[-Append]
[-Force]
[-NoClobber]
[-IncludeInvocationHeader]
[-UseMinimalHeader]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Start-Transcript parancsmag egy PowerShell-munkamenet egészének vagy egy részének rekordját hozza létre egy szövegfájlba. Az átirat tartalmazza a felhasználó által a konzolon megjelenő összes parancsot és kimenetet.
Alapértelmezés szerint Start-Transcript az átiratot az alábbi helyen tárolja az alapértelmezett névvel:
- Windows rendszeren:
$HOME\Documents - Linux vagy macOS rendszeren:
$HOME
Az alapértelmezett fájlnév PowerShell_transcript.<computername>.<random>.<timestamp>.txt.
A Windows PowerShell 5.0-tól kezdve Start-Transcript tartalmazza az összes átirat generált fájlnevében a gazdagépnevet. A fájlnév véletlenszerű karaktereket is tartalmaz a nevekben, hogy megakadályozza a lehetséges felülírásokat vagy duplikációkat két vagy több átirat egyidejű indításakor. A számítógép nevének megadása akkor hasznos, ha az átiratokat központi helyen tárolja. A véletlenszerű karaktersztring megakadályozza a fájlnév találgatását, hogy jogosulatlan hozzáférést kapjon a fájlhoz.
Ha a célfájl nem rendelkezik bájtsorrendjellel (BOM), Start-Transcript alapértelmezés szerint Utf8NoBom kódolást a célfájlban.
Példák
1. példa: Átiratfájl indítása alapértelmezett beállításokkal
Start-Transcript
Ez a parancs elindít egy átiratot az alapértelmezett fájlhelyen.
2. példa: Átiratfájl indítása egy adott helyen
Start-Transcript -Path "C:\transcripts\transcript0.txt" -NoClobber
Ez a parancs elindít egy átiratot a Transcript0.txtC:\transcripts fájljában.
NoClobber paraméter megakadályozza a meglévő fájlok felülírását. Ha a Transcript0.txt fájl már létezik, a parancs meghiúsul.
3. példa: Átiratfájl indítása egyedi névvel, és fájlmegosztásban tárolva
Az alábbi példa egy olyan átiratfájlt hoz létre, amelynek neve elég egyedi ahhoz, hogy egy megosztott helyen tárolva legyen. A fájlnév a felhasználó nevéből, a PowerShellt futtató számítógép gazdagépnevéből, a PowerShell verziójából, valamint a dátumból és időből jön létre. Az átiratot a \\Server01\Transcripts fájlmegosztás tárolja.
$sharePath = '\\Server01\Transcripts'
$username = $Env:USERNAME
$hostname = hostname
$version = $PSVersionTable.PSVersion.ToString()
$datetime = Get-Date -F 'yyyyMMddHHmmss'
$filename = "Transcript-${username}-${hostname}-${version}-${datetime}.txt"
$Transcript = Join-Path -Path $sharePath -ChildPath $filename
Start-Transcript
Az átiratfájl teljes elérési útja a $Transcript beállítási változóban lesz tárolva. A $Transcript beállítási változóval kapcsolatos további információkért lásd: about_Preference_Variables.
4. példa: Átirat indítása relatív elérési út használatával Windows-rendszereken
Ha relatív elérési utat használ a Windows OutputDirectory paraméterével, az elérési út a Documents címtárhoz képest van.
Start-Transcript -Path .\transcripts
Transcript started, output file is C:\Users\username\Documents\.\transcripts\PowerShell_transcript.HOSTNAME.8S6RpEfN.20251105152247.txt
5. példa: Átirat indítása nem Windows rendszerű rendszerek relatív elérési útján
Ha relatív elérési utat használ az OutputDirectory paraméterrel a nem Windows rendszerű rendszereken, az elérési út a kezdőkönyvtárhoz képest van.
Start-Transcript -Path ./transcripts
Transcript started, output file is /home/username/./transcripts/PowerShell_transcript.hostname.ift21QeV.20251105151236.txt
Paraméterek
-Append
Azt jelzi, hogy ez a parancsmag hozzáadja az új átiratot egy meglévő fájl végéhez. A fájl megadásához használja a Elérési út paramétert.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Force
Lehetővé teszi, hogy a parancsmag hozzáfűzze az átiratot egy meglévő írásvédett fájlhoz. Ha írásvédett fájlon használják, a parancsmag írás-olvasásra módosítja a fájlengedélyt. A parancsmag nem tudja felülbírálni a biztonsági korlátozásokat a paraméter használatakor.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-IncludeInvocationHeader
Azt jelzi, hogy ez a parancsmag naplózza az időbélyeget a parancsok futtatásakor.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-LiteralPath
Megadja az átiratfájl helyét. A Path paramétertől eltérően a LiteralPath paraméter értéke pontosan a beírt módon lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési útvonal escape karaktereket tartalmaz, tedd azt egyes idézőjelek közé. Az önálló idézőjelek tájékoztatják a PowerShellt, hogy ne értelmezze a karaktereket feloldósorozatként.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | PSPath, LP |
Paraméterkészletek
ByLiteralPath
| Position: | 0 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-NoClobber
Azt jelzi, hogy ez a parancsmag nem írja felül a meglévő fájlokat. Alapértelmezés szerint, ha egy átiratfájl található a megadott elérési úton, Start-Transcript figyelmeztetés nélkül felülírja a fájlt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | NoOverwrite |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-OutputDirectory
Egy adott elérési utat és mappát határoz meg, amelybe átiratot szeretne menteni. A PowerShell automatikusan hozzárendeli az átirat nevét. Ha relatív elérési utat használ, az elérési út a Windows címtárához Documents képest van. Linux és macOS rendszeren az elérési út a kezdőkönyvtárhoz képest van.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ByOutputDirectory
| Position: | 0 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Path
Megadja az átiratfájl helyét. Adjon meg egy .txt fájl elérési útját. A helyettesítő karakterek használata nem engedélyezett. Ha az elérési út bármelyik könyvtára nem létezik, a parancs meghiúsul.
Ha nem ad meg elérési utat, Start-Transcript az elérési utat használja a $Transcript globális változó értékében. Ha még nem hozta létre ezt a változót, Start-Transcript az átiratokat az alapértelmezett helyen és fájlnévben tárolja.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ByPath
| Position: | 0 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-UseMinimalHeader
Az alapértelmezett részletes fejléc helyett egy rövid fejlécet kell előre felerősíteni az átiratra. Ez a paraméter a PowerShell 6.2-ben lett hozzáadva.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsprogram nem lett futtatva.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
None
Ehhez a parancsmaghoz nem lehet objektumokat csövezni.
Kimenetek
String
Ez a parancsmag egy megerősítő üzenetet és a kimeneti fájl elérési útját tartalmazó sztringet ad vissza.
Jegyzetek
Az átirat leállításához használja a Stop-Transcript parancsmagot.
Egy teljes munkamenet rögzítéséhez adja hozzá a Start-Transcript parancsot a profiljához. További információért lásd: about_Profiles.
