Aracılığıyla paylaş

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.

Syntax

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

Cmdlet, Start-Transcript 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ı şeklindedir 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, Start-Transcript varsayılan olarak hedef dosyada kodlama olur 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 dosyasında Transcript0.txtC:\transcriptsbir transkript başlatır. NoClobber parametresi, mevcut dosyaların üzerine yazılmasını engeller. Transcript0.txt Dosya 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 dosya paylaşımında \\Server01\Transcripts 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 tercih değişkeninde $Transcript depolanır. Tercih değişkeni hakkında $Transcript 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.

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-IncludeInvocationHeader

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Aliases:PSPath, LP
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-OutputDirectory

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

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

-Path

Transkript dosyasının konumunu belirtir. Dosyanın yolunu .txt girin. Joker karakterlere izin verilmez. Yoldaki dizinlerden herhangi biri yoksa, komut başarısız olur.

Yol belirtmezseniz, Start-Transcript genel değişkenin değerindeki $Transcript yolu kullanır. Bu değişkeni oluşturmadıysanız transkriptleri Start-Transcript varsayılan konumda ve dosya adında depolar.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Dökümü durdurmak için cmdlet'ini Stop-Transcript kullanın.

Oturumun tamamını kaydetmek için komutunu profilinize ekleyin Start-Transcript . Daha fazla bilgi için bkz . about_Profiles.