Azure 本機上的 Azure Arc 延伸模組管理

發行項
11/23/2024

適用於：Azure 本機版本 23H2 和 22H2

本文說明如何在 Azure 本機上安裝、升級及管理 Azure Arc 擴充功能。

Azure 本機上客戶管理的 Azure Arc 擴充功能

您可以在 Azure 本機上安裝、卸載及更新 Azure Arc 擴充功能。 Azure Arc 可讓您在 Azure 入口網站中執行混合式服務，例如監視和 Windows Admin Center。

以下是您可以安裝和管理的個別延伸模組。

Azure 本機中的 Azure 受控擴充功能

成功向 Azure 註冊新的 Azure 本機之後，系統會自動安裝 Azure 受控延伸模組。這些擴充功能對於系統的功能和品質而言至關重要，無法卸載。您可以流覽至 [擴充功能] 頁面，然後選取 [設定] 功能表，以管理 Azure 入口網站中這些延伸模塊的行為。

如果您有現有的 Azure 本機，且未註冊這些擴充功能，則橫幅會顯示在 Azure 入口網站的 [概觀] 或 [擴充功能] 頁面上。您可以使用橫幅中的資訊來引導您安裝這些延伸模組。

以下是 Azure 受控延伸模組：

安裝擴充功能

您可以從已啟用 Azure 本機 Arc 之伺服器的 [功能] 索引標籤安裝延伸模組，如螢幕快照所示。您可以使用 [功能] 索引標籤來安裝大部分的擴充功能。

當您在 Azure 入口網站中安裝擴充功能時，這是叢集感知作業。擴充功能會安裝在系統的所有節點上。如果您將更多節點新增至系統，系統上安裝的所有擴充功能都會自動新增至新的伺服器。

Azure CLI 可在 Windows、macOS 和 Linux 環境中安裝。也可以在 Azure Cloud Shell 中執行。如需詳細資訊，請參閱 Azure Cloud Shell 快速入門。

啟動 Azure Cloud Shell 並使用 Bash 來安裝擴充功能，請遵循下列步驟：

從您的訂用帳戶、資源群組和叢集設定參數

subscription="00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
resourceGroup="hcicluster-rg" # Replace with your resource group name

az account set --subscription "${subscription}"

clusters=($(az graph query -q "resources | where type == 'microsoft.azurestackhci/clusters'| where resourceGroup =~ '${resourceGroup}' | project name" | jq -r '.data[].name'))

若要在資源群組下的所有系統上安裝 Windows Admin Center 擴充功能，請執行下列命令：

extensionName="AdminCenter"
extensionType="AdminCenter"
extensionPublisher="Microsoft.AdminCenter"
settingsConfig="{'port':'6516'}"
connectivityProps="{enabled:true}"

for cluster in ${clusters}; do
    echo "Enabling Connectivity for cluster $currentCluster"
    az stack-hci arc-setting update \
        --resource-group ${resourceGroup} \
        --cluster-name ${cluster} \
        --name "default" \
        --connectivity-properties ${connectivityProps}

    echo "Installing extension: ${extensionName} on cluster: ${cluster}"
    az stack-hci extension create \
        --arc-setting-name "default" \
        --cluster-name "${cluster}" \
        --resource-group "${resourceGroup}" \
        --name "${extensionName}" \
        --auto-upgrade "true" \
        --publisher "${extensionPublisher}" \
        --type "${extensionType}" \
        --settings "${settingsConfig}"
done

若要在資源群組下的所有系統上安裝 Azure 監視器代理程式擴充功能，請執行下列命令：

extensionName="AzureMonitorWindowsAgent"
extensionType="AzureMonitorWindowsAgent"
extensionPublisher="Microsoft.Azure.Monitor"

for cluster in ${clusters}; do
    echo "Installing extension: ${extensionName} on cluster: ${cluster}"

    az stack-hci extension create \
        --arc-setting-name "default" \
        --cluster-name "${cluster}" \
        --resource-group "${resourceGroup}" \
        --name "${extensionName}" \
        --auto-upgrade "true" \
        --publisher "${extensionPublisher}" \
        --type "${extensionType}"
done

若要在資源群組下的所有系統上安裝 Azure Site Recovery 擴充功能，請執行下列命令：

asrSubscription="00000000-0000-0000-0000-000000000000" # Replace with your ASR subscription ID
asrResourceGroup="asr-rg" # Replace with your ASR resource group
asrVaultName="asr-vault" # Replace with your ASR vault name
asrLocation="East US" # Replace with your ASR Location
asrSiteId="00000000-0000-0000-0000-000000000000" # Replace with your ASR Site ID
asrSiteName="asr-site" # Replace with your Site Name
asrSitePolicyId="/subscriptions/${asrSubscription}/resourceGroups/${asrResourceGroup}/providers/Microsoft.RecoveryServices/vaults/${asrVaultName}/replicationPolicies/s-cluster-policy" # Replace with your Site Policy name

extensionName="ASRExtension"
extensionType="Windows"
extensionPublisher="Microsoft.SiteRecovery.Dra"
jsonFile="./tmp-asr.json" #Temp JSON file

echo "{\"SubscriptionId\": \"${asrSubscription}\", \"Environment\": \"AzureCloud\",\"ResourceGroup\": \"${asrResourceGroup}\",\"Location\": \"${asrLocation}\",\"SiteId\": \"${asrSiteId}\", \"SiteName\": \"${asrSiteName}\", \"PolicyId\": \"${asrSitePolicyId}\", \"PrivateEndpointStateForSiteRecovery\": \"None\" }" > ${jsonFile}

for cluster in ${clusters}; do
    echo "Installing extension: ${extensionName} on cluster: ${cluster}"

    az stack-hci extension create \
        --arc-setting-name "default" \
        --cluster-name "${cluster}" \
        --resource-group "${resourceGroup}" \
        --name "${extensionName}" \
        --auto-upgrade "true" \
        --publisher "${extensionPublisher}" \
        --type "${extensionType}" \
        --settings "${jsonFile}"
done

Azure PowerShell 可以在 Azure Cloud Shell 中執行。本文件詳細說明如何在 Azure Cloud Shell 中使用 PowerShell。如需詳細資訊，請參閱 Azure Cloud Shell 快速入門。

啟動 Azure Cloud Shell 並使用 PowerShell 來安裝擴充功能，請遵循下列步驟：

從您的訂用帳戶、資源群組和叢集設定參數：

$subscription = "00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
$resourceGroup = "hcicluster-rg" # Replace with your resource group name

Set-AzContext -Subscription "${subscription}"
$clusters = Get-AzResource -ResourceType "Microsoft.AzureStackHCI/clusters" -ResourceGroupName ${resourceGroup} | Select-Object -Property Name

若要在資源群組下的所有系統上安裝 Windows Admin Center 擴充功能，請執行下列命令：

$extensionName = "AdminCenter"
$extensionType = "AdminCenter"
$extensionPublisher = "Microsoft.AdminCenter"
$settingsConfig = @{"port" = 6516 }

foreach ($cluster in $clusters) {
    $clusterName = ${cluster}.Name

    Write-Output ("Enable connectivity for cluster ${clusterName}")
    Invoke-AzRestMethod `
        -Method PATCH `
        -SubscriptionId ${subscription} `
        -ResourceGroupName ${resourceGroup} `
        -ResourceProviderName "Microsoft.AzureStackHCI" `
        -ResourceType ("clusters/" + ${clusterName} + "/arcSettings") `
        -Name "default" `
        -ApiVersion "2023-02-01" `
        -Payload (@{"properties" = @{ "connectivityProperties" = @{ "enabled" = $true } } } | ConvertTo-Json -Depth 5)


    Write-Output ("Installing Extension '${extensionName}' on cluster ${clusterName}")

    New-AzStackHciExtension `
        -ClusterName "${clusterName}" `
        -ResourceGroupName "${resourceGroup}" `
        -ArcSettingName "default" `
        -Name "${extensionName}" `
        -ExtensionParameterPublisher "${extensionPublisher}" `
        -ExtensionParameterType "${extensionType}" `
        -ExtensionParameterSetting ${settingsConfig} `
        -NoWait
}

若要在資源群組下的所有系統上安裝 Azure 監視器代理程式擴充功能，請執行下列命令：

$extensionName = "AzureMonitorWindowsAgent"
$extensionType = "AzureMonitorWindowsAgent"
$extensionPublisher = "Microsoft.Azure.Monitor"

foreach ($cluster in $clusters) {
    $clusterName = ${cluster}.Name

    Write-Output ("Installing Extension '${extensionType}/${extensionPublisher}' on cluster ${clusterName}")

    New-AzStackHciExtension `
        -ClusterName "${clusterName}" `
        -ResourceGroupName "${resourceGroup}" `
        -ArcSettingName "default" `
        -Name "${extensionName}" `
        -ExtensionParameterPublisher "${extensionPublisher}" `
        -ExtensionParameterType "${extensionType}"
}

若要在資源群組下的所有系統上安裝 Azure Site Recovery 擴充功能，請建立 JSON 參數檔案，然後執行下列命令：

$settings = @{
    SubscriptionId = "<Replace with your Subscription Id>"
    Environment = "<Replace with the cloud environment type. For example: AzureCloud>"
    ResourceGroup = "<Replace with your Site Recovery Vault resource group>"
    ResourceName = "<Replace with your Site Recovery Vault Name>"
    Location = "<Replace with your Site Recovery Azure Region>"
    SiteId = "<Replace with the ID of your recovery site>"
    SiteName = "<Replace with your recovery site name>"
    PolicyId = "<Replace with resource ID of your recovery site policy>"
    PrivateEndpointStateForSiteRecovery = "None"
}

$extensionName = "ASRExtension"
$extensionType = "Windows"
$extensionPublisher = "Microsoft.SiteRecovery.Dra"

foreach ($cluster in $clusters) {
    $clusterName = ${cluster}.Name

    Write-Output ("Installing Extension '${extensionType}/${extensionPublisher}' on cluster ${clusterName}")

    New-AzStackHciExtension `
        -ClusterName "${clusterName}" `
        -ResourceGroupName "${resourceGroup}" `
        -ArcSettingName "default" `
        -Name "${extensionName}" `
        -ExtensionParameterPublisher "${extensionPublisher}" `
        -ExtensionParameterType "${extensionType}" `
        -ExtensionParameterSetting ${settings} `
        -NoWait
}

檢查擴充功能狀態

您可以從 [延伸模組] 頁面檢視方格的狀態數據行，檢查每部伺服器上的擴充功能狀態。

Azure CLI 可在 Windows、macOS 和 Linux 環境中安裝。也可以在 Azure Cloud Shell 中執行。如需詳細資訊，請參閱 Azure Cloud Shell 快速入門。

啟動 Azure Cloud Shell 並使用 Bash 來檢查擴充功能的狀態，請遵循下列步驟：

從您的訂用帳戶、資源群組、叢集名稱和延伸模組名稱設定參數

subscription="00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
resourceGroup="hcicluster-rg" # Replace with your resource group name
clusterName="HCICluster" # Replace with your cluster name
extensionName="AzureMonitorWindowsAgent" # Replace with the extension name

az account set --subscription "${subscription}"

若要列出系統上的所有延伸模組，請執行下列命令：

az stack-hci extension list \
--arc-setting-name "default" \
--cluster-name "${clusterName}" \
--resource-group "${resourceGroup}" \
-o table

若要篩選出類似 AzureMonitorWindowsAgent的特定延伸模組，請執行下列命令：

az stack-hci extension list \
--arc-setting-name "default" \
--cluster-name "${clusterName}" \
--resource-group "${resourceGroup}" \
--query "[?name=='${extensionName}'].{Name:name, ManagedBy:managedBy, ProvisionStatus:provisioningState, State:aggregateState, Type:extensionParameters.type}" \
-o table

Azure PowerShell 可以在 Azure Cloud Shell 中執行。本文件詳細說明如何在 Azure Cloud Shell 中使用 PowerShell。如需詳細資訊，請參閱 Azure Cloud Shell 快速入門。

啟動 Azure Cloud Shell 並使用 PowerShell 來檢查擴充功能的狀態，請遵循下列步驟：

從您的訂用帳戶、資源群組和叢集名稱設定參數

$subscription = "00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
$resourceGroup = "hcicluster-rg" # Replace with your resource group name

Set-AzContext -Subscription "${subscription}"
$clusters = Get-AzResource -ResourceType "Microsoft.AzureStackHCI/clusters" -ResourceGroupName ${resourceGroup} | Select-Object -Property Name

若要列出系統上的所有延伸模組，請執行下列命令：

foreach ($cluster in $clusters) {
    $clusterName = ${cluster}.Name
    Get-AzStackHciExtension `
        -ClusterName "${clusterName}" `
        -ResourceGroupName "${resourceGroup}" `
        -ArcSettingName "default"|Format-Table -Property Name, ParameterType, ParameterPublisher, ParameterEnableAutomaticUpgrade, ProvisioningState
}

擴充功能升級的運作方式

當擴充功能發行者小組發佈時，延伸模塊升級程式會以新支援的擴充功能取代現有的擴充功能版本。根據預設，除非您明確退出退出自動升級，否則會針對在已啟用 Azure Local Arc 的叢集上部署的所有延伸模組啟用自動擴充功能。

目前，Windows Admin Center 擴充功能僅支援自動擴充功能升級，但未來將會新增更多擴充功能。

注意

根據預設，所有擴充功能都會設定為啟用自動升級，即使延伸模組不支援自動擴充功能升級也一樣。不過，在延伸模組發行者選擇支援自動擴充功能升級之前，此預設設定沒有任何作用。

啟用自動擴充功能升級

針對某些擴充功能，您可以透過延伸模組管理來啟用自動升級。

若要啟用自動升級，請流覽至 [ 擴充功能 ] 頁面，然後執行下列步驟：

選擇您要啟用自動升級的擴充功能。
從頂端功能表選取 [啟用自動升級]
當系統提示您確認您的意圖時，請選取 [ 確定]。

若要安裝並啟用特定延伸模組的自動升級，請執行 AzureMonitorWindowsAgent 下列命令：

clusterName="HCICluster" # Replace with your cluster name
resourceGroup="hcicluster-rg" # Replace with your resource group name

extensionName="AzureMonitorWindowsAgent"
extensionPublisher="Microsoft.Azure.Monitor"
extensionType="AzureMonitorWindowsAgent"

az stack-hci extension create \
    --name "${extensionName}" \
    --arc-setting-name "default" \
    --cluster-name "${clusterName}" \
    --resource-group "${resourceGroup}" \
    --publisher ${extensionPublisher} \
    --type ${extensionType} \
    --auto-upgrade "true"

若要安裝並啟用特定延伸模組的自動升級，請執行 AzureMonitorWindowsAgent 下列命令：

$clusterName = "HCICluster" # Replace with your cluster name
$resourceGroup = "hcicluster-rg" # Replace with your resource group name

$extensionName = "AzureMonitorWindowsAgent"
$extensionType = "AzureMonitorWindowsAgent"
$extensionPublisher = "Microsoft.Azure.Monitor"

New-AzStackHciExtension `
    -ClusterName "${clusterName}" `
    -ResourceGroupName "${resourceGroup}" `
    -ArcSettingName "default" `
    -Name "${extensionName}" `
    -ExtensionParameterPublisher "${extensionPublisher}" `
    -ExtensionParameterType "${extensionType}" `
    -ExtensionParameterEnableAutomaticUpgrade

透過 Azure 入口網站手動擴充功能升級

手動擴充功能升級的運作方式就像自動擴充功能升級一樣。在已啟用 Azure Local Arc 的叢集上，當您手動升級擴充功能時，Azure 會儲存您選取的版本。然後，Azure 會嘗試將叢集中所有節點上的擴充功能升級至該版本。

在某些伺服器上，如果擴充功能升級失敗，平臺會在下一次 Azure 本機雲端同步處理期間嘗試升級至選取的版本。

在這些案例中使用手動工作流程：

有新版本的擴充功能可供使用，而您想要手動升級。
延伸模組的自動升級選項已停用，且 Azure 本機的不同節點版本不符。

若要手動升級擴充功能，請遵循下列步驟：

移至 [ 延伸模組] 頁面。
選擇您要升級的延伸模組，然後從頂端功能表中選取 [ 設定 ]。
選擇最新版本，然後選取 [ 儲存]。

停用自動擴充功能升級

您可以停用 Azure 入口網站中特定延伸模組的自動升級。若要停用自動升級，請流覽至 [ 擴充功能 ] 頁面，然後執行下列步驟：

選擇您要停用自動升級的擴充功能。
從頂端功能表選取 [停用自動升級 ]。
當系統提示您確認您的意圖時，請選取 [ 確定]。

檢查擴充功能升級歷程記錄

您可以在個別已啟用 Azure Arc 的伺服器資源、資源群組和訂用帳戶上檢視活動記錄索引標籤，以檢查個別節點的自動擴充功能升級歷程記錄。如需詳細資訊，請參閱檢查自動擴充功能升級歷程記錄。

可用性優先更新

針對一組已啟用 Azure Local Arc 的叢集進行升級，Azure 平臺會使用自動擴充功能升級模型來協調升級。

自動延伸模組升級的時機

發行新版支援的擴充功能時，即可在已啟用 Azure Arc 的伺服器上安裝和手動升級。升級會在 Azure 區域和訂用帳戶的批次中發出，因此您可能會在有些伺服器上看到延伸模塊升級發生在其他伺服器上。如需詳細資訊，請參閱自動擴充功能升級的時間。

若要立即升級擴充功能，請參閱透過 Azure 入口網站手動升級擴充功能。

自動復原和重試

如果擴充功能升級失敗，Azure 會執行與自動回復和重試相關聯的動作，以嘗試修復擴充功能。

如果擴充功能升級持續發生問題，您可以停用自動擴充功能升級。當您停用自動升級時，它會在疑難解答問題時防止系統重試。當您準備好時，可以再次啟用自動延伸模組升級。

具有多個延伸模組的升級

如果有多個延伸模塊升級可供節點使用，它們可能會一起批處理。不過，每個擴充功能升級都會個別套用在節點上。如需詳細資訊，請參閱使用多個延伸模組進行擴充功能升級。

解除安裝延伸模組

如有需要，您可以在 Azure 入口網站中從 Azure 本機卸載一些擴充功能。若要卸載擴充功能，請使用下列步驟：

移至 [ 延伸模組] 頁面。
選擇您要卸載的延伸模組。卸載按鈕不適用於 Azure 受控擴充功能。
從頂端功能表中選取 [卸載 ]。
確認意圖，然後選取 [ 是]。

若要移除特定的擴充功能，例如 AzureMonitorWindowsAgent 執行下列命令：

extensionName="AzureMonitorWindowsAgent" # Replace with the extension name
resourceGroup="hcicluster-rg" # Replace with your resource group name
clusterName="HCICluster" # Replace with your cluster name

az stack-hci extension delete \
--arc-setting-name "default" \
--name "${extensionName}" \
--cluster-name "${clusterName}" \
--resource-group "${resourceGroup}"

若要移除特定的擴充功能，例如 AzureMonitorWindowsAgent 執行下列命令：

$clusterName = "HCICluster" # Replace with your cluster name
$resourceGroup = "hcicluster-rg" # Replace with your resource group name

$extensionName = "AzureMonitorWindowsAgent"

Remove-AzStackHciExtension `
    -ClusterName "${clusterName}" `
    -ResourceGroupName "${resourceGroup}" `
    -ArcSettingName "default" `
    -Name "${extensionName}"

針對延伸模組錯誤進行疑難排解

擴充功能狀態：失敗

建議：對於狀態為失敗的擴充功能，請選取 [失敗] [檢視詳細數據] 連結。檢視失敗的所有資訊，並套用疑難解答秘訣。

後續步驟

瞭解已啟用 Azure Arc 的伺服器進行虛擬機擴充功能管理。

共用方式為