Arbeiten mit Integrationsmodulen

Artikel
11/01/2024

Ein Integrationsmodul ist ein Paket, das ein Windows PowerShell-Modul enthält. Informationen zum Schreiben eines Windows PowerShell-Moduls finden Sie unter Schreiben eines Windows PowerShell-Moduls. Ein Integrationsmodul kann jeden der in Windows PowerShell-Module angegebenen gültigen Modultypen enthalten. Dazu gehören Skriptmodule (.psm1), Binärmodule (.dll) und Manifestmodule (.psd1). Das Paket des Integrationsmoduls ist eine komprimierte Datei mit dem gleichen Namen wie das Modul und der Erweiterung .zip. Es enthält auch einen einzelnen Ordner mit dem Namen des Moduls. Das Windows PowerShell-Modul und alle unterstützenden Dateien, einschließlich einer Manifestdatei (.psd1), wenn das Modul über eine solche verfügt, müssen in diesem Ordner enthalten sein.

Wenn das Modul einen Verbindungstyp enthalten soll, muss es auch eine Datei mit dem Namen <Modulname>-Automation.json enthalten, in der die Eigenschaften des Verbindungstyps angegeben sind. Dies ist eine 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 Automatisierungs-Runbooks sind unterschiedlich, 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.

Aufzählen installierter Module

Abrufen einer Liste der installierten Module im Verwaltungsportal

Wählen Sie den Arbeitsbereich Automation.
Wenn Sie Azure verwenden, wählen Sie ein Automatisierungskonto aus.
Wählen Sie oben im Fenster Assets.
Überprüfen Sie die Assets in der Liste mit dem Typ Modul.

Abrufen einer 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

Ein Modul importieren

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

Ein Modul (psm1-Datei)
Ein Modulmanifest (psd1-Datei)

Importieren eines Moduls mithilfe des Verwaltungsportals

Wählen Sie den Automatisierungs-Arbeitsbereich aus.
Wählen Sie am unteren Rand des Fensters Modul importieren.
Wählen Sie Nach Datei suchen.
Wählen Sie die Moduldatei aus und wählen Sie OK.
Wählen Sie die Schaltfläche mit dem Häkchen im Dialogfeld.

Importieren eines Moduls mit Windows PowerShell

Die folgenden Beispielbefehle zeigen, wie ein Modul importiert wird.

$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

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

Wählen Sie den Automatisierungs-Arbeitsbereich aus.
Wenn Sie Azure verwenden, wählen Sie ein Automatisierungskonto aus.
Wählen Sie oben im Fenster Assets.
Suchen Sie das Modul, und wählen Sie es aus.
Scrollen Sie zum unteren Ende des Bildschirms mit den Moduldetails und prüfen Sie die Aktivitäten.
Wählen Sie optional das Lupensymbol aus, um nach bestimmten Aktivitäten zu filtern.

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

Die folgenden Beispielbefehle zeigen, wie die Aktivitäten in einem bestimmten Modul abgerufen werden.

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

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

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

$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

Erfahren Sie mehr über Service Management Automation.
Erfahren Sie mehr über Runbook-Operations.

Teilen über