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

cmdlet Start-Transcript membuat rekaman 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 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 pengodean Utf8NoBom 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 file Transcript0.txt di C:\transcripts. parameter NoClobber mencegah file yang ada ditimpa. Jika file Transcript0.txt 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 berbagi file \\Server01\Transcripts.

$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).ToString()
Start-Transcript

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

Parameter

-Append

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

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Jenis:	SwitchParameter
Alias:	cf
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	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.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-IncludeInvocationHeader

Menunjukkan bahwa cmdlet ini mencatat stempel waktu saat perintah dijalankan.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	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.

Jenis:	String
Alias:	PSPath, LP
Position:	0
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-NoClobber

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

Jenis:	SwitchParameter
Alias:	NoOverwrite
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-OutputDirectory

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

Jenis:	String
Position:	0
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Path

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

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

Jenis:	String
Position:	0
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-UseMinimalHeader

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

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-WhatIf

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

Jenis:	SwitchParameter
Alias:	wi
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	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 cmdlet Stop-Transcript.

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

Bagikan melalui