系統指派的受控識別必須在 Azure 虛擬機器、已啟用 Arc 的伺服器、已啟用 Arc 的 VMware vSphere VM 或已啟用 Arc 的 SCVMM VM 上啟用。 如果未啟用系統指派的受控識別,則會在新增程式中予以啟用。
受支援的作業系統
Windows (x64)
Linux (x64)
● Windows Server 2022 (包括 Server Core) ● Windows Server 2019 (包括 Server Core) ● Windows Server 2016 版本 1709 和 1803 (不包括 Server Core) ● Windows Server 2012、2012 R2 (不包括 Server Core) ● Windows 10 企業版 (包括多工作階段) 和專業版
• Debian GNU/Linux 8、9、10、11 和 12 • Ubuntu 18.04 LTS、20.04 LTS、22.04 LTS 和 24.04 LTS • SUSE Linux Enterprise Server 15.2、15.3、15.4、15.5 和 15.6 ● Red Hat Enterprise Linux Server 7、8 和 9 • Rocky Linux 9 • Oracle Linux 7、8 和 9 混合式背景工作角色延伸模組會遵循 OS 廠商的支援時間表。
其他需求
Windows (x64)
Linux (x64)
Windows PowerShell 5.1 (下載 WMF 5.1)。 不支援 PowerShell Core。
針對 Azure VM 和已啟用 Arc 的伺服器,您可以使用 PowerShell Cmdlet 或 API 來設定 Proxy 設定。 目前不支援已啟用 Arc 的 VMware vSphere VM。
若要使用 Cmdlet 安裝擴充功能:
使用下列 API 呼叫取得自動化帳戶詳細資料。
HTTP
GET https://westcentralus.management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}?api-version=2021-06-22
API 呼叫會提供具有索引鍵的值:AutomationHybridServiceUrl。 在下一個步驟中使用 URL,在 VM 上啟用擴充功能。
執行下列 PowerShell Cmdlet (必要模組:Az.Compute),在 VM 上安裝混合式背景工作角色擴充功能。 使用上述 API 呼叫所提供的 properties.automationHybridServiceUrl
您必須有已啟用 Azure VM 或已啟用 Arc 的伺服器。 您可以遵循這裡的步驟來建立 Arc 連線的電腦。
安裝和使用混合式背景工作角色擴充功能
若要使用 REST API 安裝和使用混合式背景工作角色擴充功能,請遵循下列步驟。 在此範例中,會以美國中西部區域的情況為例。
進行此 API 呼叫,來建立混合式背景工作角色群組。
HTTP
PUT https://westcentralus.management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/hybridRunbookWorkerGroups/{hybridRunbookWorkerGroupName}?api-version=2021-06-22
要求本文應包含下列資訊:
HTTP
{
}
PUT 的回應會確認是否已建立混合式背景工作角色群組。 若要重新確認,您必須在混合式背景工作角色群組上進行另一個 GET 呼叫,如下所示:
HTTP
GET https://westcentralus.management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/hybridRunbookWorkerGroups/{hybridRunbookWorkerGroupName}?api-version=2021-06-22
透過進行下列 API 呼叫,將 VM 連線到上述建立的混合式背景工作角色群組。 進行呼叫之前,請先產生新的 GUID,以作為 hybridRunbookWorkerId 使用。
HTTP
PUT https://westcentralus.management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/hybridRunbookWorkerGroups/{hybridRunbookWorkerGroupName}/hybridRunbookWorkers/{hybridRunbookWorkerId}?api-version=2021-06-22
PUT 呼叫的回應會確認是否已建立混合式背景工作角色。 若要重新確認,您必須在混合式背景工作角色上進行另一個 GET 呼叫,如下所示。
HTTP
GET https://westcentralus.management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/hybridRunbookWorkerGroups/{hybridRunbookWorkerGroupName}/hybridRunbookWorkers/{hybridRunbookWorkerId}?api-version=2021-06-22
GET https://westcentralus.management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/HybridWorkerExtension?api-version=2021-06-22
API 呼叫會提供具有索引鍵的值:AutomationHybridServiceUrl。 在下一個步驟中使用 URL,在 VM 上啟用擴充功能。
使用下列 API 呼叫,在 Azure VM 上安裝混合式背景工作角色擴充功能。
HTTP
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/extensions/HybridWorkerExtension?api-version=2021-11-01
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines/{machineName}/extensions/{extensionName}?api-version=2021-05-20
az vm extension set --name HybridWorkerExtension --publisher Microsoft.Azure.Automation.HybridWorker --version1.1--vm-name<vmname>-g<resourceGroupName> \
--settings'{"AutomationAccountURL" = "<registration-url>";}'--enable-auto-upgradetrue
若要確認延伸模組是否已成功安裝在 VM 上,請在 Azure 入口網站中,移至 VM >[延伸模組] 索引標籤,並檢查安裝在 VM 上的混合式背景工作角色延伸模組狀態。