Praca z modułami integracji

Artykuł
04/03/2024

Ważne

Ta wersja programu Service Management Automation (SMA) osiągnęła koniec wsparcia technicznego. Zalecamy uaktualnienie do wersji SMA 2022.

Moduł integracji to pakiet zawierający moduł Windows PowerShell. Aby uzyskać informacje na temat pisania modułu Windows PowerShell, zobacz Pisanie modułu Windows PowerShell. Moduł integracji może zawierać dowolne z prawidłowych typów modułów określonych w modułach Windows PowerShell. Obejmuje to moduły skryptu (psm1), moduły binarne (dll) i moduły manifestu (psd1). Pakiet modułu integracji to skompresowany plik mający taką samą nazwę jak określony moduł oraz rozszerzenie zip. Zawiera on pojedynczy folder, również mający nazwę modułu. W tym folderze musi znajdować się m oduł programu Windows PowerShell oraz wszelkie pliki pomocnicze, włącznie z plikiem manifestu (psd1), jeśli moduł go posiada.

Jeśli moduł powinien zawierać typ połączenia , musi również zawierać plik o nazwie <ModuleName>-Automation.json który określa właściwości typu połączenia. Jest to plik json o następującym formacie.

{
   "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"
}

Kroki tworzenia i pracy z elementami Runbook usługi Automation różnią się w zależności od tego, czy używasz portalu zarządzania, czy Windows PowerShell. Podstawowe kroki dla różnych typowych operacji przy użyciu obu metod przedstawiono w poniższych sekcjach.

Wyliczanie zainstalowanych modułów

Pobieranie listy zainstalowanych modułów w portalu zarządzania

Wybierz obszar roboczy automatyzacji .
Jeśli używasz platformy Azure, wybierz konto usługi Automation.
W górnej części okna wybierz pozycję Zasoby.
Sprawdź zasoby na liście przy użyciu typu modułu.

Pobieranie listy zainstalowanych modułów przy użyciu Windows PowerShell

Następujące przykładowe polecenia pobierają wszystkie moduły zainstalowane w usłudze Automation.

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

Importowanie modułu

Moduł to skompresowany plik z rozszerzeniem .zip zawierającym folder, który zawiera jeden z następujących typów plików:

Moduł (plik psm1)
Manifest modułu (plik psd1)

Importowanie modułu przy użyciu portalu zarządzania

Wybierz obszar roboczy automatyzacji.
W dolnej części okna wybierz pozycję Importuj moduł.
Wybierz pozycję Przeglądaj w polu Plik.
Wybierz plik modułu i wybierz przycisk OK.
Wybierz przycisk znacznika wyboru w oknie dialogowym.

Importowanie modułu przy użyciu Windows PowerShell

Następujące przykładowe polecenia pokazują, jak zaimportować moduł.

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

Wyliczanie działań w module amModule

Pobieranie listy działań w module w portalu zarządzania

Wybierz obszar roboczy automatyzacji.
Jeśli używasz platformy Azure, wybierz konto usługi Automation.
W górnej części okna wybierz pozycję Zasoby.
Znajdź moduł i zaznacz go.
Przewiń w dół ekranu Szczegóły modułu i sprawdź jego działania.
Opcjonalnie wybierz ikonę lupy, aby filtrować konkretne działania.

Pobieranie listy działań w module przy użyciu Windows PowerShell

Następujące przykładowe polecenia pokazują, jak pobrać działania znajdujące się w konkretnym module.

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

Pobieranie listy działań we wszystkich modułach przy użyciu Windows PowerShell

Następujące przykładowe polecenia pokazują, jak pobrać działania we wszystkich modułach zainstalowanych w usłudze Automation.

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

Następne kroki

Dowiedz się więcej o automatyzacji zarządzania usługami.
Dowiedz się więcej o operacjach elementów Runbook.

Share via