VSPerfCmdVSPerfCmd

VSPerfCmd.exe 도구는 성능 데이터 수집을 시작하고 중지하는 데 사용됩니다.The VSPerfCmd.exe tool is used to start and stop performance data collection. 이 도구는 다음 구문을 사용합니다.It uses the following syntax:

VSPerfCmd [/U] [/options]  

다음 표에는 VSPerfCmd.exe 도구 옵션이 설명되어 있습니다.The following tables describe VSPerfCmd.exe tool options.

옵션Option 설명Description
UU 리디렉션된 콘솔 출력이 유니코드로 기록됩니다.Redirected console output is written as Unicode. 이 옵션을 첫 번째 옵션으로 지정해야 합니다.Must be the first option specified.
Start : modeStart : mode 지정된 모드로 프로파일링 서비스를 시작합니다.Starts the profiling service in the specified mode.
Output : filenameOutput : filename 출력 파일 이름을 지정합니다.Specifies the output file name. Start와 함께 사용하는 것만 가능합니다.Use only with Start.
CrossSession|CSCrossSession|CS Windows 세션 전반에서 프로파일링을 사용합니다.Enables profiling across Windows sessions. Start, Attach 또는 Launch와 함께 사용하는 것만 가능합니다.Use only with Start, Attach, or Launch.
User :[domain\]usernameUser :[domain\]username 지정된 계정이 프로파일러 서비스에 액세스할 수 있도록 합니다.Enables the specified account access to the profiler service. Start와 함께 사용하는 것만 가능합니다.Use only with Start.
WaitStart[:n]WaitStart[:n] 데이터 수집 로거가 초기화될 때까지 대기합니다.Waits for the data collection logger to initialize. n이 지정된 경우 VSPerfCmd에서 최대 n초를 대기합니다.If n is specified, VSPerfCmd will wait at most n seconds. n이 지정되지 않은 경우 VSPerfCmd에서 무기한으로 대기합니다.If n is not specified, VSPerfCmd will wait indefinitely. 이렇게 하면 보다 쉽게 VSPerfCmd를 일괄 처리 프로세스의 일부로 사용할 수 있습니다.This eases use of VSPerfCmd as part of a batch process.
Counter : cfgCounter : cfg 샘플 프로파일링 방법을 사용하는 경우 CPU 카운터와 샘플링 간격으로 사용할 이벤트 수를 지정합니다.When the sample profiling method is used, specifies a CPU counter and the number of events to use as the sampling interval. 카운터 값은 하나만 샘플링할 수 있습니다.You can sample only one counter value.

계측 프로파일링 방법을 사용하는 경우 각 계측 지점에서 수집할 CPU 카운터를 지정합니다.When the instrumentation profiling method is used, specifies a CPU counter to be collected at each instrumentation point. Start:Trace, Attach 또는 Launch와 함께 사용하는 것만 가능합니다.Use only with Start:Trace, Attach,or Launch.
QueryCountersQueryCounters 현재 컴퓨터의 유효한 CPU 카운터 목록이 표시됩니다.Displays a list of valid CPU counters for the current machine.
WinCounter : pathWinCounter : path 프로필 표시 데이터와 함께 포함할 Windows 성능 카운터 이벤트를 지정합니다.Specifies a Windows performance counter event to include with profile mark data. Start와 함께 사용하는 것만 가능합니다.Use only with Start.
AutoMark : nAutoMark : n Windows 성능 카운터 데이터 수집 이벤트 간 시간 간격(밀리초)을 지정합니다.Specifies the time interval (in milliseconds) between Windows performance counter data collection events. WinCounter와 함께 사용합니다.Use with WinCounter.
Events : optionEvents : option 지정된 ETW(Windows용 이벤트 추적) 이벤트에 대한 수집을 제어합니다.Controls collection of specified Event Tracing for Windows (ETW) events. ETW 데이터는 프로파일링 데이터(.vsp) 파일이 아닌 .itl 파일에 수집됩니다.ETW data is collected to an .itl file that is not the profiling data (.vsp) file.
StatusStatus 프로파일러 상태, 현재 프로파일링 중인 프로세스에 대한 정보 및 프로파일러 제어 권한이 있는 계정을 표시합니다.Displays the state of the profiler, information about processes that are currently being profiled, and accounts that have authority to control the profiler.
Shutdown[:n]Shutdown[:n] 프로파일링 데이터 파일을 닫고 프로파일러를 해제합니다.Closes the profiling data file and turns the profiler off.
GlobalOnGlobalOn VSPerfCmdGlobalOff 호출 후 데이터 수집을 다시 시작합니다.Resumes data collection after a call to VSPerfCmdGlobalOff.
GlobalOffGlobalOff 모든 데이터 수집을 중지하지만 프로파일링 세션을 종료하지 않습니다.Stops all data collection, but does not end the profiling session.
ProcessOn : pidProcessOn : pid VSPerfCmdProcessOff 호출로 프로파일링이 일시 중지된 후 지정된 프로세스에 대한 데이터 수집을 다시 시작합니다.Resumes data collection for the specified process after profiling was paused by a call to VSPerfCmdProcessOff.
ProcessOff : pidProcessOff : pid 지정된 프로세스에 대한 데이터 수집을 중지합니다.Stops data collection for the specified process.
ThreadOn 및 ThreadOff : tidThreadOn and ThreadOff : tid VSPerfCmdThreadOff 호출로 프로파일링이 일시 중지된 후 지정된 프로세스에 대한 프로파일링을 다시 시작합니다.Resumes profiling for the specified process after profiling was paused by a call to VSPerfCmdThreadOff. 계측 방법으로 프로파일링하는 경우에만 ThreadOn을 사용합니다.Use ThreadOn only when profiling with the instrumentation method.
ThreadOn 및 ThreadOff : tidThreadOn and ThreadOff : tid 지정된 스레드에 대한 프로파일링을 일시 중지합니다.Pauses profiling for the specified thread. 계측 방법으로 프로파일링하는 경우에만 ThreadOff를 사용합니다.Use ThreadOff only when profiling with the instrumentation method.
Mark : MarkNum[,MarkText]Mark : MarkNum[,MarkText] 선택적 텍스트와 함께 표시를 프로파일링 데이터 파일에 삽입합니다.Inserts a mark into the profiling data file, with optional text.

샘플링 방법 옵션Sampling Method Options

다음 옵션은 샘플링 프로파일링 방법을 사용하는 경우에만 사용할 수 있습니다.The following options are only available when you are using the sampling profiling method.

옵션Option 설명Description
Launch : ExecutableLaunch : Executable 지정된 응용 프로그램을 시작하고 프로파일링을 시작합니다.Starts the specified application and begins profiling.
Args : ArgumentsArgs : Arguments 시작된 응용 프로그램에 전달할 명령줄 인수를 지정합니다.Specifies command line arguments to pass to the launched application.
콘솔Console 새 명령 프롬프트 창에서 지정된 명령을 시작합니다.Starts the specified command in a new command prompt window.
Attach : PID[,PID]Attach : PID[,PID] 지정된 프로세스의 프로파일링을 시작합니다.Begins profiling the specified processes. 프로세스는 프로세스 ID 또는 프로세스 이름으로 식별할 수 있습니다.Processes can be identified by the process id or by the process name.
Detach[:PID[,PID]]Detach[:PID[,PID]] 지정된 프로세스의 프로파일링을 중지합니다.Stops profiling the specified processes. 프로세스는 프로세스 ID 또는 프로세스 이름으로 식별할 수 있습니다.Processes can be identified by the process id or by the process name. 프로세스가 지정되지 않은 경우 모든 프로세스의 프로파일링이 중지됩니다.If no process is specified, profiling is halted for all processes.
GC[:{Allocation|Lifetime}]GC[:{Allocation|Lifetime}] .NET 메모리 할당 및 개체 수명 데이터를 수집합니다.Collects .NET memory allocation and object lifetime data. VSPerfCmdLaunch 옵션과 함께 사용하는 것만 가능합니다.Use only with the VSPerfCmdLaunch option.

샘플링 간격 옵션Sampling Interval Options

다음 옵션은 샘플링 간격의 형식과 기간을 지정합니다.The following options specify the type and duration of sampling intervals. 기본값은 Timer입니다.The default is Timer. Counter 옵션을 사용하여 CPU 카운터를 간격으로 지정할 수도 있습니다.You can also specify a CPU counter as the interval by using the Counter option. 이러한 옵션은 프로파일링 세션의 첫 번째 Attach 또는 Launch와 함께 사용하는 경우에만 지정할 수 있습니다.These options can only be specified with Launch or with the first Attach of a profiling session.

옵션Option 설명Description
PF[:n]PF[:n] n번째 페이지 폴트마다 샘플링합니다(기본값 = 10).Samples on every n-th page fault (default=10).
Sys[:n]Sys[:n] n번째 시스템 호출마다 샘플링합니다(기본값 = 10).Samples on every n-th system call (default=10).
Timer[:n]Timer[:n] n번째 프로세서 주기마다 샘플링합니다(기본값 = 10000000).Samples on every n-th processor cycle (default=10000000).

서비스 구성 요소 및 커널 모드 장치 옵션Service Component and Kernel Mode Device Options

다음 Admin 옵션은 프로파일링 서비스 구성 요소 또는 커널 모드 장치 드라이버를 지원합니다.The following Admin options support profiling service components or kernel mode device drivers. Admin 옵션은 프로파일링 권한을 설정하고 프로파일링된 서비스 또는 장치 드라이버를 제어합니다.The Admin options set profiling permissions and control the profiled service or device driver.

Admin 옵션은 관리 자격 증명으로 실행 중인 명령 프롬프트에서 실행되어야 합니다.Admin options must be executed at a command prompt that is running with administrative credentials.

옵션Option 설명Description
Admin:Security <ALLOW|DENY> Right[ Right] <User|Group>Admin:Security <ALLOW|DENY> Right[ Right] <User|Group> 지정된 사용자 또는 그룹이 프로파일링 서비스에 액세스하는 것을 허용하거나 거부합니다.Allows or denies the specified user or group access to profiling services.

Right는 다음이 될 수 있습니다.Right can be:

CrossSession - 사용자에게 서비스에 대해 상호 세션 프로파일링을 수행할 수 있는 액세스 권한을 부여합니다.CrossSession - gives the user access to the service to do cross session profiling.

SampleProfiling - 사용자에게 드라이버에 대해 샘플링 프로파일링을 사용할 수 있는 액세스 권한을 부여합니다.SampleProfiling - gives the user access to the driver to enable sampling profiling. 추적 프로파일링 중 커널 전환 정보에 액세스하는 데에도 사용됩니다.Also used to access kernel transition information during trace profiling.

FullAccess - 사용자에게 CrossSession 및 SampleProfiling 액세스 권한을 모두 부여합니다.FullAccess - gives the user both CrossSession and SampleProfiling access.
Admin:Security, ListAdmin:Security, List 프로파일링 서비스의 현재 상태 및 사용자 권한을 나열합니다.Lists the current state of profiling services and lists user permissions.
Admin: <Service|Driver><START|STOP|INSTALL|UNINSTALL>Admin: <Service|Driver><START|STOP|INSTALL|UNINSTALL> 프로파일링 서비스 구성 요소(서비스) 또는 커널 모드 장치 드라이버(드라이버)를 시작하거나, 중지하거나, 설치하거나, 제거합니다.Starts, stops, installs, or uninstalls the profiling service component (service) or kernel mode device driver (driver).
Admin: <Service|Driver>AutoStart<ON|OFF>Admin: <Service|Driver>AutoStart<ON|OFF> 다시 시작 후 프로파일링 서비스(서비스) 또는 커널 모드 장치 드라이버(드라이버) 자동 시작을 사용하도록 설정하거나 사용하지 않도록 설정합니다.Enables or disables automatically starting the profiling service (service) or kernel mode device driver (driver) after a restart.

VSPerfCmd /DriverVSPerfCmd /Driver

VSPerfCmd /Driver 옵션은 이제 사용되지 않습니다.The VSPerfCmd /Driver option is now obsolete. 해당 기능에는 VsPerfCmdAdmin 옵션을 사용합니다.Use the VsPerfCmdAdmin options for this functionality.

참고 항목See Also

VSInstr VSInstr
VSPerfMon VSPerfMon
VSPerfReportVSPerfReport