Configuration Manager 사용자 지정 동작 클라이언트 응용 프로그램 정보About Configuration Manager Custom Action Client Applications

Configuration Manager에서 작업 순서 응용 프로그램은 클라이언트를 배포 하는 동안 사용자 지정 작업을 수행 합니다.The task sequence application, in Configuration Manager, performs the custom action operation during the client deployment. 응용 프로그램은 프로세스, 스크립트 또는 다른 명령 일 수 있습니다.The application can be a process, a script, or other commands. 운영 환경, 명령줄 인수, 속성 및 반환 코드와 같은 응용 프로그램에 대 한 요구 사항은 MOF (MOF(Managed Object Format)) 파일에 정의 되어 있습니다.The requirements for the application, such as the operating environment, command-line arguments, properties, and return codes are defined in a Managed Object Format (MOF) file. 작업이 처리 될 때 작업 순서 환경에 추가 됩니다.They are added to the task sequence environment when the action is processed.

사용자 지정 작업 MOF 파일Custom Action MOF File

사용자 지정 작업에 대 한 MOF 파일은 다음과 유사 합니다.The MOF file for a custom action is similar to the following:

[   CommandLine("smsswd.exe /run:%1 abc.exe %2"),  
    : (custom ui control and category qualifiers for action)  
    ]  
class MyCustomAction : SMS_TaskSequence_Action  
{  
    [TaskSequencePackage, CommandLineArg(1)]  
    string          PackageIDForAbcExe;  

    [CommandLineArg(2), AllowedLen("1-32000")]  
    string          AbcCommandLineArgs;  

    [SuccessCodes, Not_Null]  
    string          AbcSuccessCodes = "0 3010";  

    string         SomeOtherPropertyThatAbcNeeds;  

    string          SupportedEnvironment = "WinPEandFullOS";  
};  

MOF 파일은 사용자 지정 작업 응용 프로그램 입력, 환경, 속성 및 배포 패키지 정보에 필요한 정보를 설명 합니다.The MOF file describes the information that is needed for the custom action application input, environment, properties and deployment package information.

자세한 내용은 Configuration Manager 사용자 지정 작업 MOF 파일 정보를 참조 하세요.For more information, see About the Configuration Manager Custom Action MOF File.

응용 프로그램 입력Application Input

사용자 지정 작업은 무인 모드로 실행 해야 하므로 응용 프로그램에서 사용자 입력을 요청 하지 않아야 합니다.Custom actions have to run unattended and therefore the application should not prompt for user input. 모든 입력은 명령줄, 작업 순서 환경 또는 데이터 파일에서 받아야 합니다.All input should be received from either the command line, the task sequence environment, or from a data file.

작업 응용 프로그램에 대 한 명령줄은 기본 제공 명령줄 실행 작업을 사용 하 여 MOF 파일에 설정 됩니다.The command-line for the action application is set, in the MOF file, by using the run command line built-in action.

예를 들면 다음과 같습니다.For example:

CommandLine("smsswd.exe /run:PackageID abc.exe [any abc.exe command line args]"  

응용 프로그램 처리Application Processing

작업 순서 응용 프로그램은 사용자 지정 작업을 수행 합니다.The task sequence application performs the custom action operations. 운영 환경에 대해 알고 있어야 하 고, 작업 시퀀싱 환경 변수에 액세스 하 고, 진행률을 보고 하 고, 완료 코드를 반환할 수 있어야 합니다.It must be aware of its operating environment, be able to access the task sequencing environment variables, report progress, and return completion codes.

환경Environment

MOF 파일은 SMS_TaskSequence_Action 서버 WMI 클래스 속성을 사용 하 여 운영 환경을 지정 해야 합니다 SupportedEnvironment .The MOF file should specify the operating environment with the SMS_TaskSequence_Action Server WMI ClassSupportedEnvironment property. 사용 가능한 환경은 Windows PE ( WinPE ), 전체 운영 체제 ( FullOS ) 또는 두 환경 ( WinPEandFullOS )입니다.The available environments are Windows PE (WinPE), full operating system (FullOS), or both environments (WinPEandFullOS).

환경 선택은 상황에 따라 달라 집니다.The choice of environment depends on the circumstances. 예를 들어 Windows PE 환경에서 사전 운영 설치 구성을 수행할 수 있습니다.For example, pre-operating install configuration will likely be done in the Windows PE environment. 자세한 내용은 OS 배포를 위한 인프라 요구 사항을 참조하세요.For more information, see Infrastructure requirements for OS deployment. 현재 설치 된 운영 체제의 업데이트는 전체 운영 체제 환경을 사용 합니다.Updates to currently installed operating systems will use the full operating system environment. 예를 들어 소프트웨어 또는 드라이버 설치를 설치 합니다.For example, software or driver installation. 다시 부팅 또는 네트워크 연결 생성과 같은 운영 체제 환경에 관계 없이 작업을 수행 하려면 두 환경 설정을 모두 사용 해야 합니다.Operating system environment agnostic tasks such as reboots or the creation of network connections, can be performed by using both environment settings.

처리 중Processing

처리 하는 동안 COM 자동화 개체를 사용 하 여 MOF 파일에 정의 된 작업 순서 변수에 액세스 합니다 TSEnvironment .During processing, you access the task sequence variables defined by the MOF file by using the TSEnvironment COM automation object. 자세한 내용은 실행 중인 Configuration Manager 작업 순서에서 작업 순서 변수를 사용 하는 방법을 참조 하세요.For more information, see How to Use Task Sequence Variables in a Running Configuration Manager Task Sequence.

작업에 시간이 오래 걸리는 경우 작업 순서 환경에 진행률을 보고 하 고 ProgressUI CLIENT COM 자동화 클래스를 사용 하 여 진행률 표시기를 표시할 수 있습니다.If the operation takes a long time, you can report progress to the task sequence environment and display a progress indicator by using the ProgressUI Client COM Automation Class. 자세한 내용은 보고 Configuration Manager 사용자 지정 작업 진행률을 참조 하세요.For more information, see About Reporting Configuration Manager Custom Action Progress.

CompletionCompletion

응용 프로그램은 SuccessCodes 완료 될 때 환경 변수를 반환 값으로 설정 해야 합니다.The application should set the SuccessCodes environment variable as a return value when it is completed.

반환 값Return DescriptionDescription
00 성공Success
0이 아님Non-zero 실패Failure

응용 프로그램이 완료 된 후에 다시 부팅 해야 하는 경우 SMSTSRebootRequested 환경 변수를 설정 해야 합니다.If a reboot is required after the application finishes, the SMSTSRebootRequested environment variable should be set. 자세한 내용은 Task sequence variables(작업 순서 변수)를 참조하세요.For more information, see Task sequence variables. 환경 변수 설정에 대 한 자세한 내용은 실행 중인 Configuration Manager 작업 순서에서 작업 순서 변수를 사용 하는 방법을 참조 하세요.For information about setting environment variables, see How to Use Task Sequence Variables in a Running Configuration Manager Task Sequence.

배포Deployment

Configuration Manager에서 사용 하려면 사용자 지정 작업 응용 프로그램을 Configuration Manager 패키지에서 사용할 수 있어야 합니다.To be used by Configuration Manager, the custom action application must be available from a Configuration Manager package. 관리자는 Configuration Manager 콘솔을 사용 하거나 프로그래밍 언어를 사용 하 여 패키지를 만들 수 있습니다.The administrator can create the package by using either the Configuration Manager console or by using a programming language. 자세한 내용은 패키지를 만드는 방법을 참조 하세요.For more information, see How to Create a Package.

배포가 작동 하려면 패키지 식별자를 사용할 수 있어야 합니다.The package identifier must be available for the deployment to work. 일반적으로 MOF 파일은 다음 예제와 같이 속성을 선언 하 여 저장 합니다.Typically the MOF file declares a property to hold it, as in the following example:

[TaskSequencePackage, CommandLineArg(1)]  
string          PackageIDForAbcExe;  

참고

패키지 식별자는 SMS_Package 서버 WMI 클래스 PackageID 속성입니다.The package identifier is the SMS_Package Server WMI ClassPackageID property.

작업 순서 편집기에서 사용자 지정 작업을 편집 하면 관리자가 패키지 식별자를 가져옵니다.The package identifier is obtained from the administrator, when the custom action is edited in the Task Sequence Editor.

이를 사용 하도록 설정 하려면 사용자 지정 작업 컨트롤이 해당 구현에서 텍스트 편집 컨트롤을 사용 하 여 관리자 로부터 패키지 식별자를 가져올 수 있습니다.To enable this, your custom action control can use a text edit control in its implementation to get the package identifier from the administrator. 텍스트 컨트롤을 사용 하는 예제는 Configuration Manager 사용자 지정 작업 컨트롤을 만드는 방법을 참조 하세요.For an example that uses a text control, see How to Create a Configuration Manager Custom Action Control.

관리자가 사용 하는 경우 작업 순서 편집기를 사용 하 여 작업 순서의 일부로 사용자 지정 작업 컨트롤이 편집 됩니다.When used by the administrator, the custom action control is edited as part of a task sequence by using the Task Sequence Editor. 작업 순서 편집기에서 저장 하는 경우 사용자 지정 작업을 포함 하 여 작업 순서를 유지 하기 위해 SMS_TaskSequencePackage 서버 WMI 클래스가 생성 됩니다.When saved by the Task Sequence Editor, an SMS_TaskSequencePackage Server WMI Class is created to hold the task sequence, including the custom action.

작업 순서 패키지는 사용자 지정 작업에서 참조 하는 사용자 지정 작업 패키지와 함께 클라이언트에 보급 됩니다.The task sequence package is then advertised to clients along with the custom action package that is referenced by the custom action. 자세한 내용은 보급 알림을 만드는 방법을 참조 하세요.For more information, see How to Create an Advertisement.

클라이언트에서 사용자 지정 작업을 실행 하는 경우 사용자 지정 작업의 패키지 식별자가 명령줄 매개 변수로 제공 됩니다 .이 매개 변수를 통해 사용자 지정 동작에 대 한 이진 파일이 추출 되 고 실행 됩니다.When the custom action is run on the client, the package identifier for the custom action is supplied as a command-line parameter, from which the binary files for the custom action are extracted and run.

  • 명령줄 매개 변수를 사용 하 여 Smsswd.exe 패키지 식별자를 제공 /run 합니다.The package identifier is provided by using the /run command-line parameter to Smsswd.exe.

사전 네트워크 파티션 및 파티션 전 설정Pre-Network Partition and Pre-Partition Setup

디스크 파티션이 있고 네트워크에 연결 되기 전에 디스크 또는 네트워크 연결을 구성 해야 하는 경우 이러한 작업을 수행 하는 응용 프로그램을 만들어야 합니다.If you need to configure disk or network connectivity before you have a disk partition and before you have network connectivity, you will need to create an application to perform these tasks. 응용 프로그램은 Windows 평가 및 배포 키트를 사용 하 여 사용자 지정 부팅 이미지에 배치 해야 합니다.Your application should be placed in a custom boot image by using the Windows Assessment and Deployment Kit. 자세한 내용은 IT 전문가를 위한 windows 10 용 WINDOWS ADK 시나리오를 참조 하십시오.For more information, see Windows ADK for Windows 10 scenarios for IT Pros.

참고

부팅 이미지 파일에 파일을 추가 하면 최소 RAM 요구 사항이 증가 하 고 메모리 부족으로 인해 작업 순서가 예기치 않은 방식으로 실패 하 게 될 수 있습니다.Adding files to the boot image file can increase the minimum RAM requirements and can, due to low memory conditions, cause task sequences to fail in unexpected ways.

그런 다음 이미지를 Configuration Manager 사용자 지정 이미지로 가져와야 합니다.You will then need to import the image into Configuration Manager as a custom image. 자세한 내용은 부팅 이미지 추가를 참조 하세요.For more information, see Add a boot image.

응용 프로그램, 모든 지원 파일 및 사용자 지정 SMSTS.INI은 Windows 폴더에 배치 해야 합니다.The application, any supporting files, and the custom SMSTS.INI should be placed in the Windows folder.

응용 프로그램을 사용 하려면 프리 파티션/네트워크 단계가 포함 된 작업 순서에서 사용자 지정 부팅 이미지를 사용 합니다.To use the application, you will use the custom boot image in a task sequence that contains a pre-partition/network step.

참고 항목See Also

Configuration Manager 사용자 지정 작업 정보 About Configuration Manager Custom Actions
Configuration Manager 사용자 지정 작업 MOF 파일 정보About the Configuration Manager Custom Action MOF File