다음을 통해 공유


AspNetCompiler 작업

AspNetCompiler 작업은 ASP.NET 애플리케이션을 미리 컴파일하는 유틸리티인 aspnet_compiler.exe를 래핑합니다.

작업 매개 변수

다음 표에서는 AspNetCompiler 작업의 매개 변수에 대해 설명합니다.

매개 변수 Description
AllowPartiallyTrustedCallers 선택적 Boolean 매개 변수입니다.

이 매개 변수가 true이면 강력한 이름의 어셈블리에서 부분적으로 신뢰할 수 있는 호출자를 사용할 수 있습니다.
Clean 선택적 Boolean 매개 변수

이 매개 변수가 true이면 미리 컴파일된 애플리케이션이 클린 빌드됩니다. 이전에 컴파일된 구성 요소가 모두 다시 컴파일됩니다. 기본값은 false입니다. 이 매개 변수는 aspnet_compiler.exe-c 스위치에 해당합니다.
Debug 선택적 Boolean 매개 변수입니다.

이 매개 변수가 true이면 컴파일 중 디버그 정보(.PDB 파일)가 내보내집니다. 기본값은 false입니다. 이 매개 변수는 aspnet_compiler.exe-d 스위치에 해당합니다.
DelaySign 선택적 Boolean 매개 변수입니다.

이 매개 변수가 true이면 어셈블리를 만들 때 완전히 서명되지 않습니다.
FixedNames 선택적 Boolean 매개 변수입니다.

이 매개 변수가 true이면 컴파일된 어셈블리에 고정 이름이 지정됩니다.
Force 선택적 Boolean 매개 변수

이 매개 변수가 true이면 대상 디렉터리가 이미 있는 경우 작업은 대상 디렉터리를 덮어씁니다. 기존 콘텐츠는 손실됩니다. 기본값은 false입니다. 이 매개 변수는 aspnet_compiler.exe-f 스위치에 해당합니다.
KeyContainer 선택적 String 매개 변수입니다.

강력한 이름의 키 컨테이너를 지정합니다.
KeyFile 선택적 String 매개 변수입니다.

강력한 이름 키 파일의 실제 경로를 지정합니다.
MetabasePath 선택적 String 매개 변수입니다.

애플리케이션의 전체 IIS 메타베이스 경로를 지정합니다. 이 매개 변수는 VirtualPath 또는 PhysicalPath 매개 변수와 함께 사용할 수 없습니다. 이 매개 변수는 aspnet_compiler.exe-m 스위치에 해당합니다.
PhysicalPath 선택적 String 매개 변수입니다.

컴파일할 애플리케이션의 실제 경로를 지정합니다. 이 매개 변수가 누락되면 IIS 메타데이터가 애플리케이션을 찾는 데 사용됩니다. 이 매개 변수는 aspnet_compiler.exe-p 스위치에 해당합니다.
TargetFrameworkMoniker 선택적 String 매개 변수입니다.

aspnet_compiler.exe의 .NET Framework 버전을 나타내는 TargetFrameworkMoniker가 사용되도록 지정합니다. .NET Framework 모니커만 허용합니다.
TargetPath 선택적 String 매개 변수입니다.

애플리케이션이 컴파일되는 실제 경로를 지정합니다. 지정하지 않으면 애플리케이션은 현재 위치에서 미리 컴파일됩니다.
Updateable 선택적 Boolean 매개 변수입니다.

이 매개 변수가 true이면 미리 컴파일된 애플리케이션이 업데이트 가능합니다. 기본값은 false입니다. 이 매개 변수는 aspnet_compiler.exe-u 스위치에 해당합니다.
VirtualPath 선택적 String 매개 변수입니다.

컴파일할 애플리케이션의 가상 경로입니다. PhysicalPath가 지정되면 실제 경로가 애플리케이션을 찾는 데 사용됩니다. 그렇지 않으면 IIS 메타베이스가 사용되고 애플리케이션은 기본 사이트에 있는 것으로 간주됩니다. 이 매개 변수는 aspnet_compiler.exe-v 스위치에 해당합니다.

ToolTaskExtension 매개 변수

이 작업은 Task 클래스에서 상속되는 ToolTask 클래스에서 상속되는 ToolTaskExtension 클래스에서 상속됩니다. 이 상속 체인은 매개 변수에서 파생되는 작업에 해당 매개 변수 몇 개를 추가합니다.

다음 표에서는 기본 클래스의 매개 변수에 대해 설명합니다.

매개 변수 Description
EchoOff 선택적 bool 매개 변수입니다.

true로 설정된 경우 이 작업은 명령줄이 stdout으로 복사되지 않도록 /Qcmd.exe 명령줄로 전달합니다.
EnvironmentVariables 선택적 String 배열 매개 변수입니다.

세미콜론으로 구분된 환경 변수 정의의 배열입니다. 각 정의는 환경 변수 이름 및 값을 등호로 구분하여 지정해야 합니다. 이 변수는 생성된 실행 파일에 전달되면서 일반 환경 블록에 추가되거나 일부 일반 환경 블록을 재정의합니다. 예들 들어 Variable1=Value1;Variable2=Value2입니다.
ExitCode 선택적 Int32 읽기 전용 출력 매개 변수입니다.

실행한 명령에서 제공하는 종료 코드를 지정합니다. 작업에서 오류를 기록했지만 프로세스가 종료 코드 0(성공)을 반환한 경우 이는 -1로 설정됩니다.
LogStandardErrorAsError 선택적 bool 매개 변수입니다.

true인 경우 표준 오류 스트림에서 받은 모든 메시지가 오류로 기록됩니다.
StandardErrorImportance 선택적 String 매개 변수입니다.

표준 오류 스트림의 텍스트를 기록하는 중요도입니다.
StandardOutputImportance 선택적 String 매개 변수입니다.

표준 출력 스트림의 텍스트를 기록할 때 적용할 중요도입니다.
Timeout 선택적 Int32 매개 변수입니다.

작업 실행 파일이 얼마 후에 종료될 지를 밀리초 단위로 지정합니다. 기본값은 시간 제한이 없음을 나타내는 Int.MaxValue입니다. 제한 시간(밀리초)입니다.
ToolExe 선택적 string 매개 변수입니다.

프로젝트에서 작업의 ToolName을 재정의하기 위해 이를 구현할 수 있습니다. 작업에서는 ToolName을 유지하기 위해 이를 재정의할 수 있습니다.
ToolPath 선택적 string 매개 변수입니다.

작업에서 내부 실행 파일을 로드할 위치를 지정합니다. 이 매개 변수를 지정하지 않으면 작업에서는 MSBuild를 실행하고 있는 프레임워크 버전에 해당하는 SDK 설치 경로가 사용됩니다.
UseCommandProcessor 선택적 bool 매개 변수입니다.

true로 설정된 경우 이 작업은 명령줄에 대한 배치 파일을 만들고 명령을 직접 실행하는 대신 명령 처리기를 사용하여 실행합니다.
YieldDuringToolExecution 선택적 bool 매개 변수입니다.

true로 설정된 경우 작업이 실행 중이면 이 작업이 노드를 발생시킵니다.

다음 코드 예제에서는 AspNetCompiler 작업을 사용하여 ASP.NET 애플리케이션을 미리 컴파일합니다.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="PrecompileWeb">
        <AspNetCompiler
            VirtualPath="/MyWebSite"
            PhysicalPath="c:\inetpub\wwwroot\MyWebSite\"
            TargetPath="c:\precompiledweb\MyWebSite\"
            Force="true"
            Debug="true"
        />
    </Target>
</Project>

참고 항목