Arbeta med integreringsmoduler

  • Artikel
  • 2 minuter för att läsa

Viktigt

Den här versionen 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 alla 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. I följande avsnitt visas de grundläggande stegen för några vanliga åtgärder som kan utföras med båda metoderna.

Räkna upp installerade moduler

Hämta en lista över installerade moduler i hanteringsportalen

  1. Välj arbetsytan Automation .

  2. Om du använder Azure måste du välja ett Automation-konto.

  3. Klicka på Tillgångar längst upp i fönstret.

  4. 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 filtillägget .zip som innehåller en mapp med en av följande filtyper:

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

Importera en modul med hanteringsportalen

  1. Välj arbetsytan Automation.

  2. Klicka på Importera modul längst ned i fönstret.

  3. Klicka på Bläddra efter fil.

  4. Välj modulfilen och klicka på OK.

  5. Klicka på knappen med en bock 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

  1. Välj arbetsytan Automation.

  2. Om du använder Azure måste du välja ett Automation-konto.

  3. Klicka på Tillgångar längst upp i fönstret.

  4. Leta upp modulen och välj den.

  5. Rulla längst ned på skärmen Modulinformation och granska dess aktiviteter.

  6. Alternativt kan du klicka på förstoringsglasikonen om du vill filtrera enligt 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