Start-Transcript

Start-Transcript [[-Path] <string>] [-Append] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>]

Start-Transcript cmdlet은 Windows PowerShell의 전체 또는 일부 세션에 대한 레코드를 텍스트 파일로 만듭니다. 기록에는 사용자가 입력한 모든 명령과 콘솔에 나타나는 모든 출력이 포함됩니다.

-Append

새 기록을 기존 파일 끝에 추가합니다. 경로 매개 변수를 사용하여 파일을 지정하십시오.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-Force

Cmdlet이 기존 읽기 전용 파일에 기록을 추가할 수 있도록 합니다. 읽기 전용 파일에서 사용하면 cmdlet이 파일 권한을 읽기/쓰기로 변경합니다. Force 매개 변수를 사용해도 cmdlet은 보안 제한을 재정의할 수 없습니다.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-NoClobber

기존 파일을 덮어쓰거나 파일 내용을 바꾸지 않습니다. 기록 파일이 지정된 경로에 있는 경우 Start-Transcript는 기본적으로 경고 없이 파일을 덮어씁니다.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-Path <string>

기록 파일의 위치를 지정합니다. .txt 파일의 경로를 입력하십시오. 와일드카드는 사용할 수 없습니다.

경로를 지정하지 않으면 Start-Transcript가 $Transcript 전역 변수 값에 있는 경로를 사용합니다. 이 변수를 만들지 않은 경우 Start-Transcript는 $Home\My Documents 디렉터리에 \PowerShell_transcript.<time-stamp>.txt 파일로 기록을 저장합니다.

경로에 디렉터리가 없으면 명령이 실행되지 않습니다.

필수 여부	false
위치	1
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-Confirm

명령을 실행하기 전에 확인 메시지를 표시합니다.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-WhatIf

명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

없음

개체를 이 cmdlet으로 파이프할 수 없습니다.

출력

System.String

Start-Transcript는 확인 메시지를 포함하는 문자열과 출력 파일 경로를 반환합니다.

기록을 중지하려면 Stop-Transcript cmdlet을 사용합니다.

전체 세션을 기록하려면 사용자 프로필에 Start-Transcript 명령을 추가하십시오. 자세한 내용은 about_Profiles를 참조하십시오.

C:\PS>start-transcript

설명
-----------
이 명령은 기본 파일 위치에서 기록을 시작합니다.

C:\PS>start-transcript -path c:\transcripts\transcript0.txt -noclobber

설명
-----------
이 명령은 C:\transcripts의 Transcript0.txt 파일에서 기록을 시작합니다. NoClobber 매개 변수는 기존 파일의 덮어쓰기를 방지합니다. Transcript0.txt 파일이 이미 있으면 명령이 실행되지 않습니다.

Stop-Transcript