Start-Transcript
Membuat rekaman semua atau sebagian sesi PowerShell ke file teks.
Sintaks
ByPath (Default)
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>]
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
Start-Transcript
Jalur lengkap ke file transkrip disimpan dalam variabel preferensi $Transcript. Untuk informasi selengkapnya tentang variabel preferensi $Transcript, lihat about_Preference_Variables.
Contoh 4: Memulai transkrip menggunakan jalur relatif pada sistem Windows
Saat Anda menggunakan jalur relatif dengan parameter OutputDirectory di Windows, jalur relatif terhadap direktori Anda Documents .
Start-Transcript -Path .\transcripts
Transcript started, output file is C:\Users\username\Documents\.\transcripts\PowerShell_transcript.HOSTNAME.8S6RpEfN.20251105152247.txt
Contoh 5: Memulai transkrip menggunakan jalur relatif pada sistem non-Windows
Saat Anda menggunakan jalur relatif dengan parameter OutputDirectory pada sistem non-Windows, jalur relatif terhadap direktori beranda Anda.
Start-Transcript -Path ./transcripts
Transcript started, output file is /home/username/./transcripts/PowerShell_transcript.hostname.ift21QeV.20251105151236.txt
Parameter
-Append
Menunjukkan bahwa cmdlet ini menambahkan transkrip baru ke akhir file yang ada. Gunakan parameter Jalur
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | Cf |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | 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.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-IncludeInvocationHeader
Menunjukkan bahwa cmdlet ini mencatat stempel waktu saat perintah dijalankan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | 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 wildcard. Jika jalur menyertakan karakter escape, bungkus jalur tersebut dalam tanda kutip tunggal. Tanda kutip tunggal memberi tahu PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai urutan escape.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | PSPath, LP |
Kumpulan parameter
ByLiteralPath
| Position: | 0 |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | 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.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | NoOverwrite |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-OutputDirectory
Menentukan jalur dan folder tertentu untuk menyimpan transkrip. PowerShell secara otomatis menetapkan nama transkrip. Jika Anda menggunakan jalur relatif, jalur relatif terhadap direktori Anda Documents di Windows. Di Linux dan macOS, jalurnya relatif terhadap direktori beranda Anda.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
ByOutputDirectory
| Position: | 0 |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Path
Menentukan lokasi ke file transkrip. Masukkan jalur ke file .txt. Karakter pengganti 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.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
ByPath
| Position: | 0 |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-UseMinimalHeader
Tambahkan header pendek ke transkrip, alih-alih header terperinci yang disertakan secara default. Parameter ini ditambahkan di PowerShell 6.2.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-WhatIf
Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | wi |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
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.
