Compartir a través de

Trabajar con módulos de integración

  • Artículo

Un módulo de integración es un paquete que contiene un módulo de Windows PowerShell. Para más información sobre cómo escribir módulos de Windows PowerShell, consulta Writing a Windows PowerShell Module (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 los módulos de script (.psm1), los módulos binarios (.dll) y los módulos de manifiesto (.psd1). Un paquete de módulo de integración es un archivo comprimido que tiene el mismo nombre del módulo y una extensión .zip. Contiene una sola carpeta también con el nombre del módulo. Esta carpeta debe contener el módulo de Windows PowerShell y todos los archivos auxiliares, como el archivo de manifiesto (.psd1), si es que el módulo tiene uno.

Si el módulo debe contener un tipo de Conexión, también debe incluir un archivo llamado <ModuleName>-Automation.json que especifique las propiedades 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 usas un portal de administración o Windows PowerShell. Los pasos básicos para varias operaciones comunes que usan ambos métodos se proporcionan en las secciones siguientes.

Enumerar módulos instalados

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

  1. Selecciona el área de trabajo de Automation.

  2. Si usas Azure, selecciona después una cuenta de Automation.

  3. En la parte superior de la ventana, selecciona Recursos.

  4. Inspecciona los recursos 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. Selecciona el área de trabajo de Automation.

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

  3. Selecciona Examinar archivos.

  4. Selecciona el archivo de módulo y selecciona Aceptar.

  5. Selecciona 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 amModule

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

  1. Selecciona el área de trabajo de Automation.

  2. Si usas Azure, selecciona una cuenta de Automation.

  3. En la parte superior de la ventana, selecciona Recursos.

  4. Busca el módulo y selecciónalo.

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

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

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

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

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

Obtener una lista de actividades en 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