Usare i moduli di integrazione

Articolo
11/01/2024

Un modulo di integrazione è un pacchetto che contiene un modulo di Windows PowerShell. Per informazioni su come scrivere un modulo di Windows PowerShell, vedere Scrittura di un modulo di Windows PowerShell. Un modulo di integrazione può contenere uno dei tipi di modulo validi specificati nei moduli di Windows PowerShell, tra cui moduli di script (PSM1), moduli binari (DLL) e moduli del manifesto (PSD1). Il pacchetto del modulo di integrazione è un file compresso con lo stesso nome del modulo e l'estensione ZIP. Contiene un'unica cartella, anch'essa con il nome del modulo. Il modulo di Windows PowerShell e tutti i file di supporto, tra cui un file del manifesto (PSD1) se il modulo ne contiene uno, devono essere inseriti in questa cartella.

Se il modulo deve contenere un tipo di connessione , deve contenere anche un file con il nome <ModuleName>-Automation.json che specifica le proprietà del tipo di connessione. Si tratta di un file json con il formato seguente.

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

I passaggi per la creazione e l'uso dei runbook di Automazione sono diversi a seconda che si usi un portale di gestione o Windows PowerShell. I passaggi di base per varie operazioni comuni che usano entrambi i metodi sono disponibili nelle sezioni seguenti.

Enumerare i moduli installati

Ottenere un elenco di moduli installati nel portale di gestione

Selezionare l'area di lavoro Automazione .
Se si usa Azure, selezionare un account di Automazione.
Nella parte superiore della finestra selezionare Asset.
Esaminare gli asset nell'elenco con un tipo di modulo.

Ottenere un elenco di moduli installati con Windows PowerShell

I comandi di esempio seguenti recuperano tutti i moduli installati in Automazione.

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

Importare un modulo

Un modulo è un file compresso con un'estensione .zip che contiene una cartella, che include uno dei tipi di file seguenti:

Modulo (file psm1)
Manifesto del modulo (file psd1)

Importare un modulo usando il portale di gestione

Selezionare l'area di lavoro Automazione .
Nella parte inferiore della finestra selezionare Importa modulo.
Selezionare Sfoglia per file.
Selezionare il file del modulo e selezionare OK.
Selezionare il pulsante del segno di spunta nella finestra di dialogo.

Importare un modulo con Windows PowerShell

I comandi di esempio seguenti illustrano come importare un modulo.

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

Enumerare le attività in amModule

Ottenere un elenco di attività in un modulo nel portale di gestione

Selezionare l'area di lavoro di automazione.
Se si usa Azure, selezionare un account di Automazione.
Nella parte superiore della finestra selezionare Asset.
Individuare il modulo e selezionarlo.
Scorrere fino in fondo alla schermata Dettagli modulo ed esaminarne le attività.
Facoltativamente, selezionare l'icona della lente di ingrandimento per filtrare le attività specifiche.

Ottenere un elenco di attività in un modulo con Windows PowerShell

I comandi di esempio seguenti illustrano come recuperare le attività in un modulo specifico.

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

Ottenere un elenco di attività in tutti i moduli con Windows PowerShell

I comandi di esempio seguenti illustrano come recuperare le attività in tutti i moduli installati in Automazione.

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

Passaggi successivi

Per saperne di più sull'automazione di Service Management.
Altre informazioni sulle operazioni del runbook.

Condividi tramite