Teilen über

Arbeiten mit Integrationsmodulen

  • Artikel

Wichtig

Diese Version von Service Management Automation (SMA) hat das Ende des Supports erreicht. Es wird empfohlen, ein Upgrade auf SMA 2022 durchzuführen.

Ein Integrationsmodul ist ein Paket, das ein Windows PowerShell Modul enthält. Informationen zum Erstellen eines Windows PowerShell-Moduls finden Sie unter Erstellen eines Windows PowerShell-Moduls. Ein Integrationsmodul kann alle unter Windows PowerShell-Moduleangegebenen gültigen Modultypen enthalten. Dazu gehören Skriptmodule (PSM1), Binärmodule (DLL) und Manifestmodule (PSD1). Das Integrationsmodulpaket ist eine komprimierte Datei mit dem gleichen Namen wie das Modul und der ZIP-Erweiterung. Es enthält einen einzelnen Ordner mit dem Namen des Moduls. Das Windows PowerShell-Modul und alle unterstützenden Dateien, einschließlich der Manifestdatei (PSD1), wenn das Modul eine hat, müssen in diesem Ordner enthalten sein.

Wenn das Modul einen Verbindungstyp enthalten soll, muss es auch eine Datei mit dem Namen <ModuleName>-Automation.json enthalten, die die Verbindungstypeigenschaften angibt. Dies ist ein JSON-Datei mit dem folgenden 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"
}

Die Schritte zum Erstellen und Arbeiten mit Automation-Runbooks unterscheiden sich je nachdem, ob Sie ein Verwaltungsportal oder Windows PowerShell verwenden. Die grundlegenden Schritte für verschiedene allgemeine Vorgänge, die beide Methoden verwenden, finden Sie in den folgenden Abschnitten.

Auflisten installierter Module

Abrufen einer Liste der installierten Module im Verwaltungsportal

  1. Wählen Sie den Arbeitsbereich Automation aus.

  2. Wenn Sie Azure verwenden, wählen Sie ein Automation-Konto aus.

  3. Wählen Sie oben im Fenster Ressourcen aus.

  4. Überprüfen Sie die Ressourcen in der Liste mit einem Modultyp.

Abrufen einer Liste der installierten Module mithilfe von Windows PowerShell

Die folgenden Beispielbefehle rufen alle in Automation installierten Module ab.

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

Importieren eines Moduls

Ein Modul ist eine komprimierte Datei mit einer .zip Erweiterung, die einen Ordner enthält, der einen der folgenden Dateitypen enthält:

  • Ein Modul (PSM1-Datei)
  • Ein Modulmanifest (PSD1-Datei)

Importieren eines Moduls über das Verwaltungsportal

  1. Wählen Sie den Arbeitsbereich Automation.

  2. Wählen Sie unten im Fenster Modul importieren aus.

  3. Wählen Sie Nach Datei suchen aus.

  4. Wählen Sie die Moduldatei aus, und wählen Sie OK aus.

  5. Klicken Sie im Dialogfeld auf die Schaltfläche "Häkchen".

Importieren eines Moduls mithilfe von Windows PowerShell

Die folgenden Beispielbefehle zeigen, wie Sie ein Modul importieren.

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

Auflisten von Aktivitäten in amModule

Abrufen einer Liste der Aktivitäten in einem Modul im Verwaltungsportal

  1. Wählen Sie den Arbeitsbereich Automation.

  2. Wenn Sie Azure verwenden, wählen Sie ein Automation-Konto aus.

  3. Wählen Sie oben im Fenster Ressourcen aus.

  4. Suchen Sie das Modul, und wählen Sie es aus.

  5. Führen Sie auf dem Bildschirm Moduldetails einen Bildlauf nach unten aus, und untersuchen Sie die Aktivitäten.

  6. Wählen Sie optional das Lupensymbol aus, um nach bestimmten Aktivitäten zu filtern.

Abrufen einer Liste der Aktivitäten in einem Modul mithilfe von Windows PowerShell

Die folgenden Beispielbefehle zeigen, wie Sie die Aktivitäten in einem bestimmten Modul abrufen.

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

Abrufen einer Liste der Aktivitäten in allen Modulen mithilfe von Windows PowerShell

Die folgenden Beispielbefehle zeigen, wie Sie die Aktivitäten in allen in Automation installierten Modulen abrufen.

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

Nächste Schritte