Megosztás a következőn keresztül:

Start-Transcript

  • Referencia
Modul:
Microsoft.PowerShell.Host

Egy PowerShell-munkamenet egészének vagy egy részének rekordját hozza létre egy szövegfájlba.

Syntax

Start-Transcript
     [[-Path] <String>]
     [-Append]
     [-Force]
     [-NoClobber]
     [-IncludeInvocationHeader]
     [-UseMinimalHeader]
     [-WhatIf]
     [-Confirm] 
     [<CommonParameters>]
Start-Transcript
     [[-LiteralPath] <String>]
     [-Append]
     [-Force]
     [-NoClobber]
     [-IncludeInvocationHeader]
     [-UseMinimalHeader]
     [-WhatIf]
     [-Confirm] 
     [<CommonParameters>]
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 a következő PowerShell_transcript.<computername>.<random>.<timestamp>.txt: .

A Windows PowerShell 5.0-tól Start-Transcript kezdve az összes átirat generált fájlnevében szerepel a gazdagép neve. 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 byte order mark (BOM) jelöléssel, Start-Transcript a célfájlban alapértelmezés szerint kódolást kell Utf8NoBom használni.

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 fájlban a Transcript0.txt következőben C:\transcripts: . A 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 átirat a \\Server01\Transcripts fájlmegosztásban van tárolva.

$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 beállítási változóval kapcsolatos további információkért $Transcript lásd : about_Preference_Variables.

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 az Elérési út paramétert.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeInvocationHeader

Azt jelzi, hogy ez a parancsmag naplózza az időbélyeget a parancsok futtatásakor.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LiteralPath

Megadja az átiratfájl helyét. Az Elérési út 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 út tartalmaz escape karaktereket, csatolja egy 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.

Type:String
Aliases:PSPath, LP
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Aliases:NoOverwrite
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Megadja az átiratfájl helyét. Adjon meg egy fájl elérési útját .txt . 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.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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 parancsot a Start-Transcript profiljához. További információ: about_Profiles.