Start-Transcript

Başvuru

Modül:: Microsoft.PowerShell.Host

PowerShell oturumunun tümünün veya bir bölümünün kaydını bir metin dosyasına oluşturur.

Sözdizimi

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

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

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.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:	SwitchParameter
Diğer adlar:	cf
Position:	Named
Default value:	False
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-IncludeInvocationHeader

Komutlar çalıştırıldığında bu cmdlet'in zaman damgasını günlüğe kaydeddiğini gösterir.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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, tek tırnak içine alın. Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamaması konusunda bilgilendirir.

Tür:	String
Diğer adlar:	PSPath, LP
Position:	0
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	SwitchParameter
Diğer adlar:	NoOverwrite
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-OutputDirectory

Dökümünün kaydedildiği belirli bir yolu ve klasörü belirtir. PowerShell, transkript adını otomatik olarak atar.

Tür:	String
Position:	0
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	String
Position:	0
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmıyor.

Tür:	SwitchParameter
Diğer adlar:	wi
Position:	Named
Default value:	False
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

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.