Share via

Start-Transcript

  • Referensi
Modul:
Microsoft.PowerShell.Host

Membuat rekaman semua atau sebagian sesi PowerShell ke file teks.

Sintaks

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>]

Deskripsi

Start-Transcript Cmdlet membuat rekaman dari semua atau sebagian sesi PowerShell ke file teks. Transkrip mencakup semua perintah yang jenis pengguna dan semua output yang muncul di konsol.

Secara default, Start-Transcript menyimpan transkrip di lokasi berikut menggunakan nama default:

  • Pada Windows: $HOME\Documents
  • Di Linux atau macOS: $HOME

Nama file default adalah PowerShell_transcript.<computername>.<random>.<timestamp>.txt.

Mulai dari Windows PowerShell 5.0, Start-Transcript menyertakan nama host dalam nama file yang dihasilkan dari semua transkrip. Nama file juga menyertakan karakter acak dalam nama untuk mencegah potensi penimpaan atau duplikasi saat Anda memulai dua atau beberapa transkrip secara bersamaan. Menyertakan nama komputer berguna jika Anda menyimpan transkrip di lokasi terpusat. String karakter acak mencegah tebakan nama file untuk mendapatkan akses tidak sah ke file.

Jika file target tidak memiliki Tanda Urutan Byte (BOM), Start-Transcript default ke Utf8NoBom pengodean dalam file target.

Contoh

Contoh 1: Memulai file transkrip dengan pengaturan default

Start-Transcript

Perintah ini memulai transkrip di lokasi file default.

Contoh 2: Memulai file transkrip di lokasi tertentu

Start-Transcript -Path "C:\transcripts\transcript0.txt" -NoClobber

Perintah ini memulai transkrip dalam Transcript0.txt file di C:\transcripts. Parameter NoClobber mencegah file yang ada ditimpa. Transcript0.txt Jika file sudah ada, perintah gagal.

Contoh 3: Memulai file transkrip dengan nama unik dan menyimpannya di berbagi file

Contoh berikut membuat file transkrip dengan nama yang cukup unik untuk disimpan di lokasi bersama. Nama file dibuat dari nama pengguna, nama host komputer yang menjalankan PowerShell, versi PowerShell, dan tanggal dan waktu. Transkrip disimpan dalam \\Server01\Transcripts berbagi file.

$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

Jalur lengkap ke file transkrip disimpan dalam $Transcript variabel preferensi. Untuk informasi selengkapnya tentang $Transcript variabel preferensi, lihat about_Preference_Variables.

Parameter

-Append

Menunjukkan bahwa cmdlet ini menambahkan transkrip baru ke akhir file yang ada. Gunakan parameter Jalur untuk menentukan file.

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

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-Force

Memungkinkan cmdlet untuk menambahkan transkrip ke file baca-saja yang ada. Saat digunakan pada file baca-saja, cmdlet mengubah izin file menjadi baca-tulis. Cmdlet tidak dapat mengambil alih pembatasan keamanan saat parameter ini digunakan.

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

-IncludeInvocationHeader

Menunjukkan bahwa cmdlet ini mencatat stempel waktu saat perintah dijalankan.

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

-LiteralPath

Menentukan lokasi ke file transkrip. Tidak seperti parameter Jalur, nilai parameter LiteralPath digunakan persis seperti yang ditik. Tidak ada karakter yang ditafsirkan sebagai kartubebas. Jika jalur menyertakan karakter escape, sertakan dalam tanda kutip tunggal. Tanda kutip tunggal memberi tahu PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai urutan escape.

Type:String
Aliases:PSPath, LP
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoClobber

Menunjukkan bahwa cmdlet ini tidak menimpa file yang ada. Secara default, jika file transkrip ada di jalur yang ditentukan, Start-Transcript timpa file tanpa peringatan.

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

-OutputDirectory

Menentukan jalur dan folder tertentu untuk menyimpan transkrip. PowerShell secara otomatis menetapkan nama transkrip.

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

-Path

Menentukan lokasi ke file transkrip. Masukkan jalur ke .txt file. Kartubebas tidak diizinkan. Jika salah satu direktori di jalur tidak ada, perintah gagal.

Jika Anda tidak menentukan jalur, Start-Transcript gunakan jalur dalam nilai $Transcript variabel global. Jika Anda belum membuat variabel ini, Start-Transcript simpan transkrip di lokasi default dan nama file.

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

-UseMinimalHeader

Tambahkan header pendek ke transkrip, alih-alih header terperinci yang disertakan secara default. Parameter ini ditambahkan di PowerShell 6.2.

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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

String

Cmdlet ini mengembalikan string yang berisi pesan konfirmasi dan jalur ke file output.

Catatan

Untuk menghentikan transkrip, gunakan Stop-Transcript cmdlet.

Untuk merekam seluruh sesi, tambahkan perintah ke Start-Transcript profil Anda. Untuk informasi selengkapnya, lihat about_Profiles.