Praca z modułami integracji

Artykuł
11/01/2024

Moduł integracji to pakiet zawierający moduł programu Windows PowerShell. Aby uzyskać informacje na temat pisania modułu programu Windows PowerShell, zobacz Pisanie modułu programu Windows PowerShell. Moduł integracji może zawierać dowolne z prawidłowych typów modułów określonych w modułach programu Windows PowerShell. Obejmuje to moduły skryptów (psm1), moduły binarne (.dll) i moduły manifestu (psd1). Pakiet modułu integracji to skompresowany plik o takiej samej nazwie jak moduł i rozszerzenie .zip. Zawiera on również jeden folder o nazwie modułu. Moduł programu Windows PowerShell i wszystkie pliki pomocnicze, w tym plik manifestu (psd1), jeśli moduł ma plik, muszą znajdować się w tym folderze.

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 programu Windows PowerShell. Podstawowe kroki dla różnych typowych operacji przy użyciu obu metod znajdują się 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 programu 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 zawierający 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 programu Windows PowerShell

Poniższe 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 trybie 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 wybierz 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 programu Windows PowerShell

Poniższe przykładowe polecenia pokazują, jak pobrać działania w określonym 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 programu Windows PowerShell

Poniższe 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.

Udostępnij za pośrednictwem