Práce s moduly integrace

  • Článek

Důležité

Tato verze služby Service Management Automation (SMA) dosáhla konce podpory. Doporučujeme upgradovat na SMA 2022.

Modul integrace je balíček, který obsahuje modul Windows PowerShell. Informace o psaní modulu Windows PowerShell najdete v tématu Psaní modulu Windows PowerShell. Modul integrace může obsahovat libovolný z platných typů modulů zadaných v modulech Windows PowerShell. Patří sem moduly skriptu (.psm1), binární moduly (.dll) a moduly manifestu (.psd1). Balíček modulu integrace je komprimovaný soubor se stejným názvem jako modul a má příponu .zip. Obsahuje jednu složku taky s názvem modulu. Modul prostředí Windows PowerShell a všechny podpůrné soubory včetně souboru manifestu (.psd1), pokud modul nějaký má, musí být v této složce.

Pokud by modul měl obsahovat typ připojení , musí obsahovat také soubor s názvem <ModuleName-Automation.json>, který určuje vlastnosti typu připojení. Toto je soubor json v následujícím formátu.

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

Postup vytváření runbooků Automation a práce s runbooky se liší v závislosti na tom, jestli používáte portál pro správu, nebo Windows PowerShell. Základní kroky pro různé běžné operace pomocí obou metod jsou uvedeny v následujících částech.

Zobrazení výčtu nainstalovaných modulů

Získání seznamu nainstalovaných modulů na portálu pro správu

  1. Vyberte pracovní prostor Automation .

  2. Pokud používáte Azure, vyberte účet Automation.

  3. V horní části okna vyberte Prostředky.

  4. Zkontrolujte prostředky v seznamu pomocí typu modulu.

Získání seznamu nainstalovaných modulů pomocí Windows PowerShell

Následující ukázkové příkazy načtou všechny moduly nainstalované ve službě Automation.

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

Import modulu

Modul je komprimovaný soubor s příponou .zip, který obsahuje složku, která obsahuje jeden z následujících typů souborů:

  • Modul (soubor psm1),
  • Modul manifestu (soubor psd1).

Import modulu pomocí portálu pro správu

  1. Vyberte pracovní prostor Automation.

  2. V dolní části okna vyberte Importovat modul.

  3. Vyberte Vyhledat soubor.

  4. Vyberte soubor modulu a vyberte OK.

  5. V dialogovém okně vyberte tlačítko zaškrtnutí.

Import modulu pomocí Windows PowerShell

Následující vzorové příkazy znázorňují postup importování modulu.

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

Vytvoření výčtu aktivit v modulu amModule

Získání seznamu aktivit v modulu na portálu pro správu

  1. Vyberte pracovní prostor Automation.

  2. Pokud používáte Azure, vyberte účet Automation.

  3. V horní části okna vyberte Prostředky.

  4. Vyhledejte modul a vyberte jej.

  5. Posuňte se do dolní části obrazovky Podrobnosti modulu a prozkoumejte její aktivity.

  6. Volitelně můžete vybrat ikonu lupy a vyfiltrovat konkrétní aktivity.

Získání seznamu aktivit v modulu pomocí Windows PowerShell

Následující vzorové příkazy znázorňují postup načtení aktivit z konkrétního modulu.

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

Získání seznamu aktivit ve všech modulech pomocí Windows PowerShell

Následující ukázkové příkazy ukazují, jak načíst aktivity ve všech modulech nainstalovaných ve službě Automation.

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

Další kroky