UnregisterAssembly 작업UnregisterAssembly Task

COM interop 용도로 지정된 어셈블리의 등록을 취소합니다.Unregisters the specified assemblies for COM interop purposes. RegisterAssembly 작업의 역작업을 수행합니다.Performs the reverse of the RegisterAssembly task.

매개 변수Parameters

다음 표에서는 UnregisterAssembly 작업의 매개 변수에 대해 설명합니다.The following table describes the parameters of the UnregisterAssembly task.

매개 변수Parameter 설명Description
Assemblies 선택적 ITaskItem[] 매개 변수입니다.Optional ITaskItem[] parameter.

등록을 취소할 어셈블리를 지정합니다.Specifies the assemblies to be unregistered.
AssemblyListFile 선택적 ITaskItem 매개 변수입니다.Optional ITaskItem parameter.

RegisterAssembly 작업 및 UnregisterAssembly 작업 간의 상태 정보를 포함합니다.Contains information about the state between the RegisterAssembly task and the UnregisterAssembly task. 이를 통해 작업이 RegisterAssembly 작업에서 등록되지 못한 어셈블리의 등록을 취소하려고 하는 시도를 방지합니다.This prevents the task from attempting to unregister an assembly that failed to register in the RegisterAssembly task.

이 매개 변수를 지정하는 경우 AssembliesTypeLibFiles 매개 변수는 무시됩니다.If this parameter is specified, the Assemblies and TypeLibFiles parameters are ignored.
TypeLibFiles 선택적 ITaskItem[] 출력 매개 변수입니다.Optional ITaskItem[] output parameter.

지정된 어셈블리에서 지정된 형식 라이브러리의 등록을 취소합니다.Unregisters the specified type library from the specified assembly. 참고: 이 매개 변수는 형식 라이브러리 파일 이름이 어셈블리 이름과 다른 경우에 필요합니다.Note: This parameter is only necessary if the type library file name is different than the assembly name.

설명Remarks

이 작업이 성공하기 위해 이 어셈블리가 있어야 할 필요는 없습니다.It is not required that the assembly exists for this task to be successful. 존재하지 않는 어셈블리의 등록을 취소하려고 하면 작업은 성공하지만 경고가 발생합니다.If you attempt to unregister an assembly that does not exist, the task will succeed with a warning. 이 작업의 해당 작업이 레지스트리에서 어셈블리 등록을 제거하는 것이기 때문입니다.This occurs because it is the job of this task to remove the assembly registration from the registry. 어셈블리가 없으면 레지스트리에 없으므로 작업은 성공합니다.If the assembly does not exist, it is not in the registry, and therefore, the task succeeded.

이 작업은 위에 나와 있는 매개 변수 외에 MarshalByRefObject 클래스에서 직접 상속하는 AppDomainIsolatedTaskExtension 클래스의 매개 변수도 상속합니다.In addition to the parameters listed above, this task inherits parameters from the AppDomainIsolatedTaskExtension class, which itself inherits from the MarshalByRefObject class. MarshalByRefObject 클래스는 Task 클래스와 동일한 기능을 제공하지만 해당 응용 프로그램 도메인에서 인스턴스화될 수 있습니다.The MarshalByRefObject class provides the same functionality as the Task class, but it can be instantiated in its own application domain.

예제Example

다음 예제에서는 UnregisterAssembly 작업을 사용하여 OutputPathFileName 속성으로 지정된 경로에서 어셈블리(있는 경우)의 등록을 취소합니다.The following example uses the UnregisterAssembly task to unregister the assembly at the path specified by the OutputPath and FileName properties, if it exists.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">  
    <PropertyGroup>  
        <OutputPath>\Output\</OutputPath>  
        <FileName>MyFile.dll</FileName>  
    </PropertyGroup>  
    <Target Name="UnregisterAssemblies">  
        <UnregisterAssembly  
            Condition="Exists('$(OutputPath)$(FileName)')"  
            Assemblies="$(OutputPath)$(FileName)" />  
    </Target>  

</Project>  

참고 항목See Also

RegisterAssembly 작업 RegisterAssembly Task
작업 Tasks
작업 참조Task Reference