Arbeiten mit Integrationsmodulen

Wichtig

Diese Version von Service Management Automation (SMA) hat das Supportende erreicht. Sie sollten ein Upgrade auf SMA 2019 durchführen.

Ein Integrationsmodul ist ein Paket, das ein Windows PowerShell 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 Eigenschaften des > Verbindungstyps 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 ein Windows PowerShell. In den folgenden Abschnitten werden die grundelegenden Schritte bei verschiedenen allgemeinen Vorgängen für beide Methoden beschrieben.

Aufzählen installierter Module

Eine 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.

  3. Klicken Sie im oberen Fensterbereich auf Ressourcen.

  4. Überprüfen Sie die Objekte in der Liste mit dem Modultyp.

Hier finden Sie eine Liste der installierten Module mit 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 der Erweiterung ZIP, in der ein Ordner mit einem der folgenden Dateitypen enthalten ist:

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

Importieren eines Moduls über das Verwaltungsportal

  1. Wählen Sie den Arbeitsbereich Automation.

  2. Klicken Sie unten im Fenster auf Modul importieren.

  3. Klicken Sie auf Datei suchen.

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

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

Importieren eines Moduls mit 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

Aufzählen von Aktivitäten in amModule

Eine 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.

  3. Klicken Sie im oberen Bereich des Fensters auf Objekte.

  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. Klicken Sie optional auf das Lupensymbol, um nach bestimmten Aktivitäten zu filtern.

Eine 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

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

Die folgenden Beispielbefehle zeigen, wie die Aktivitäten in allen modulen abgerufen werden, die in Automation installiert sind.

$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