명령줄 작업 마법사
명령줄 작업 마법사를 사용하면 명령, 인수 및 매개 변수를 Microsoft .NET 어셈블리(.DLL)로 캡슐화하여 Orchestrator에서 새 활동을 빠르게 만들 수 있습니다. 마법사는 Orchestrator SDK를 사용하여 C# 소스 코드를 자동으로 만들고 자동으로 컴파일합니다. 이 어셈블리를 사용하면 .NET 통합 팩(통합 도구 키트의 일부)을 활용하여 활동을 테스트한 다음, 통합 팩 마법사를 사용하여 다른 통합 팩과 마찬가지로 배포 및 배포할 수 있는 사용자 지정 통합 팩으로 어셈블리를 패키저닝할 수 있습니다.
어셈블리는 하나 이상의 작업(명령)을 포함할 수 있으며, 활동은 하나 이상의 사용 가능한 명령 유형(명령, 명령줄, PowerShell 또는 SSH 명령)일 수 있습니다. 작업 이름, 명령 구조, 입력 매개 변수 및 게시된 데이터(출력)를 정의합니다.
Orchestrator의 활동 개요
작업은 Orchestrator Runbook의 단일 기능 부분입니다. 활동은 Runbook 내에서 실제 작업을 수행하고 워크플로 분기를 만들기 위한 조건으로 정의할 수 있는 링크를 사용하여 함께 조인됩니다. Runbook Designer를 사용하여 Runbook을 빌드할 때 활동 창에서 Runbook으로 활동을 끌어서 놓고 함께 연결하여 워크플로를 구성합니다. Runbook이 실행되면 연결된 방식에 따라 각 활동을 순서대로 호출합니다. 각 작업은 특정 작업을 수행하고 Orchestrator 데이터 버스에서 입력 데이터를 수집하고 출력을 동일한 데이터 버스에 게시할 수 있습니다. 각 활동에는 Runbook에서 이전에 실행된 활동에서 게시된 데이터를 그릴 수 있으며 출력 데이터를 게시하면 다음 활동에서 액세스할 수 있습니다.
활동 범위는 단순에서 복합까지입니다. 명령줄 작업 마법사를 사용하여 텍스트를 출력 속성에 에코하는 작업을 만들 수 있습니다. 가상 머신 배포와 같은 복잡한 다단계 작업을 수행하는 단일 작업을 만들 수도 있습니다. 각 활동이 수행할 작업을 정의하는 것은 사용자의 달려 있습니다. 그러나 목표는 다양한 유형의 상황에서 쉽게 재사용할 수 있는 단일 기능 집합을 캡슐화하는 활동을 정의하는 것입니다. 핵심은 유연성입니다. 특정 개별 시나리오를 해결하기 위해 20개의 다른 활동을 만드는 대신 각각 특정 작업을 수행하고 20가지 방법으로 해당 활동을 사용할 수 있는 10가지 활동 집합을 만드는 것이 좋습니다. 모범 사례에 대한 자세한 내용은 이 문서의 뒷부분에서 설명합니다.
새 작업 어셈블리 만들기
다음 단계에 따라 새 명령줄 작업 어셈블리를 만듭니다.
모든 프로그램 > 시작 > Microsoft System Center 2012 > Orchestrator > Integration Toolkit > Orchestrator 명령줄 작업 마법사 선택
다음을 선택합니다.
어셈블리 세부 정보 페이지에서 문자로 시작하고 0개 이상의 영숫자 문자 뒤에 있는 이름 값을 입력합니다. 이 이름은 어셈블리 및 작업에 대한 C# 네임스페이스 식별자로 사용됩니다.
어셈블리 파일에 이 마법사에서 만들 어셈블리 파일의 경로와 파일 이름을 입력합니다. 이 파일이 이미 있는 경우 파일을 덮어쓰라는 메시지가 표시됩니다.
어셈블리 정보를 선택합니다. 파일 속성을 통해 Windows 탐색기에 표시되는 어셈블리 파일의 속성이 될 정보를 여기에 입력할 수 있습니다. 속성 값은 아래 표에 정의되어 있습니다. 이 정보는 선택 사항이며 어셈블리를 빌드하는 데 필요하지 않습니다.
속성 설명 타이틀 Windows 탐색기 속성에서 파일 설명 속성으로 표시되는 어셈블리의 제목을 지정합니다. 설명 Windows 탐색기 속성에 표시되지 않는 어셈블리에 대한 선택적 설명을 지정합니다. Product Windows 탐색기 속성에서 제품 이름 속성으로 표시되는 어셈블리의 제품 이름을 지정합니다. 회사 Windows 탐색기 속성에 표시되지 않는 어셈블리의 회사 이름을 지정합니다. Copyright Windows 탐색기 속성에서 저작권으로 표시되는 어셈블리에 대한 저작권 알림을 지정합니다. 상표 Windows 탐색기 속성에서 법적 상표로 표시되는 어셈블리의 상표를 지정합니다 . 버전 어셈블리 버전 및 파일 버전을 지정합니다. 이러한 속성은 Windows 탐색기 속성에 파일 버전 및 제품 버전으로 표시됩니다.
버전 번호는 다음과 같이 네 부분으로 구성됩니다.
<주 버전>.<부 버전>.<빌드 번호>.<수정>어셈블리 정보 입력을 마쳤으면 확인을 선택합니다.
다음을 선택합니다. 명령 페이지가 표시됩니다.
어셈블리에 명령 추가에 제공된 지침에 따라 하나 이상의 명령을 추가합니다.
활동의 정의를 완료하면 확인을 선택합니다. 대화 상자가 닫히면 새 활동이 명령 페이지의 목록에 추가됩니다 . 돌아가서 명령을 편집해야 하는 경우 목록에서 명령을 선택하고 편집을 선택합니다. 명령을 삭제해야 하는 경우 목록에서 명령을 선택하고 제거를 선택합니다.
명령 추가 및 수정을 마쳤으면 다음을 선택합니다. 마법사의 시작 부분에 지정된 어셈블리 파일이 컴파일되고 프로세스가 완료되면 최종 마법사 페이지가 표시됩니다.
이 새 어셈블리에서 통합 팩을 즉시 빌드하려면 통합 팩 마법사를 시작하고 어셈블리에서 정보를 미리 로드하는 통합 팩 빌드 단추를 선택합니다. 그런 다음 새 통합 팩 만들기의 지침에 따라 통합 팩 을 만듭니다.
.NET 호출 작업을 사용하여 어셈블리를 테스트하거나 지금은 IP 빌드 프로세스를 건너뛰려면 마침을 선택합니다.
어셈블리에 명령 추가
어셈블리에 명령을 추가하려면 다음 단계를 수행합니다.
명령 페이지에서 어셈블리에 추가될 하나 이상의 명령(활동이 되는)을 정의할 수 있습니다. 새 명령을 추가하려면 추가를 선택합니다.
명령 추가/편집 대화 상자는 일반, 인수 및 게시된 데이터의 세 가지 탭을 표시하고 포함합니다. 명령의 이름을 입력합니다. 이 이름은 활동의 Runbook Designer에 표시되는 이름이 됩니다. 필요에 따라 명령에 대한 설명을 입력할 수도 있습니다.
Mode 속성 선택기는 명령 실행, Windows PowerShell 실행, 프로그램 실행 및 SSH 명령 실행의 네 가지 옵션을 포함합니다. 프로그램 실행 모드를 선택하면 프로그램 필드가 활성화됩니다. 줄임표 단추(...)를 선택하고 실행하려는 프로그램을 찾습니다.
참고 항목
프로그램 실행 명령에서 선택한 프로그램은 이 활동이 포함된 Runbook이 실행되는 Runbook Server에서 호출됩니다. 따라서 이 프로그램은 Runbook을 실행할 것으로 예상되는 모든 Runbook 서버에 있어야 합니다.
인수 탭을 선택합니다.
명령줄 필드에 활동에 필요한 명령줄 매개 변수를 입력합니다. 명령에서 사용자가 지정하려는 매개 변수를 사용하는 경우 아래 매개 변수 목록에 해당 매개 변수를 추가한 다음 삽입 단추를 사용하여 명령줄에 추가해야 합니다.
Important
모드에 대해 Windows PowerShell 실행을 지정하고 통합 팩에 포함된 PowerShell 스크립트를 참조하는 경우 로컬 디렉터리를 참조하려면 스크립트 이름 앞에 점 및 슬래시 문자가 있어야 합니다. 예를 들어 .\MyScript.ps1은 MyScript.ps1이라는 스크립트에 대해 지정됩니다. 이는 스크립트 파일이 통합 팩의 기본 디렉터리에 복사되기 때문입니다. Windows PowerShell이 로컬 디렉터리에서 스크립트를 실행하는 경우 이 표기법을 지정해야 합니다.
명령줄에 대한 매개 변수를 제공하려면 추가를 선택합니다. 매개 변수 추가/편집 대화 상자가 나타납니다.
이름 필드에 추가할 매개 변수의 이름을 입력합니다. 작업의 속성 목록에 표시된 매개 변수의 표시 이름입니다.
사용 모드 드롭다운 목록에서 매개 변수에 사용할 모드를 선택합니다. 사용 모드에는 다음 두 가지 옵션이 있습니다.
사용 모드 설명 명령 인수 이 인수를 명령줄 내에서 매개 변수로 사용하려면 선택합니다(삽입 단추 사용). 예를 들어 다음과 같이 명령줄에 "Folder"라는 명령 인수 매개 변수를 배치할 수 있습니다.
Dir $(folder)메모: 명령줄 인수에 공백(예: 폴더 이름)이 포함된 경우 명령이 제대로 작동하려면 따옴표로 묶어야 할 수 있습니다. 예:Dir "$(folder)"환경 변수 명령줄을 실행하기 전에 설정되는 환경 변수로 이 인수를 사용하려면 선택합니다. 명령줄 매개 변수로 사용하거나 실행되는 스크립트 내에서 환경 변수로 사용할 수 있습니다.
예를 들어 다음과 같이 명령줄에 "Folder"라는 환경 변수 매개 변수를 배치할 수 있습니다.
Dir %Folder%중요하다: 사용자 또는 시스템 환경에 환경 변수 이름이 이미 있습니다. 이 명령은 다음과 유사한 오류 메시지와 함께 실패합니다. 항목이 이미 추가되었습니다. 사전의 키: 추가 중인 'folder' 키: 'folder'. 실행 시작을 선택하고 입력하여 로컬 또는 원격 컴퓨터에 존재하는 환경 변수를 확인할 수 있습니다MSINFO32.EXE.> 그런 다음 소프트웨어 환경 환경 > 변수를 선택합니다. 다른 컴퓨터를 선택하려면 Ctrl+R>을 누르<고, 네트워크에서 원격 컴퓨터를 선택하고, 컴퓨터 이름을 입력하고, 확인을 선택합니다.표시 스타일 드롭다운 목록에서 매개 변수를 표시하는 데 사용할 스타일을 선택합니다. 표시 스타일은 사용자가 입력을 표시할 때 입력과 상호 작용하는 방법을 결정합니다. 선택 항목은 아래에 설명되어 있습니다.
표시 스타일 설명 Text 사용자에게 값을 입력하기 위한 자유 형식 텍스트 상자가 표시됩니다. 암호화된 텍스트 사용자에게 마스킹된 텍스트 상자가 표시됩니다. 이 필드의 데이터는 데이터베이스 내에서 암호화되며 로그에 표시되지 않습니다. 참/거짓 팝업 대화 상자에서 True 또는 False를 선택할 수 있습니다. 선택 영역이 있는 텍스트 사용자가 지정한 옵션 그룹에서 선택할 수 있습니다. 날짜/시간 사용자는 날짜/시간 선택 컨트롤을 사용하여 값을 선택할 수 있습니다. 파일 사용자는 파일 브라우저 컨트롤을 사용하여 값을 선택할 수 있습니다. 폴더 사용자는 폴더 브라우저 컨트롤을 사용하여 값을 선택할 수 있습니다. 컴퓨터 사용자는 컴퓨터 브라우저 컨트롤을 사용하여 값을 선택할 수 있습니다. 매개 변수가 필요하거나 기본값을 제공하려는 경우 기본값 필드에 입력합니다.
선택 영역이 있는 텍스트를 선택한 경우 옵션 필드가 활성화됩니다. 사용자가 선택할 수 있는 옵션 값을 추가하려면 옵션 필드 옆에 있는 줄임표 단추를 선택하고 입력합니다. 각 옵션은 별도의 줄에 나열됩니다. 옵션 추가를 마쳤으면 [확인]을 선택합니다.
매개 변수 정의를 마쳤으면 확인을 선택합니다.
명령 매개 변수로 정의된 경우 이제 명령줄의 원하는 삽입 지점에 커서를 놓은 다음 삽입 단추를 선택하고 매개 변수 이름을 선택하여 명령줄에 매개 변수를 추가할 수 있습니다. 환경 변수로 정의된 경우 명령줄에서 변수를 원하는 경우 변수를 수동으로 입력해야 합니다(%variable%형식).
프로그램 실행 또는 명령줄 실행 모드를 선택한 경우 작업 디렉터리 매개 변수 포함 확인란을 사용할 수 있습니다.
게시된 데이터 탭을 선택합니다. 이 탭의 설정을 사용하면 다른 활동이 정보를 사용할 수 있도록 출력 데이터를 Orchestrator 데이터 버스에 게시할 수 있습니다.
게시된 새 데이터 속성을 추가하려면 추가를 선택합니다.
명령 추가/편집 대화 상자의 일반 탭에 있는 모드 드롭다운 목록에서 명령 실행, 프로그램 실행 또는 SSH 명령 실행 옵션을 선택한 경우 게시된 데이터 추가/편집 대화 상자에 다음 항목이 표시됩니다.
항목 설명 이름 만드는 게시된 데이터 항목의 표시 이름 Source 게시된 데이터 항목의 원본입니다. 명령줄에서 표준 출력 스트림 또는 표준 오류 스트림 중에서 선택할 수 있습니다. 모드 게시된 데이터를 선택하는 데 사용할 모드입니다.
일치 패턴을 사용하여 원본 내에서 지정된 패턴이 있는지 확인합니다. 그러면 True 또는 False가 반환됩니다.
그룹 추출을 사용하여 지정한 패턴과 일치하는 데이터의 각 항목을 검색합니다.패턴 모드 설정에 적용되는 정규식 설명 Runbook Designer에서 게시된 데이터 속성 옆에 표시되는 설명 텍스트입니다. (선택 사항) 명령 추가/편집 대화 상자의 일반 탭에 있는 모드 드롭다운 목록에서 Windows PowerShell 실행 옵션을 선택한 경우 게시된 데이터 추가/편집 대화 상자에 다음 항목이 표시됩니다.
항목 설명 이름 만드는 게시된 데이터 항목의 표시 이름 속성 게시된 데이터 항목에 저장할 Windows PowerShell 속성의 이름입니다. 이 속성은 스크립트 중에 PowerShell 파이프라인에 대한 개체 출력에 포함되어야 하며 개체가 아니어야 합니다(문자열로 변환할 수 있어야 합니다). 설명 Runbook Designer에서 게시된 데이터 속성 옆에 표시되는 설명 텍스트입니다. (선택 사항) [확인]을 선택하여 게시된 데이터 항목 추가를 완료합니다. 추가하려는 각 게시된 데이터 항목에 대해 16-18단계를 반복합니다.
[확인]을 선택하여 명령 추가/편집 대화 상자를 닫고 명령 대화 상자로 돌아갑니다.
활동 어셈블리 테스트
어셈블리를 만든 후에는 .NET용 Integration Toolkit IP에 포함된 Invoke .NET 작업을 사용하여 테스트하여 사용자 지정 통합 팩으로 변환하기 전에 예상대로 작동하는지 확인할 수 있습니다.
어셈블리 테스트
다음 단계에 따라 어셈블리를 테스트합니다.
Runbook Designer를 엽니다.
새 Runbook을 만듭니다.
작업 창에서 Integration Toolkit 범주를 선택하여 확장하고 .NET 작업 호출을 새 Runbook으로 끌어옵니다.
.NET 호출 개체를 두 번 클릭하여 속성 대화 상자를 봅니다.
어셈블리 필드에서 필드 오른쪽에 있는 줄임표 단추(...)를 선택하여 명령줄 작업 마법사(또는 SDK를 사용하여 사용자 지정 개발을 통해)를 사용하여 만든 어셈블리 파일을 찾습니다. 파일을 선택하고 열기를 선택합니다.
클래스 필드 오른쪽에 있는 줄임표 단추를 선택하여 어셈블리의 개별 명령 목록을 봅니다. 명령 클래스를 선택하고 확인을 선택합니다. 이 클래스의 매개 변수는 대화 상자의 속성 탭에 나타납니다.
설치 필드는 OrchestratorData 특성이 있는 Orchestrator SDK를 사용하여 사용자 지정 개발 클래스에서만 사용됩니다. SDK에 대한 자세한 내용은 System Center Orchestrator Integration Toolkit SDK를 참조 하세요.
속성 탭을 선택합니다.
필요에 따라 각 속성에 대한 정보를 제공합니다.
마침을 선택하여 설정을 저장하고 Runbook으로 돌아갑니다.
Runbook Designer의 도구 모음에서 Runbook Tester를 선택합니다. Runbook Tester가 시작됩니다.
도구 모음에서 중단점까지 실행을 선택합니다. Runbook이 시작되고 작업이 실행됩니다. 활동 결과는 실행 로그 창에 표시됩니다.
실행 로그 창의 활동 이름 아래에 세부 정보 표시를 선택하여 입력 속성 및 게시된 데이터를 비롯한 자세한 결과를 확인합니다.
QIK CLI 활동 마이그레이션
Opalis 6.3 QIK CLI 마법사를 사용하여 만든 어셈블리가 있는 경우 오케스트레이터 통합 팩에서 사용하거나 .NET 호출 작업을 통해 Runbook에서 직접 사용하기 전에 Orchestrator와 호환되도록 변환해야 합니다. 변환 프로세스는 간단하며 어셈블리당 몇 초밖에 걸리지 않습니다.
Important
Microsoft .NET Framework 3.5, 서비스 팩 1이 설치되지 않은 경우 Orchestrator Integration Toolkit에 대한 설치가 실패하지 않지만 명령줄 작업 마법사의 다른 작업이 없는 경우 실패합니다. CLI를 사용하기 전에 Microsoft .NET Framework 3.5 서비스 팩 1이 설치되어 있는지 확인합니다.
Opalis QIK CLI 어셈블리 변환
다음 단계에 따라 Opalis QIK CLI 어셈블리를 변환합니다.
모든 프로그램 시작 Microsoft System Center 2012 > 오케스트레이터 명령줄 작업 마법사를 선택하여 오케스트레이터 > 명령줄 작업 마법사를 시작 > 합니다>.
마법사가 로드되면 첫 번째 페이지에서 기존 어셈블리 로드 단추를 선택합니다.
기존 어셈블리 파일을 선택한 다음 열기를 선택합니다. 어셈블리의 이름과 파일 위치가 표시됩니다.
변경 내용이 새 파일에 저장되도록 파일 경로를 수정합니다. 필요한 경우 어셈블리의 이름을 변경할 수도 있습니다.
어셈블리 정보 세부 정보를 추가로 변경해야 하는 경우 어셈블리 정보 단추를 선택하고 변경합니다. 작업이 완료되면 확인을 선택하여 어셈블리 세부 정보 페이지로 돌아갑니다.
다음을 선택하여 명령 페이지로 이동합니다. 어셈블리에 이전에 정의된 명령 목록이 표시됩니다. 필요한 경우 명령을 검토하고 다음을 선택하여 어셈블리 빌드 페이지로 계속 진행 합니다.
새 어셈블리가 빌드되고 이전에 정의한 경로 및 파일 이름을 사용하여 저장됩니다.
이제 .NET 호출 작업을 사용하여 Runbook에서 새 Orchestrator 호환 어셈블리를 사용하거나 통합 팩 빌드 단추를 선택하여 이 어셈블리에서 통합 팩을 빌드할 수 있습니다. 현재 IP를 빌드하지 않으려면 닫기를 선택하여 마법사를 종료합니다.
오케스트레이터 리소스
System Center 2012 Orchestrator에 제공된 이 온라인 참조 외에도 Integration Toolkit 및 모범 사례를 사용하여 Runbook 빌드에 대한 추가 정보를 제공할 수 있는 다양한 리소스가 있습니다.