Azure Stack HCI 上的 Azure Arc 延伸模組管理

發行項
04/01/2024

適用於：Azure Stack HCI 版本 23H2 和 22H2

本文說明如何在 Azure Stack HCI 伺服器機器上安裝、升級及管理 Azure Arc 延伸模組。

Azure Stack HCI 上客戶管理的 Azure Arc 延伸模組

透過 Azure Stack HCI，您可以在 Azure Stack HCI 系統上安裝、卸載及更新 Azure Arc 擴充功能。 Azure Arc 可讓您在 Azure 入口網站中執行監視和 Windows Admin Center 等混合式服務。

以下是您可以安裝和管理的個別擴充功能。

Azure Stack HCI 中的 Azure 受控延伸模組

成功向 Azure 註冊新的 Azure Stack HCI 叢集之後，Azure 受控擴充功能會自動安裝在叢集上。這些延伸模組對於系統的功能和品質而言是不可或缺的，而且無法卸載。您可以流覽至 [延伸模組] 頁面並選取 [設定] 功能表，以管理這些延伸模組在 Azure 入口網站中的行為。

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

以下是 Azure 管理的擴充功能：

安裝延伸模組

您可以從已啟用 Azure Stack HCI 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 Stack HCI 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 Stack HCI Arc 的叢集上，當您手動升級擴充功能時，Azure 會儲存您選取的版本。然後，Azure 會嘗試將叢集中所有伺服器上的擴充功能升級至該版本。

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

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

有新版本的擴充功能可供使用，而您想要手動升級。
擴充功能的自動升級選項已停用，而且 Azure Stack HCI 叢集的不同伺服器之間版本不符。

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

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

停用自動擴充功能升級

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

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

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

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

可用性優先更新

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

自動擴充功能升級的時間

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

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

自動復原和重試

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

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

使用多個延伸模組升級

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

解除安裝延伸模組

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

移至 [ 延伸模組] 頁面。
選擇您要卸載的擴充功能。卸載按鈕不適用於 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 的伺服器進行虛擬機擴充功能管理。

Share via

Azure Stack HCI 上的 Azure Arc 延伸模組管理

Azure Stack HCI 上客戶管理的 Azure Arc 延伸模組

Azure Stack HCI 中的 Azure 受控延伸模組

安裝延伸模組

檢查擴充功能狀態

擴充功能升級的運作方式

啟用自動擴充功能升級

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

停用自動擴充功能升級

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

可用性優先更新

自動擴充功能升級的時間

自動復原和重試

使用多個延伸模組升級

解除安裝延伸模組

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

後續步驟

意見反應

意見反應

其他資源

Share via

Azure Stack HCI 上的 Azure Arc 延伸模組管理

Azure Stack HCI 上客戶管理的 Azure Arc 延伸模組

Azure Stack HCI 中的 Azure 受控延伸模組

安裝延伸模組

檢查擴充功能狀態

擴充功能升級的運作方式

啟用自動擴充功能升級

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

停用自動擴充功能升級

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

可用性優先更新

自動擴充功能升級的時間

自動復原和重試

使用多個延伸模組升級

解除安裝延伸模組

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

後續步驟

意見反應

意見反應

其他資源

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