통합 모듈로 작업

아티클
04/03/2024

중요

이 버전의 SMA(서비스 관리 자동화)는 지원이 종료되었습니다. SMA 2022로 업그레이드하는 것이 좋습니다.

통합 모듈은 Windows PowerShell 모듈을 포함하는 패키지입니다. Windows PowerShell 모듈 작성에 대한 자세한 내용은 Windows PowerShell 모듈 작성을 참조하세요. 통합 모듈은 Windows PowerShell 모듈에 지정된 유효한 모듈 형식을 포함할 수 있습니다. 여기에는 스크립트 모듈(.psm1), 이진 모듈(.dll) 및 매니페스트 모듈(.psd1)이 포함됩니다. 통합 모듈 패키지는 모듈과 이름이 같고 확장명이 .zip인 압축 파일입니다. 여기에는 모듈과 이름이 같은 단일 폴더가 포함되어 있습니다. Windows PowerShell 모듈과 모듈에 있는 모든 지원 파일(매니페스트 파일(.psd1) 등)이 이 폴더에 포함되어야 합니다.

모듈에 연결 형식이 포함되어야 하는 경우 연결 형식 속성을 지정하는 ModuleName>-Automation.json 이름의 <파일도 포함되어야 합니다. 이는 다음과 같은 형식의 json 파일입니다.

{
   "ConnectionFields": [
   {
      "IsEncrypted":  false,
      "IsOptional":  false,
      "Name":  "ComputerName",
      "TypeName":  "System.String"
   },
   {
      "IsEncrypted":  false,
      "IsOptional":  true,
      "Name":  "Username",
      "TypeName":  "System.String"
   },
   {
      "IsEncrypted":  true,
      "IsOptional":  false,
      "Name":  "Password",
   "TypeName":  "System.String"
   }],
   "ConnectionTypeName":  "DataProtectionManager",
   "IntegrationModuleName":  "DataProtectionManager"
}

Automation Runbook을 만들고 사용하는 단계는 관리 포털을 사용하는지 또는 Windows PowerShell 사용하는지에 따라 다릅니다. 두 메서드를 모두 사용하는 다양한 일반적인 작업에 대한 기본 단계는 다음 섹션에서 제공합니다.

설치된 모듈 열거

관리 포털에서 설치된 모듈의 목록 가져오기

자동화 작업 영역을 선택합니다.
Azure를 사용하는 경우 Automation 계정을 선택합니다.
창 위쪽에서 자산을 선택합니다.
모듈 유형 목록에서 자산을 검사합니다.

Windows PowerShell을 사용하여 설치된 모듈 목록 가져오기

다음 샘플 명령은 Automation에 설치된 모든 모듈을 검색합니다.

$webServer = 'https://MyWebServer'
$port = 9090
Get-SmaModule -WebServiceEndpoint $webServer -Port $port

모듈 가져오기

모듈은 다음 파일 형식 중 하나를 포함하는 폴더를 포함하는 .zip 확장명의 압축 파일입니다.

모듈(psm1 파일)
모듈 매니페스트(psd1 파일)

관리 포털을 사용하여 모듈 가져오기

자동화 작업 영역을 선택합니다.
창 아래쪽에서 모듈 가져오기를 선택합니다.
파일 찾아보기를 선택합니다.
모듈 파일을 선택하고 확인을 선택합니다.
대화 상자에서 확인 표시 단추를 선택합니다.

Windows PowerShell을 사용하여 모듈 가져오기

다음 명령 예제는 모듈을 가져오는 방법을 보여 줍니다.

$webServer = 'https://MyWebServer'
$port = 9090
$modulePath = 'C:\Modules\MyModule.psm1'
Import-SmaModule -WebServiceEndpoint $webServer -Port $port -Path $modulePath

amModule에서 작업 열거

관리 포털에서 모듈의 작업 목록 가져오기

자동화 작업 영역을 선택합니다.
Azure를 사용하는 경우 Automation 계정을 선택합니다.
창 위쪽에서 자산을 선택합니다.
모듈을 찾아서 선택합니다.
모듈 세부 정보 화면 아래쪽으로 스크롤하여 작업을 검사합니다.
필요에 따라 돋보기 아이콘을 선택하여 특정 활동을 필터링합니다.

Windows PowerShell을 사용하여 모듈의 작업 목록 가져오기

다음 명령 예제는 특정 모듈의 작업을 검색하는 방법을 보여 줍니다.

$webServer = 'https://MyWebServer'
$port = 9090
$moduleName = 'MyModule'
$module = Get-SmaModule -WebServiceEndpoint $webServer -Port $port -Name $moduleName
$module.Activities

Windows PowerShell을 사용하여 모든 모듈의 작업 목록 가져오기

다음 샘플 명령은 Automation에 설치된 모든 모듈에서 활동을 검색하는 방법을 보여 줍니다.

$webServer = 'https://MyWebServer'
$port = 9090
$modules = Get-SmaModule -WebServiceEndpoint $webServer -Port $port
$modules | foreach {$_.Activities} | sort Name,ModuleName | ft Name,ModuleName,Description

다음 단계

Service Management Automation에 대해 자세히 알아보세요.
Runbook 작업에 대해 자세히 알아보세요.

Share via