統合モジュールの操作

[アーティクル]
11/01/2024

Integration Module は、Windows PowerShell モジュールを含むパッケージです。 Windows PowerShell モジュールを作成する方法の詳細については、「 Writing a Windows PowerShell Module (Windows PowerShell モジュールの作成)」をご覧ください。統合モジュールには、 Windows PowerShell モジュールで指定された有効なモジュール型のいずれかを含めることができます。これには、スクリプトモジュール (.psm1)、バイナリモジュール (.dll)、マニフェストモジュール (.psd1) が含まれます。統合モジュールパッケージは、モジュールと zip 拡張子と同じ名前の圧縮ファイルです。これには、モジュールの名前と 1 つのフォルダーが含まれます。 Windows PowerShell モジュールと、モジュールに存在する場合はマニフェストファイル (.psd1) を含むいずれかのサポートされるファイルは、このフォルダに含まれる必要があります。

モジュールに Connection 型を含める必要がある場合は、接続の種類のプロパティを指定 <ModuleName>-Automation.json という名前のファイルも含める必要があります。これは、次の形式の json ファイルです。

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

Automation Runbook を作成して操作する手順は、管理ポータルと Windows PowerShell のどちらを使用しているかによって異なります。両方の方法を使用するさまざまな一般的な操作の基本的な手順については、次のセクションで説明します。

インストールされているモジュールを列挙する

管理ポータルでインストールされているモジュールの一覧を取得する

[Automation] ワークスペースを選択します。
Azure を使用している場合は、Automation アカウントを選択します。
ウィンドウの上部にある Assets を選択します。
Moduleの種類を使用して、リスト内の資産を検査します。

Windows PowerShell を使用してインストールされているモジュールの一覧を取得する

次のサンプルコマンドでは、Automation にインストールされているすべてのモジュールを取得します。

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

モジュールをインポートする

モジュールは、次のいずれかのファイルの種類を含むフォルダーを含む.zip拡張子を持つ圧縮ファイルです。

モジュール (psm1 ファイル)
モジュールマニフェスト (psd1 ファイル)

管理ポータルを使用してモジュールをインポートする

[Automation] ワークスペースを選択します。
ウィンドウの下部にある Import Module を選択します。
[ファイル ブロウズ] を選択。
モジュールファイルを選択し、 OK を選択します。
ダイアログのチェックマークボタンを選択します。

Windows PowerShell を使用してモジュールをインポートする

次のサンプルコマンドは、モジュールをインポートする方法を示しています。

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

amModule でアクティビティを列挙する

管理ポータルでモジュール内のアクティビティの一覧を取得する

[Automation] ワークスペースを選択します。
Azure を使用している場合は、Automation アカウントを選択します。
ウィンドウの上部にある Assets を選択します。
モジュールを見つけて選択します。
[モジュールの詳細] 画面の一番下までスクロールし、そのアクティビティを調べます。
必要に応じて、虫眼鏡アイコンを選択して、特定のアクティビティをフィルター処理します。

Windows PowerShell を使用してモジュール内のアクティビティの一覧を取得する

次のサンプルコマンドは、特定のモジュールのアクティビティを取得する方法を示しています。

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

Windows PowerShell を使用して、すべてのモジュールのアクティビティの一覧を取得する

次のサンプルコマンドは、Automation にインストールされているすべてのモジュールのアクティビティを取得する方法を示しています。

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

次のステップ

Service Management オートメーションの詳細についてはを参照してください。
詳細については、実行ブックの操作を参照してください。

次の方法で共有