Práce s moduly integrace

Článek
11/01/2024

Modul integrace je balíček, který obsahuje modul Windows PowerShellu. Informace o psaní modulu Windows PowerShellu najdete v tématu Vytvoření modulu Windows PowerShellu. Modul integrace může obsahovat libovolný z platných typů modulů zadaných v modulech Windows PowerShellu. To zahrnuje moduly skriptů (.psm1), binární moduly (.dll) a moduly manifestu (.psd1). Balíček modulu integrace je komprimovaný soubor se stejným názvem jako modul a příponou .zip. Obsahuje také jednu složku s názvem modulu. Modul Windows PowerShellu a všechny podpůrné soubory, včetně souboru manifestu (.psd1), pokud modul obsahuje, musí být obsaženy 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í. Jedná se o soubor JSON s následujícím formátem.

{
   "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í a práce s runbooky Automation 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

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 PowerShellu

Následující ukázkové příkazy načítají 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)
Manifest modulu (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 PowerShellu

Následující ukázkové příkazy ukazují, jak importovat modul.

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

Vytvoření výčtu 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 ho.
Posuňte se do dolní části obrazovky Podrobnosti modulu a prohlédněte si její aktivity.
Volitelně můžete výběrem ikony lupy filtrovat konkrétní aktivity.

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

Následující ukázkové příkazy ukazují, jak načíst aktivity v konkrétním 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 PowerShellu

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