Работа с модулями интеграции

Статья
11/01/2024

Модуль интеграции — это пакет, содержащий модуль 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"
}

Действия по созданию и работе с модулями Runbook службы автоматизации отличаются в зависимости от того, используете ли вы портал управления или Windows PowerShell. Основные шаги для различных распространенных операций с использованием обоих методов приведены в следующих разделах.

Перечисление установленных модулей

Получение списка установленных модулей на портале управления

Выберите рабочую область Автоматизация .
Если вы используете Azure, выберите учетную запись службы автоматизации.
В верхней части окна выберите "Активы".
Проверьте ресурсы в списке с типом модуля.

Получение списка установленных модулей с помощью Windows PowerShell

В следующих примерах команд извлекаются все модули, установленные в службе автоматизации.

$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, выберите учетную запись службы автоматизации.
В верхней части окна выберите "Активы".
Найдите модуль и выберите его.
Прокрутите страницу вниз экрана сведений о модуле и проверьте его действия.
При необходимости выберите значок с увеличением стекла, чтобы отфильтровать определенные действия.

Получение списка действий в модуле с помощью Windows PowerShell

В следующих примерах команд показано, как получить действия в определенном модуле.

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

Получение списка действий во всех модулях с помощью Windows PowerShell

В следующих примерах команд показано, как получить действия во всех модулях, установленных в службе автоматизации.

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

Следующие шаги

Дополнительные сведения об автоматизации управления службами.
Дополнительные сведения об операциях Runbook.

Поделиться через