Arbeta med integreringsmoduler

Artikel
04/03/2024

Viktigt

Den här versionen av Service Management Automation (SMA) har nått slutet av supporten. Vi rekommenderar att du uppgraderar till SMA 2022.

En integreringsmodul är ett paket som innehåller en Windows PowerShell-modul. Information om hur du skriver en Windows PowerShell-modul finns i Skriva en Windows PowerShell-modul. En integreringsmodul kan innehålla någon av de giltiga modultyper som anges i Windows PowerShell moduler. Här ingår skriptmoduler (.psm1), binärmoduler (.dll) och manifestmoduler (.psd1). Integrationsmodulspaketet är en komprimerad fil med samma namn som modulen och med filnamnstillägget .zip. Den innehåller en enda mapp som också har samma namn som modulen. Windows PowerShell-modulen med eventuella underordnade filer, inklusive en manifestfilen (.psd1), om modulen har en sådan, måste finnas i den här mappen.

Om modulen ska innehålla en anslutningstyp måste den också innehålla en fil med namnet <ModuleName>-Automation.json som anger egenskaperna för anslutningstypen. Detta är en json-fil med följande format.

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

Stegen för att skapa och arbeta med Automation-runbooks skiljer sig åt beroende på om du använder en hanteringsportal eller Windows PowerShell. De grundläggande stegen för olika vanliga åtgärder som använder båda metoderna finns i följande avsnitt.

Räkna upp installerade moduler

Hämta en lista över installerade moduler i hanteringsportalen

Välj arbetsytan Automation .
Om du använder Azure väljer du ett Automation-konto.
Längst upp i fönstret väljer du Tillgångar.
Granska tillgångarna i listan med en typ av modul.

Hämta en lista över installerade moduler med hjälp av Windows PowerShell

Följande exempelkommandon hämtar alla moduler som är installerade i Automation.

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

Importera en modul

En modul är en komprimerad fil med ett .zip-tillägg som innehåller en mapp, som innehåller någon av följande filtyper:

En modul (psm1-fil)
Ett modulmanifest (psd1-fil)

Importera en modul med hjälp av hanteringsportalen

Välj arbetsytan Automation.
Längst ned i fönstret väljer du Importera modul.
Välj Bläddra efter Fil.
Välj modulfilen och välj OK.
Välj bockmarkeringsknappen i dialogrutan.

Importera en modul med Windows PowerShell

Följande exempelkommandon visar hur du importerar en modul.

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

Räkna upp aktiviteter i amModule

Hämta en lista över aktiviteter i en modul i hanteringsportalen

Välj arbetsytan Automation.
Om du använder Azure väljer du ett Automation-konto.
Längst upp i fönstret väljer du Tillgångar.
Leta upp modulen och välj den.
Rulla längst ned på skärmen Modulinformation och granska dess aktiviteter.
Du kan också välja förstoringsglasikonen för att filtrera efter vissa aktiviteter.

Hämta en lista över aktiviteter i en modul med hjälp av Windows PowerShell

Följande exempelkommandon visar hur du hämtar aktiviteterna i en viss modul.

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

Hämta en lista över aktiviteter i alla moduler med hjälp av Windows PowerShell

Följande exempelkommandon visar hur du hämtar aktiviteterna i alla moduler som är installerade i Automation.

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

Nästa steg

Läs mer om Service Management-automatisering.
Läs mer om runbook-åtgärder.

Dela via