Share via

Usare i moduli di integrazione

  • Articolo

Importante

Questa versione di Service Management Automation (SMA) ha raggiunto la fine del supporto. È consigliabile eseguire l'aggiornamento a SMA 2022.

Un modulo di integrazione è un pacchetto che contiene un modulo 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

  1. Selezionare l'area di lavoro Automazione.

  2. Se si usa Azure, selezionare un account di Automazione.

  3. Nella parte superiore della finestra selezionare Asset.

  4. Esaminare gli asset nell'elenco con un tipo di modulo.

Ottenere un elenco di moduli installati usando 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:

  • Un modulo (file psm1)
  • Un manifesto del modulo (file psd1)

Importare un modulo usando il portale di gestione

  1. Selezionare l'area di lavoro Automazione.

  2. Nella parte inferiore della finestra selezionare Importa modulo.

  3. Selezionare Sfoglia per file.

  4. Selezionare il file del modulo e selezionare OK.

  5. Selezionare il pulsante segno di spunta nella finestra di dialogo.

Importare un modulo usando Windows PowerShell

I seguenti comandi di esempio spiegano 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

  1. Selezionare l'area di lavoro Automazione.

  2. Se si usa Azure, selezionare un account di Automazione.

  3. Nella parte superiore della finestra selezionare Asset.

  4. Individuare il modulo e selezionarlo.

  5. Scorrere fino alla fine della schermata Module Details (Dettagli modulo) e analizzarne le attività.

  6. Facoltativamente, selezionare l'icona della lente di ingrandimento per filtrare le attività specifiche.

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

I seguenti comandi di esempio spiegano 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 usando 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