Práce s moduly integrace

Článek
04/03/2024

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 kterýkoli 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 nich 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 používající obě metody jsou uvedeny v následujících částech.

Výčet nainstalovaných modulů

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

Vyberte pracovní prostor Automation .
Pokud používáte Azure, vyberte účet Automation.
V horní části okna vyberte Prostředky.
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

Vyberte pracovní prostor Automation.
V dolní části okna vyberte Importovat modul.
Vyberte Vyhledat soubor.
Vyberte soubor modulu a vyberte OK.
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

Výčet aktivit v amModule

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

Vyberte pracovní prostor Automation.
Pokud používáte Azure, vyberte účet Automation.
V horní části okna vyberte Prostředky.
Vyhledejte modul a vyberte jej.
Posuňte se do dolní části obrazovky Podrobnosti modulu a zkontrolujte její aktivity.
Volitelně můžete výběrem ikony lupy filtrovat 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

Přečtěte si další informace o automatizaci správy služeb.
Přečtěte si další informace o operacích runbooků.

Sdílet prostřednictvím