Configuration Manager 사용자 지정 작업 클라이언트 애플리케이션 정보

아티클
04/04/2023

Configuration Manager 작업 순서는 클라이언트 배포 중에 사용자 지정 작업 작업을 수행합니다. 애플리케이션은 프로세스, 스크립트 또는 기타 명령일 수 있습니다. 애플리케이션에 대한 요구 사항은 MOF(관리 개체 형식) 파일로 정의됩니다. 예제 요구 사항에는 운영 환경, 명령줄 인수, 속성 및 반환 코드가 포함됩니다. 작업이 처리될 때 작업 순서 환경에 추가됩니다.

사용자 지정 작업 MOF 파일

사용자 지정 작업에 대한 MOF 파일은 다음 예제와 유사합니다.

[   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 파일은 사용자 지정 작업 애플리케이션 입력, 환경, 속성 및 배포 패키지 정보에 필요한 정보를 설명합니다.

자세한 내용은 Configuration Manager 사용자 지정 작업 MOF 파일 정보를 참조하세요.

애플리케이션 입력

사용자 지정 작업은 무인으로 실행해야 하므로 애플리케이션에서 사용자 입력을 묻는 메시지를 표시해서는 안 됩니다. 명령줄, 작업 순서 환경 또는 데이터 파일에서 모든 입력을 수신해야 합니다.

작업 애플리케이션에 대한 명령줄은 명령 줄 실행 기본 제공 작업을 사용하여 MOF 파일에서 설정됩니다.

예를 들면

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

애플리케이션 처리

작업 순서 애플리케이션은 사용자 지정 작업 작업을 실행합니다. 운영 환경을 알고 있어야 하며 작업 시퀀싱 환경 변수, 보고서 진행률 및 반환 완료 코드에 액세스할 수 있어야 합니다.

환경

MOF 파일은 SMS_TaskSequence_Action 서버 WMI 클래스SupportedEnvironment 속성을 사용하여 운영 환경을 지정해야 합니다. 사용 가능한 환경은 Windows PE(WinPE), 전체 운영 체제(FullOS) 또는 두 환경(WinPEandFullOS)입니다.

환경 선택은 상황에 따라 달라집니다. 예를 들어 사전 운영 설치 구성은 Windows PE 환경에서 수행될 가능성이 높습니다. 자세한 내용은 OS 배포에 대한 인프라 요구 사항을 참조하세요. 현재 설치된 운영 체제에 대한 업데이트 전체 운영 체제 환경을 사용합니다. 예를 들어 소프트웨어 또는 드라이버 설치입니다. 다시 부팅 또는 네트워크 연결 만들기와 같은 운영 체제 환경에 구애받지 않는 작업은 두 환경 설정을 모두 사용하여 수행할 수 있습니다.

처리

처리하는 동안 COM 자동화 개체를 사용하여 MOF 파일에 정의된 작업 순서 변수에 TSEnvironment 액세스합니다. 자세한 내용은 실행 중인 Configuration Manager 작업 순서에서 작업 순서 변수를 사용하는 방법을 참조하세요.

작업이 오래 걸리는 경우 ProgressUI 클라이언트 COM 자동화 클래스를 사용하여 작업 순서 환경에 진행률을 보고하고 진행률 표시기를 표시할 수 있습니다. 자세한 내용은 보고 Configuration Manager 사용자 지정 작업 진행률을 참조하세요.

완료

애플리케이션이 완료되면 환경 변수를 반환 값으로 설정 SuccessCodes 해야 합니다.

반환	설명
0	성공
0이 아닌 경우	실패

애플리케이션이 완료된 후 다시 부팅이 필요한 경우 환경 변수를 SMSTSRebootRequested 설정해야 합니다. 자세한 내용은 작업 순서 변수를 참조하세요. 환경 변수 설정에 대한 자세한 내용은 실행 중인 Configuration Manager 작업 순서에서 작업 순서 변수를 사용하는 방법을 참조하세요.

배포

Configuration Manager 사용하려면 사용자 지정 작업 애플리케이션을 Configuration Manager 패키지에서 사용할 수 있어야 합니다. 관리자는 Configuration Manager 콘솔을 사용하거나 프로그래밍 언어를 사용하여 패키지를 만들 수 있습니다. 자세한 내용은 패키지를 만드는 방법을 참조하세요.

배포가 작동하려면 패키지 식별자를 사용할 수 있어야 합니다. 일반적으로 MOF 파일은 다음 예제와 같이 이를 저장할 속성을 선언합니다.

[TaskSequencePackage, CommandLineArg(1)]
string PackageIDForAbcExe;

참고

패키지 식별자는 SMS_Package 서버 WMI 클래스PackageID 속성입니다.

패키지 식별자는 사용자 지정 작업이 작업 순서 편집기에서 편집될 때 관리자로부터 가져옵니다.

이 동작을 사용하도록 설정하기 위해 사용자 지정 작업 컨트롤은 구현에서 텍스트 편집 컨트롤을 사용하여 관리자로부터 패키지 식별자를 가져올 수 있습니다. 텍스트 컨트롤을 사용하는 예제는 Configuration Manager 사용자 지정 작업 컨트롤을 만드는 방법을 참조하세요.

관리자가 사용하는 경우 사용자 지정 작업 컨트롤은 작업 순서 편집기를 사용하여 작업 순서의 일부로 편집됩니다. 작업 순서 편집기에서 저장하면 사용자 지정 작업을 포함하여 작업 순서를 유지하기 위해 SMS_TaskSequencePackage 서버 WMI 클래스 가 만들어집니다.

그런 다음, 작업 순서 패키지는 사용자 지정 작업에서 참조하는 사용자 지정 작업 패키지와 함께 클라이언트에 보급됩니다. 자세한 내용은 광고를 만드는 방법을 참조하세요.

클라이언트에서 사용자 지정 작업을 실행하면 사용자 지정 작업에 대한 패키지 식별자가 명령줄 매개 변수로 제공되며, 이 매개 변수는 사용자 지정 작업에 대한 이진 파일을 추출하고 실행합니다.

패키지 식별자는 명령줄 매개 변수를 /run 사용하여 Smsswd.exe.

사전 네트워크 파티션 및 사전 파티션 설정

디스크 파티션이 있고 네트워크 연결이 되기 전에 디스크 또는 네트워크 연결을 구성해야 하는 경우 이러한 작업을 수행할 애플리케이션을 만들어야 합니다. 애플리케이션은 Windows ADK(평가 및 배포 키트)를 사용하여 사용자 지정 부팅 이미지에 배치해야 합니다. 자세한 내용은 IT 전문가용 Windows ADK 시나리오를 참조하세요.

참고

부팅 이미지 파일에 파일을 추가하면 최소 RAM 요구 사항이 증가할 수 있으며 메모리 부족 조건으로 인해 작업 순서가 예기치 않은 방식으로 실패할 수 있습니다.

그런 다음 이미지를 사용자 지정 이미지로 Configuration Manager 가져옵니다. 자세한 내용은 부팅 이미지 추가를 참조하세요.

애플리케이션, 지원 파일 및 사용자 지정 SMSTS.INI Windows 폴더에 배치해야 합니다.

애플리케이션을 사용하려면 파티션 전/네트워크 단계가 포함된 작업 순서에서 사용자 지정 부팅 이미지를 사용합니다.

참고 항목

구성 관리자 사용자 지정 작업 정보

Configuration Manager 사용자 지정 작업 MOF 파일 정보