Trabajar con módulos de integraciónWorking with integration modules

Se aplica a: System Center 2016 - Service Management AutomationApplies To: System Center 2016 - Service Management Automation

Un módulo de integración es un paquete que contiene un módulo de Windows PowerShell.An Integration Module is a package that contains a Windows PowerShell Module. Para obtener información sobre cómo escribir un módulo de Windows PowerShell, consulte Escribir un módulo de Windows PowerShell.For information on writing a Windows PowerShell Module, see Writing a Windows PowerShell Module. Un módulo de integración puede contener cualquiera de los tipos de módulo válidos especificados en Módulos de Windows PowerShell.An Integration Module can contain any of the valid Module Types specified in Windows PowerShell Modules. Esto incluye módulos de script (. psm1), módulos binarios (.dll) y módulos de manifiesto (. psd1).This includes Script Modules (.psm1), Binary Modules (.dll), and Manifest Modules (.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.The Integration Module package is a compressed file with the same name as the module and a .zip extension. Contiene una sola carpeta también con el nombre del módulo.It contains a single folder also with the name of the module. 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.The Windows PowerShell module and any supporting files, including a manifest file (.psd1) if the module has one, must be contained in this folder.

Si el módulo debe contener una conexión tipo, también debe contener un archivo con el nombre < ModuleName>-Automation.json, que especifica las propiedades de tipo de conexión.If the module should contain a Connection type, it must also contain a file with the name <ModuleName>-Automation.json that specifies the connection type properties. Este es un archivo json con el formato siguiente.This is a json file with the following 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"
}

Los pasos para crear y trabajar con runbooks de automatización son diferentes dependiendo de si está utilizando un portal de administración o Windows PowerShell.The steps for creating and working with Automation runbooks are different depending on whether you using a management portal or Windows PowerShell. Los pasos básicos para realizar diversas operaciones comunes con ambos métodos se proporcionan en las secciones siguientes.The basic steps for various common operations using both methods are provided in the following sections.

Enumerar módulos instaladosEnumerating installed modules

Para obtener una lista de módulos instalados mediante el portal de administraciónTo Get a list of installed modules using the management portal

  1. Seleccione el área de trabajo Automatización .Select the Automation workspace.

  2. Si usa Azure, seleccione una cuenta de Automation.If you are using Azure, then select an Automation account.

  3. En la parte superior de la ventana, haga clic en Activos.At the top of the window, click Assets.

  4. Inspeccione los activos de la lista con un tipo de módulo.Inspect the assets in the list with a Type of Module.

Para obtener una lista de módulos instalados en Service Management Automation mediante Windows PowerShellTo Get a list of installed modules in Service Management Automation using Windows PowerShell

Los siguientes comandos de ejemplo recuperan todos los módulos instalados en la automatización.The following sample commands retrieve all modules installed in Automation.

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

Importación de un móduloImporting a module

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:A module is a compressed file with a .zip extension that contains a folder which includes one of the following file types:

  • Un módulo (archivo. psm1)A module (psm1 file)
  • Un manifiesto de módulo (archivo. psd1)A module manifest (psd1 file)

Para importar un módulo mediante el portal de administraciónTo import a module using the management portal

  1. Seleccione el área de trabajo de automatización.Select the Automation workspace.

  2. En la parte inferior de la ventana, haga clic en el módulo de importación.At the bottom of the window, click Import Module.

  3. Haga clic en Examinar para el archivo.Click Browse for File.

  4. Seleccione el archivo de módulo y haga clic en Aceptar.Select the module file and click OK.

  5. Haga clic en el botón de marca de verificación en el cuadro de diálogo.Click the checkmark button on the dialog box.

Para importar un módulo en Service Management Automation mediante Windows PowerShellTo import a module in Service Management Automation using Windows PowerShell

Los siguientes comandos de ejemplo muestran cómo importar un módulo.The following sample commands show how to import a module.

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

Enumerar las actividades en un móduloEnumerating Activities in a Module

Para obtener una lista de actividades de un módulo mediante el portal de administraciónTo Get a list of activities in a module using the management portal

  1. Seleccione el área de trabajo de automatización.Select the Automation workspace.

  2. Si usa Azure, seleccione una cuenta de Automation.If you are using Azure, then select an Automation account.

  3. En la parte superior de la ventana, haga clic en activos.At the top of the window, click Assets.

  4. Busque el módulo y selecciónelo.Locate the module and select it.

  5. Desplácese hasta la parte inferior de la pantalla de detalles del módulo e inspeccione sus actividades.Scroll to the bottom of the Module Details screen and inspect its activities.

  6. Si lo desea, haga clic en el icono de lupa para filtrar determinadas actividades.Optionally, click the magnifying glass icon to filter for particular activities.

Para obtener una lista de actividades en un módulo de Service Management Automation mediante Windows PowerShellTo get a list of activities in a module in Service Management Automation using Windows PowerShell

Los siguientes comandos de ejemplo muestran cómo recuperar las actividades de un módulo determinado.The following sample commands show how to retrieve the activities in a particular module.

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

Para obtener una lista de actividades en todos los módulos de Service Management Automation mediante Windows PowerShellTo get a list of activities in all modules in Service Management Automation using Windows PowerShell

Los siguientes comandos de ejemplo muestran cómo recuperar las actividades de todos los módulos instalados en la automatización.The following sample commands show how to retrieve the activities in all modules installed in Automation.

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

Pasos siguientesNext steps

Para obtener más información acerca de Service Management Automation leer Service Management Automation.To learn more about Service Management Automation read Service Management Automation.

Para obtener más información sobre cómo utilizar runbooks en su entorno leer las operaciones de Runbook.To learn more about how to use runbooks in your environment read Runbook Operations.