Merge pull request #265896 from vrapolinario/main

New Azure Hybrid Benefit docs page for AKS

Author: v-regandowner

articles/aks/TOC.yml

@@ -719,6 +719,8 @@
           href: windows-aks-customer-stories.md
         - name: Migration and modernization solutions for Windows containers on AKS
           href: windows-aks-migration-modernization-solutions.md
+        - name: Use Azure Hybrid Benefit
+          href: azure-hybrid-benefit.md
     - name: Develop and run applications
       items:
         - name: Install existing applications with Helm

articles/aks/azure-hybrid-benefit.md

@@ -0,0 +1,84 @@
+---
+title: Use Azure Hybrid Benefit
+titleSuffix: Azure Kubernetes Service
+description: Learn how to save costs for Windows workloads by using existing Windows Server licenses on Azure Kubernetes Service.
+ms.topic: article
+ms.date: 02/09/2024
+ms.author: viniap
+author: vrapolinario
+---
+
+# What is Azure Hybrid Benefit for Azure Kubernetes Service?
+
+Azure Hybrid Benefit is a program that enables you to significantly reduce the costs of running workloads in the cloud. With Azure Hybrid Benefit for Azure Kubernetes Service (AKS), you can maximize the value of your on-premises licenses and modernize your applications at no extra cost. Azure Hybrid Benefit enables you to use your on-premises licenses that also have either active Software Assurance (SA) or a qualifying subscription to get Windows virtual machines (VMs) on Azure at a reduced cost.
+
+For more information on qualifications for Azure Hybrid Benefit, what is included with it, how to stay compliant, and more, check out [Azure Hybrid Benefit for Windows Server](/azure/virtual-machines/windows/hybrid-use-benefit-licensing).
+
+>[!Note]
+>Azure Hybrid Benefit for Azure Kubernetes Service follows the same licensing guidance as Azure Hybrid Benefit for Windows Server VMs on Azure.
+
+## Enable Azure Hybrid Benefit for Azure Kubernetes Service
+
+Azure Hybrid Benefit for Azure Kubernetes Service can be enabled at cluster creation or on an existing AKS cluster. You can enable and disable Azure Hybrid Benefit using either the Azure CLI or Azure PowerShell. In the following examples, be sure to replace the variable definitions with values matching your own cluster.
+
+### Use Azure CLI to manage Azure Hybrid Benefit for AKS
+
+To create a new AKS cluster with Azure Hybrid Benefit enabled:
+
+```azurecli
+PASSWORD='tempPassword1234$'
+RG_NAME='myResourceGroup'
+CLUSTER='myAKSCluster'
+
+az aks create --resource-group $RG_NAME --name $CLUSTER --load-balancer-sku Standard --network-plugin azure --windows-admin-username azure --windows-admin-password $PASSWORD --enable-ahub
+```
+
+To enable Azure Hybrid Benefit on an existing AKS cluster:
+
+```azurecli
+RG_NAME='myResourceGroup'
+CLUSTER='myAKSCluster'
+
+az aks update --resouce-group $RG_NAME --name $CLUSTER--enable-ahub
+```
+
+To disable Azure Hybrid Benefit for an AKS cluster:
+
+```azurecli
+RG_NAME='myResourceGroup'
+CLUSTER='myAKSCluster'
+
+az aks update --resource-group $RG_NAME --name $CLUSTER --disable-ahub
+```
+
+### Use Azure PowerShell to manage Azure Hybrid Benefit for AKS
+
+To create a new AKS cluster with Azure Hybrid Benefit enabled:
+
+```powershell
+$password= ConvertTo-SecureString -AsPlainText "Password!!123" -Force
+$rg_name = "myResourceGroup"
+$cluster = "myAKSCluster"
+
+New-AzAksCluster -ResourceGroupName $rg_name -Name $cluster -WindowsProfileAdminUserName azureuser -WindowsProfileAdminUserPassword $cred -NetworkPlugin azure -NodeVmSetType VirtualMachineScaleSets --EnableAHUB
+```
+
+To enable Azure Hybrid Benefit on an existing AKS cluster:
+
+```powershell
+$rg_name = "myResourceGroup"
+$cluster = "myAKSCluster"
+
+Get-AzAksCluster -ResourceGroupName $rg_name -Name $cluster | Set-AzAksCluster -EnableAHUB
+```
+
+>[!Note]
+>It is currently not possible to disable Azure Hybrid Benefit for AKS using Azure PowerShell.
+
+## Next steps
+
+To learn more about Windows containers on AKS, see the following resources:
+
+* [Learn how to deploy, manage, and monitor Windows containers on AKS](/training/paths/deploy-manage-monitor-wincontainers-aks).
+* Open an issue or provide feedback in the [Windows containers GitHub repository](https://github.com/microsoft/Windows-Containers/issues).
+* Review the [third-party partner solutions for Windows on AKS](windows-aks-partner-solutions.md).