Werken met integratiemodules

Artikel
04/03/2024

Belangrijk

Deze versie van Service Management Automation (SMA) heeft het einde van de ondersteuning bereikt. U wordt aangeraden een upgrade uit te voeren naar SMA 2022.

Een integratiemodule is een pakket dat een Windows PowerShell-module bevat. Zie Een Windows PowerShell-module schrijven voor meer informatie over het schrijven van een Windows PowerShell-module. Een integratiemodule kan een van de geldige moduletypen bevatten die zijn opgegeven in Windows PowerShell Modules. Dit omvat scriptmodules (.psm1), binaire modules (.dll) en manifestmodules (.psd1). Het integratiemodulepakket is een gecomprimeerd bestand met dezelfde naam als de module en met een .zip-extensie. Het bevat een enkele map die ook de naam van de module heeft. De Windows PowerShell-module en de bijbehorende bestanden, met inbegrip van een eventueel manifestbestand (.psd1), moeten zich in deze map bevinden.

Als de module een verbindingstype moet bevatten, moet deze ook een bestand bevatten met de naam <ModuleNaam>-Automation.json waarmee de eigenschappen van het verbindingstype worden opgegeven. Dit is een json-bestand met de volgende indeling.

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

De stappen voor het maken en werken met Automation-runbooks zijn afhankelijk van of u een beheerportal gebruikt of Windows PowerShell. De basisstappen voor verschillende algemene bewerkingen met beide methoden worden in de volgende secties gegeven.

Geïnstalleerde modules opsommen

Een lijst met geïnstalleerde modules ophalen in de beheerportal

Selecteer de Automation-werkruimte .
Als u Azure gebruikt, selecteert u een Automation-account.
Selecteer Assets boven aan het venster.
Inspecteer de assets in de lijst met een type module.

Een lijst met geïnstalleerde modules ophalen met behulp van Windows PowerShell

Met de volgende voorbeeldopdrachten worden alle modules opgehaald die in Automation zijn geïnstalleerd.

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

Een module importeren

Een module is een gecomprimeerd bestand met een .zip extensie die een map bevat die een van de volgende bestandstypen bevat:

Een module (psm1-bestand)
Een module-manifest (psd1-bestand)

Een module importeren met behulp van de beheerportal

Selecteer de Automation-werkruimte.
Selecteer onder in het venster Module importeren.
Selecteer Bladeren naar bestand.
Selecteer het modulebestand en selecteer OK.
Selecteer het vinkje in het dialoogvenster.

Een module importeren met behulp van Windows PowerShell

De volgende voorbeeldopdrachten tonen hoe een module te importeren.

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

Activiteiten opsommen in amModule

Een lijst met activiteiten ophalen in een module in de beheerportal

Selecteer de Automation-werkruimte.
Als u Azure gebruikt, selecteert u een Automation-account.
Selecteer Assets boven aan het venster.
Zoek de module en selecteer deze.
Schuif naar de onderkant van het scherm Moduledetails en inspecteer de activiteiten.
Selecteer desgewenst het vergrootglaspictogram om te filteren op bepaalde activiteiten.

Een lijst met activiteiten in een module ophalen met behulp van Windows PowerShell

De volgende voorbeeldopdrachten tonen hoe de activiteiten in een bepaalde module op te halen.

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

Een lijst met activiteiten in alle modules ophalen met behulp van Windows PowerShell

De volgende voorbeeldopdrachten laten zien hoe u de activiteiten ophaalt in alle modules die in Automation zijn geïnstalleerd.

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

Volgende stappen

Meer informatie over servicebeheerautomatisering.
Meer informatie over runbookbewerkingen.

Delen via