Start-Transcript
PowerShell oturumunun tümünün veya bir bölümünün kaydını bir metin dosyasına oluşturur.
Syntax
ByPath (Varsayılan)
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
Start-Transcript cmdlet'i, PowerShell oturumunun tümünün veya bir bölümünün kaydını bir metin dosyasına oluşturur. Transkript, kullanıcının türüne göre tüm komutu ve konsolunda görüntülenen tüm çıkışı içerir.
Varsayılan olarak, Start-Transcript transkripti varsayılan adı kullanarak aşağıdaki konumda depolar:
- Windows'da:
$HOME\Documents - Linux veya macOS'ta:
$HOME
Varsayılan dosya adı PowerShell_transcript.<computername>.<random>.<timestamp>.txt.
Windows PowerShell 5.0'dan başlayarak, Start-Transcript tüm transkriptlerin oluşturulan dosya adına ana bilgisayar adını içerir. Dosya adı, aynı anda iki veya daha fazla transkript başlattığınızda olası üzerine yazma veya yinelemeleri önlemek için adlarda rastgele karakterler de içerir. Transkriptlerinizi merkezi bir konumda depolarsanız bilgisayar adını dahil edin. Rastgele karakter dizesi, dosyaya yetkisiz erişim kazanmak için dosya adının tahmin edilmesini engeller.
Hedef dosyada Bayt Sırası İşareti (BOM) yoksa, hedef dosyada varsayılan olarak Start-Transcript kodlama Utf8NoBom.
Örnekler
Örnek 1: Varsayılan ayarlarla transkript dosyası başlatma
Start-Transcript
Bu komut, varsayılan dosya konumunda bir transkript başlatır.
Örnek 2: Belirli bir konumda transkript dosyası başlatma
Start-Transcript -Path "C:\transcripts\transcript0.txt" -NoClobber
Bu komut, Transcript0.txtC:\transcripts dosyasında bir transkript başlatır.
NoClobber parametresi var olan dosyaların üzerine yazılmasını engeller.
Transcript0.txt dosyası zaten varsa, komut başarısız olur.
Örnek 3: Benzersiz bir adla transkript dosyası başlatma ve dosya paylaşımında depolama
Aşağıdaki örnek, paylaşılan bir konumda depolanacak kadar benzersiz bir ada sahip bir transkript dosyası oluşturur. Dosya adı kullanıcının adından, PowerShell çalıştıran bilgisayarın ana bilgisayar adından, PowerShell sürümünden ve tarih ve saatten oluşturulur. Transkript \\Server01\Transcripts dosya paylaşımında depolanır.
$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
Transkript dosyasının tam yolu $Transcript tercih değişkeninde depolanır.
$Transcript tercih değişkeni hakkında daha fazla bilgi için bkz. about_Preference_Variables.
Örnek 4: Windows sistemlerinde göreli yol kullanarak transkript başlatma
Windows'da OutputDirectory parametresiyle göreli bir yol kullandığınızda, yol dizininize Documents göredir.
Start-Transcript -Path .\transcripts
Transcript started, output file is C:\Users\username\Documents\.\transcripts\PowerShell_transcript.HOSTNAME.8S6RpEfN.20251105152247.txt
Örnek 5: Windows dışı sistemlerde göreli yol kullanarak transkript başlatma
Windows olmayan sistemlerde OutputDirectory parametresiyle göreli bir yol kullandığınızda, yol giriş dizininize göredir.
Start-Transcript -Path ./transcripts
Transcript started, output file is /home/username/./transcripts/PowerShell_transcript.hostname.ift21QeV.20251105151236.txt
Parametreler
-Append
Bu cmdlet'in yeni transkripti var olan bir dosyanın sonuna eklediğini gösterir. Dosyayı belirtmek için Path parametresini kullanın.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Cf |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Force
Cmdlet'in transkripti var olan bir salt okunur dosyaya eklemesine izin verir. Salt okunur bir dosyada kullanıldığında, cmdlet dosya iznini okuma-yazma olarak değiştirir. Bu parametre kullanıldığında cmdlet güvenlik kısıtlamalarını geçersiz kılamaz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-IncludeInvocationHeader
Komutlar çalıştırıldığında bu cmdlet'in zaman damgasını günlüğe kaydeddiğini gösterir.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-LiteralPath
Transkript dosyasının konumunu belirtir. Path parametresinden farklı olarak, LiteralPath parametresinin değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, yolu tek tırnak işaretleriyle çevreleyin. Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamaması konusunda bilgilendirir.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | PSPath, LP |
Parametre kümeleri
ByLiteralPath
| Position: | 0 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-NoClobber
Bu cmdlet'in varolan bir dosyanın üzerine yazılmadığını gösterir. Varsayılan olarak, belirtilen yolda bir transkript dosyası varsa, Start-Transcript uyarı vermeden dosyanın üzerine yazar.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | NoOverwrite |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-OutputDirectory
Dökümünün kaydedildiği belirli bir yolu ve klasörü belirtir. PowerShell, transkript adını otomatik olarak atar. Göreli yol kullanıyorsanız, yol Windows'ta dizininize Documents göredir. Linux ve macOS'ta yol, giriş dizininize göredir.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ByOutputDirectory
| Position: | 0 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Path
Transkript dosyasının konumunu belirtir.
.txt dosyasının yolunu girin. Joker karakterlere izin verilmez. Yoldaki dizinlerden herhangi biri yoksa, komut başarısız olur.
Yol belirtmezseniz, Start-Transcript$Transcript genel değişkeninin değerindeki yolu kullanır. Bu değişkeni oluşturmadıysanız, Start-Transcript transkriptleri varsayılan konum ve dosya adında depolar.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ByPath
| Position: | 0 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-UseMinimalHeader
Varsayılan olarak eklenen ayrıntılı üst bilgi yerine transkripte kısa bir üst bilgi ekleyin. Bu parametre PowerShell 6.2'ye eklendi.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmıyor.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Wi |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
None
Nesneleri bu cmdlet'e yöneltemezsiniz.
Çıkışlar
String
Bu cmdlet, bir onay iletisi ve çıkış dosyasının yolunu içeren bir dize döndürür.
Notlar
Transkripti durdurmak için Stop-Transcript cmdlet'ini kullanın.
Oturumun tamamını kaydetmek için profilinize Start-Transcript komutunu ekleyin. Daha fazla bilgi için bkz. about_Profiles.
