使用整合模組

發行項
11/01/2024

整合模組是包含 Windows PowerShell 模組的套件。如需撰寫 Windows PowerShell 模組的資訊，請參閱撰寫 Windows PowerShell 模組(英文)。整合模組可以包含 Windows PowerShell 模組(英文) 中指定的任何有效的模組類型。這包括指令碼模組 (.psm1)、二進位模組 (.dll) 與資訊清單模組 (.psd1)。整合模組封裝是與模組同名的壓縮檔案，並有 .zip 副檔名。它包含也具有模組名稱的單一資料夾。 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"
}

建立及使用自動化 Runbook 的步驟會根據您使用的是管理入口網站或 Windows PowerShell 而有所不同。下列各節提供使用這兩種方法之各種常見作業的基本步驟。

列舉已安裝的模組

在管理入口網站中取得已安裝模組的清單

選取 [自動化] 工作區。
如果您使用 Azure，請選取自動化帳戶。
在視窗頂端，選取 [ 資產]。
使用模組類型檢查清單中的資產。

使用 Windows PowerShell 取得已安裝模組的清單

下列範例命令會擷取自動化中安裝的所有模組。

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

匯入模組

模組是包含資料夾之.zip擴展名的壓縮檔，其中包含下列其中一種檔類型：

模組（psm1 檔案）
模組指令清單（psd1 檔案）

使用管理入口網站匯入模組

選取 [自動化] 工作區。
在視窗底部，選取 [ 匯入模組]。
選取 [ 瀏覽檔案]。
選取模組檔案，然後選取 [ 確定]。
選取對話框上的複選標記按鈕。

使用 Windows PowerShell 匯入模組

下列範例命令示範如何匯入模組。

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

列舉 amModule 中的活動

在管理入口網站中取得模組中的活動清單

選取 [自動化] 工作區。
如果您使用 Azure，請選取自動化帳戶。
在視窗頂端，選取 [ 資產]。
找出模組並加以選取。
捲動至 [模組詳細數據] 畫面底部，並檢查其活動。
或者，選取放大鏡圖示以篩選特定活動。

使用 Windows PowerShell 取得模組中的活動清單

下列範例命令示範如何擷取特定模組中的活動。

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

使用 Windows PowerShell 取得所有模組中的活動清單

下列範例命令示範如何擷取自動化中所安裝之所有模組中的活動。

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

下一步

深入瞭解服務管理自動化。
深入瞭解 Runbook 作業。

共用方式為