Trabajo con módulos de integración

  • Artículo

Importante

Esta versión de Service Management Automation (SMA) ha llegado al final del soporte técnico. Se recomienda actualizar a SMA 2022.

Un módulo de integración es un paquete que contiene un módulo de Windows PowerShell. Para obtener información sobre cómo escribir un módulo de Windows PowerShell, consulte Escribir un módulo de Windows PowerShell. Un módulo de integración puede contener cualquiera de los tipos de módulo válidos especificados en Módulos de Windows PowerShell. Esto incluye módulos de script (. psm1), módulos binarios (.dll) y módulos de manifiesto (. psd1). El paquete del módulo de integración es un archivo comprimido con el mismo nombre que el módulo y una extensión .zip. Contiene una sola carpeta también con el nombre del módulo. El módulo de Windows PowerShell y los archivos auxiliares, incluido un archivo de manifiesto (. psd1) si el módulo tiene uno, deben estar contenidos en esta carpeta.

Si el módulo debe contener un tipo Connection , también debe contener un archivo con el nombre <ModuleName>-Automation.json que especifica las propiedades del tipo de conexión. Este es un archivo json con el formato siguiente.

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

Los pasos para crear y trabajar con runbooks de Automation son diferentes en función de si usa un portal de administración o Windows PowerShell. En las secciones siguientes se proporcionan los pasos básicos para varias operaciones comunes mediante ambos métodos.

Enumerar los módulos instalados

Obtener una lista de módulos instalados mediante el portal de administración

  1. Seleccione el área de trabajo Automatización.

  2. Si usa Azure, seleccione una cuenta de Automation.

  3. En la parte superior de la ventana, seleccione Activos.

  4. Inspeccione los activos de la lista con un tipo de módulo.

Obtener una lista de módulos instalados mediante Windows PowerShell

Los siguientes comandos de ejemplo recuperan todos los módulos instalados en Automation.

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

Importar un módulo

Un módulo es un archivo comprimido con una extensión .zip que contiene una carpeta, que incluye uno de los siguientes tipos de archivo:

  • Un módulo (archivo .psm1)
  • Un manifiesto de módulo (archivo .psd1)

Importar un módulo mediante el portal de administración

  1. Seleccione el área de trabajo Automatización.

  2. En la parte inferior de la ventana, seleccione Importar módulo.

  3. Seleccione Buscar archivo.

  4. Seleccione el archivo del módulo y seleccione Aceptar.

  5. Seleccione el botón de marca de verificación en el cuadro de diálogo.

Importar un módulo mediante Windows PowerShell

Los siguientes comandos de ejemplo muestran cómo importar un módulo.

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

Enumerar actividades en un módulo

Obtener una lista de las actividades de un módulo mediante el portal de administración

  1. Seleccione el área de trabajo Automatización.

  2. Si usa Azure, seleccione una cuenta de Automation.

  3. En la parte superior de la ventana, seleccione Activos.

  4. Localice el módulo y selecciónelo.

  5. Desplácese hasta la parte inferior de la pantalla Detalles del módulo e inspeccione sus actividades.

  6. Opcionalmente, seleccione el icono de lupa para filtrar las actividades concretas.

Obtener una lista de las actividades de un módulo mediante Windows PowerShell

Los siguientes comandos de ejemplo muestran cómo recuperar las actividades de un módulo concreto.

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

Obtener una lista de las actividades de todos los módulos mediante Windows PowerShell

Los siguientes comandos de ejemplo muestran cómo recuperar las actividades de todos los módulos instalados en Automation.

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

Pasos siguientes