다음을 통해 공유

Configuration Manager 사용자 지정 작업 컨트롤을 만드는 방법

  • 아티클

Configuration Manager 사용자 지정 작업 컨트롤을 만들려면 다음 두 클래스를 사용하여 Windows 컨트롤을 만듭니다.

클래스 설명
SmsOsdEditorPageControl 사용자 지정 작업 컨트롤입니다. 이 클래스에서 파생되어 작업 순서 편집기에서 표시되는 사용자 지정 작업 컨트롤을 구현합니다.
TaskSequenceOptionControl 사용자 지정 작업에 대한 옵션 컨트롤입니다. 이 클래스에서 파생되어 작업 순서 편집기에서 표시되는 사용자 지정 작업 옵션 페이지를 만듭니다.

이러한 절차에서는 Visual Studio 2005를 사용하여 Configuration Manager 운영 체제 배포 제어 어셈블리를 만드는 방법을 보여 줍니다. 작업 순서 편집기에 로드되면 컨트롤은 사용자 지정 작업에 대한 사용자 이름 작업 변수를 설정하는 데 사용되는 텍스트 상자가 포함된 속성 페이지를 표시합니다.

이러한 단계를 완료한 후 다음 항목의 단계를 수행하여 MOF(사용자 지정 작업 관리 개체 형식) 파일을 만들고 사용자 지정 작업 컨트롤을 사용합니다.

Configuration Manager 사용자 지정 작업에 대한 MOF 파일을 만드는 방법

Configuration Manager 사용자 지정 작업을 사용하는 방법

참고

배포의 일부로 사용자 지정 작업을 사용하는 방법에 대한 자세한 내용은 사용자 지정 작업 클라이언트 애플리케이션 Configuration Manager 정보를 참조하세요.

Visual Studio 프로젝트 제어

다음 절차에서는 사용자 지정 작업 제어 프로젝트를 만듭니다.

컨트롤 만들기

  1. Visual Studio 2010의 파일 메뉴에서 새로 만들기를 가리킨 다음 프로젝트를 클릭하여 새 프로젝트 대화 상자를 엽니다.

  2. Visual C#, Windows 프로젝트 목록에서 Windows 컨트롤 라이브러리 프로젝트 템플릿을 선택한 다음 이름 상자에 를 입력 ConfigMgrTSAction 합니다.

  3. 확인을 클릭하여 Visual Studio 프로젝트를 만듭니다.

  4. 솔루션 탐색기UserControl1.cs를 마우스 오른쪽 단추로 클릭하고 이름 바꾸기를 클릭한 다음 이름을 로 ConfigMgrTSActionControl.cs변경합니다.

  5. 솔루션 탐색기참조를 마우스 오른쪽 단추로 클릭한 다음 참조 추가를 클릭합니다.

  6. 참조 추가 대화 상자에서 찾아보기 탭을 클릭하고 %ProgramFiles%\Microsoft Configuration Manager\AdminUI\bin으로 이동한 다음, 다음 어셈블리를 선택합니다.

    • Adminui.osdcommon.dll

    • Adminui.tasksequenceeditor.dll

    • Adminui.wqlqueryengine.dll

    • Microsoft.configurationmanagement.exe

    • Microsoft.configurationmanagement.managementprovider.dll

  7. 확인을 클릭하여 어셈블리를 프로젝트 참조로 추가합니다.

  8. 솔루션 탐색기ConfigMgrTSActionControl.cs를 마우스 오른쪽 단추로 클릭한 다음 코드 보기를 클릭합니다.

  9. 다음 코드를 추가하여 필요한 네임스페이스를 포함합니다.

    using Microsoft.ConfigurationManagement.AdminConsole;  
using Microsoft.ConfigurationManagement.AdminConsole.TaskSequenceEditor;

  10. 클래스 ConfigMgrTSActionControl이 SmsOsdEditorPageControl에서 파생되도록 변경합니다.

  11. ConfigMgrTSActionControl.cs에서 ConfigMgrTSActionControl 클래스에 다음 새 생성자를 추가합니다.

    public ConfigMgrTSActionControl(SmsPageData data) : base(data)   
{   
    InitializeComponent();   
}

  12. 다음 메서드를 추가하여 컨트롤을 초기화합니다.

    public override void InitializePageControl()  
{  
   base.InitializePageControl();  
}

옵션 컨트롤 만들기

다음 절차에서는 사용자 지정 작업에 대한 옵션 컨트롤을 선언하는 코드를 만듭니다. 이 구현에서는 기본 옵션 컨트롤을 사용합니다.

옵션 컨트롤을 만들려면

  • ConfigMgrTSActionControl.cs의 끝에 ConfigMgrTSAction 네임스페이스에 다음 새 클래스를 추가합니다.

    public class ConfigureTSActionOptions : TaskSequenceOptionControl  
{  
    public ConfigureTSActionOptions() : base()   
    {  
    }  
    public ConfigureTSActionOptions(SmsPageData data) : base(data)   
    {  
    }  
}

사용자 인터페이스 사용자 지정

다음 절차에서는 작업 데이터를 관리하는 텍스트 상자와 코드를 추가합니다.

사용자 인터페이스를 추가하려면

  1. 솔루션 탐색기ConfigMgrTSActionControl.cs를 마우스 오른쪽 단추로 클릭한 다음 뷰 디자이너를 클릭합니다.

  2. 도구 상자에서 공통 컨트롤 탭을 클릭한 다음 TextBox를 두 번 클릭합니다. 라는 textBox1 단추가 사용자 컨트롤 디자이너의 컨트롤에 추가됩니다.

  3. 텍스트 상자를 두 번 클릭합니다. 라는 textBox1_TextChanged 이벤트 처리기가 ConfigMgrTSActionControl 클래스에 추가됩니다. 다음 코드를 추가하여 변경 내용이 작업의 속성 관리자에 저장되도록 합니다.

    SetDirtyFlag(true);

  4. ConfigMgrTSActionControl 클래스에서 다음 메서드를 추가하여 사용자 지정 작업 MOF에 정의된 속성에 텍스트 상자 값을 User 씁니다. 확인 또는 적용 단추를 클릭할 때 호출됩니다.

    protected override bool ApplyChanges(out Control errorControl, out bool showError)  
{  
    // You can check the error here and return false.  
    if (this.HasError(out errorControl) == true)  
    {  
        this.ShowMessageBox(  
            this.GetErrorString(),  
            "Error",  
            MessageBoxButtons.OK,  
            MessageBoxIcon.Warning);  
        errorControl = null;  
        showError = true;  
        return false;  
    }  
    this.PropertyManager["User"].StringValue = textBox1.Text;  

    return base.ApplyChanges(out errorControl, out showError);  
}

  5. 컨트롤의 디자인 뷰에서 컨트롤을 두 번 클릭하여 메서드 ConfigMgrTSActionControl_Load 만듭니다.

  6. 메서드에 다음 코드를 추가합니다. 이 코드는 기존 사용자 값으로 텍스트 상자를 로드합니다. 이 문제는 작업 순서 작업을 만든 후 편집할 때 발생합니다.

    textBox1.Text = this.PropertyManager["User"].StringValue;

리소스 문자열

다음 절차에서는 작업 순서 편집기에서 사용자 지정 작업 이름을 표시하는 데 사용되는 리소스 문자열을 추가합니다.

리소스 문자열을 추가하려면

  1. 솔루션 탐색기프로젝트 메뉴에서 속성을 클릭합니다.

  2. 리소스 탭 을 클릭합니다. 리소스 파일이 없는 경우 리소스 탭에 표시되는 메시지를 선택하여 만듭니 다 .

  3. 리소스 디자이너 도구 모음에서 리소스 보기 드롭다운을 가리키고 화살표를 클릭한 다음 문자열(기본값)으로 설정되어 있는지 확인 합니다 . 리소스 디자이너의 인스턴스에서 유지 관리되는 문자열을 표시하는 설정 표가 나타납니다.

  4. 눈금에서 마지막 행의 이름 열을 클릭합니다. 이 열은 별표(*)로 표시됩니다.

  5. 이름 열에서 문자열 이름으로 를 입력 DefaultDisplay_ConfigMgrTSAction 합니다.

  6. 값 열에 사용자 지정 작업 문자열을 입력합니다. 작업 순서 작업 목록에 표시되는 문자열입니다.

  7. 눈금에서 마지막 행의 이름 열을 클릭합니다. 이 열은 별표(*)로 표시됩니다.

  8. 이름 열에서 문자열 이름으로 를 입력 ConfigMgrTSAction 합니다.

  9. 값 열에 를 입력합니다Custom Action. 사용자 지정 작업을 추가할 때 표시되는 문자열입니다.

어셈블리 배포

이 절차에서는 만든 어셈블리를 빌드하고 Configuration Manager 콘솔 어셈블리 폴더에 복사합니다. Configuration Manager 콘솔 확장 배포에 대한 중요한 내용은 관리자 콘솔 확장 배포 Configuration Manager 정보를 참조하세요.

어셈블리를 배포하려면

  1. 프로젝트를 만듭니다. Visual Studio는 어셈블리를 \Visual Studio 2005\Projects\ConfigMgrControl\ConfigMgrTSAction\bin\Debug\ConfigMgrTSActionControl.dll 만듭니다.

  2. 어셈블리를 %ProgramFiles%\Microsoft Configuration Manager\AdminUI\bin 폴더에 복사합니다.

참고 항목

Configuration Manager 콘솔 확장 정보
Configuration Manager 콘솔 확장 배포
Configuration Manager 사용자 지정 작업에 대한 MOF 파일을 만드는 방법
Configuration Manager 사용자 지정 작업을 사용하는 방법