Trabalhar com módulos de integração

Artigo
04/03/2024

Importante

Esta versão do Service Management Automation (SMA) chegou ao fim do suporte. Recomendamos que atualize para o SMA 2022.

Um Módulo de Integração é um pacote que contém um Módulo de Windows PowerShell. Para obter informações sobre como escrever um Módulo Windows PowerShell, veja Writing a Windows PowerShell Module (Escrever um Módulo de Windows PowerShell). Um Módulo de Integração pode conter qualquer um dos Tipos de Módulo válidos especificados no Windows PowerShell Modules. Isto inclui Módulos de Script (.psm1), Módulos Binários (.dll) e Módulos de Manifesto (.psd1). O pacote do Módulo de Integração é um ficheiro comprimido que tem o mesmo nome do módulo e uma extensão .zip. Contém uma única pasta, que também tem o nome do módulo. O módulo do Windows PowerShell e todos os ficheiros de suporte, incluindo um ficheiro de manifesto (.psd1), se o módulo o tiver, têm de estar contidos nesta pasta.

Se o módulo tiver um Tipo de ligação , também tem de conter um ficheiro com o nome <ModuleName>-Automation.json que especifica as propriedades do tipo de ligação. Trata-se de um ficheiro json com o formato seguinte.

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

Os passos para criar e trabalhar com runbooks de Automatização são diferentes consoante esteja a utilizar um portal de gestão ou Windows PowerShell. Os passos básicos para várias operações comuns com ambos os métodos são fornecidos nas secções seguintes.

Enumerar módulos instalados

Obter uma lista de módulos instalados no portal de gestão

Selecione a área de trabalho Automatização .
Se estiver a utilizar o Azure, selecione uma conta de Automatização.
Na parte superior da janela, selecione Recursos.
Inspecione os recursos na lista com um Tipo de Módulo.

Obter uma lista de módulos instalados com Windows PowerShell

Os seguintes comandos de exemplo obtêm todos os módulos instalados na Automatização.

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

Importar um módulo

Um módulo é um ficheiro comprimido com uma extensão .zip que contém uma pasta, que inclui um dos seguintes tipos de ficheiro:

Um módulo (ficheiro psm1)
Um manifesto de módulo (ficheiro psd1)

Importar um módulo com o portal de gestão

Selecione a área de trabalho Automatização.
Na parte inferior da janela, selecione Importar Módulo.
Selecione Procurar Ficheiro.
Selecione o ficheiro do módulo e selecione OK.
Selecione o botão de marca de verificação na caixa de diálogo.

Importar um módulo com Windows PowerShell

Os comandos de exemplo seguintes mostram como importar um módulo.

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

Enumerar atividades em amModule

Obter uma lista de atividades num módulo no portal de gestão

Selecione a área de trabalho Automatização.
Se estiver a utilizar o Azure, selecione uma conta de Automatização.
Na parte superior da janela, selecione Recursos.
Localize o módulo e selecione-o.
Desloque-se para a parte inferior do ecrã Detalhes do Módulo e inspecione as respetivas atividades.
Opcionalmente, selecione o ícone de lupa para filtrar atividades específicas.

Obter uma lista de atividades num módulo com Windows PowerShell

Os comandos de exemplo seguintes mostram como obter as atividades de um determinado módulo.

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

Obter uma lista de atividades em todos os módulos com Windows PowerShell

Os seguintes comandos de exemplo mostram como obter as atividades em todos os módulos instalados na Automatização.

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

Passos seguintes

Saiba mais sobre a automatização da Gestão de Serviços.
Saiba mais sobre as operações do runbook.

Partilhar via