More

Author: sethmanheim

AKS-Arc/kubernetes-walkthrough-powershell.md

@@ -1,31 +1,30 @@
 ---
-title: Use PowerShell to set up Kubernetes on Azure Local and Windows Server clusters 
+title: Use PowerShell to set up Kubernetes on Windows Server clusters 
 description: Learn how to set up an AKS host and create Kubernetes clusters using Windows PowerShell.
 author: sethmanheim
 ms.topic: quickstart
-ms.date: 02/21/2025
+ms.date: 03/28/2025
 ms.author: sethm 
 ms.lastreviewed: 05/02/2022
-ms.reviewer: mikek
+ms.reviewer: abha
 ms.custom:
   - mode-api
   - kr2b-contr-experiment
   - devx-track-azurepowershell
 
-# Intent: As an IT Pro, I want to use Windows PowerShell to create an AKS on Azure Local and Windows Server cluster.
-# Keyword: AKS setup PowerShell 
+# Intent: As an IT Pro, I want to use Windows PowerShell to create an AKS on Windows Server cluster.
+# Keyword: AKS set up PowerShell 
 ---
 
-# Set up an Azure Kubernetes Service host on Azure Local and Windows Server and deploy a workload cluster using PowerShell
+# Set up an Azure Kubernetes Service host on Windows Server and deploy a workload cluster using PowerShell
 
-> Applies to: Azure Local or Windows Server Datacenter
+> Applies to: Windows Server Datacenter
 
-This quickstart guides you through setting up an Azure Kubernetes Service (AKS) host. You create Kubernetes clusters on Azure Local and Windows Server using PowerShell. To use Windows Admin Center instead, see [Set up with Windows Admin Center](setup.md).
+This quickstart guides you through setting up an Azure Kubernetes Service (AKS) host. You create Kubernetes clusters on Windows Server using PowerShell. To use Windows Admin Center instead, see [Set up with Windows Admin Center](setup.md).
 
 > [!NOTE]
-> - If you have pre-staged cluster service objects and DNS records, see [Deploy an AKS host with prestaged cluster service objects and DNS records using PowerShell](prestage-cluster-service-host-create.md).
+> - If you pre-staged cluster service objects and DNS records, see [Deploy an AKS host with prestaged cluster service objects and DNS records using PowerShell](prestage-cluster-service-host-create.md).
 > - If you have a proxy server, see [Set up an AKS host and deploy a workload cluster using PowerShell and a proxy server](set-proxy-settings.md).
-> - Installing AKS on Azure Local after setting up Arc VMs is not supported. For more information, see [known issues with Arc VMs](/azure/azure-local/manage/troubleshoot-arc-enabled-vms#limitations-and-known-issues). If you want to install AKS on Azure Local, you must uninstall Arc Resource Bridge and then install AKS on Azure Local. You can deploy a new Arc Resource Bridge again after you clean up and install AKS, but it won't remember the VM entities you created previously.
 
 ## Before you begin
 
@@ -68,17 +67,17 @@ Get-AzResourceProvider -ProviderNamespace Microsoft.KubernetesConfiguration
 Get-AzResourceProvider -ProviderNamespace Microsoft.ExtendedLocation
 ```
 
-## Step 1: Prepare your machine(s) for deployment
+## Step 1: prepare your machine(s) for deployment
 
-Run checks on every physical node to see if all the requirements to install AKS enabled by Arc are satisfied. Open PowerShell as an administrator and run the following [Initialize-AksHciNode](./reference/ps/initialize-akshcinode.md) command on all nodes in your Azure Local and Windows Server cluster:
+Run checks on every physical node to see if all the requirements to install AKS enabled by Arc are satisfied. Open PowerShell as an administrator and run the following [Initialize-AksHciNode](./reference/ps/initialize-akshcinode.md) command on all nodes in your Windows Server cluster:
 
 ```powershell
 Initialize-AksHciNode
 ```
 
-## Step 2: Create a virtual network
+## Step 2: create a virtual network
 
-Run the following commands on any one node in your Azure Local and Windows Server cluster.
+Run the following commands on any one node in your Windows Server cluster.
 
 To get the names of your available switches, run the following command. Make sure the `SwitchType` of your VM switch is **External**:
 
@@ -104,9 +103,9 @@ $vnet = New-AksHciNetworkSetting -name myvnet -vSwitchName "extSwitch" -k8sNodeI
 > [!NOTE]
 > You must customize the values shown in this example command for your environment.
 
-## Step 3: Configure your deployment
+## Step 3: configure your deployment
 
-Run the following commands on any node in your Azure Local and Windows Server cluster.
+Run the following commands on any node in your Windows Server cluster.
 
 To create the configuration settings for the AKS host, use the [Set-AksHciConfig](./reference/ps/set-akshciconfig.md) command. You must specify the `imageDir`, `workingDir`, and `cloudConfigLocation` parameters. If you want to reset your configuration details, run the command again with new parameters.
 
@@ -120,25 +119,25 @@ Set-AksHciConfig -imageDir $csvPath\Images -workingDir $csvPath\ImageStore -clou
 > [!NOTE]
 > You must customize the values shown in this example command for your environment.
 
-## Step 4: Sign in to Azure and configure registration settings
+## Step 4: sign in to Azure and configure registration settings
 
 <a name='option-1-use-your-azure-ad-account-if-you-have-owner-permissions'></a>
 
-### Option 1: Use your Microsoft Entra account if you have "Owner" permissions
+### Option 1: use your Microsoft Entra account if you have "Owner" permissions
 
 Run the following [Set-AksHciRegistration](/azure-stack/aks-hci/reference/ps/set-akshciregistration) PowerShell command with your subscription and resource group name to sign in to Azure. You must have an Azure subscription, and an existing Azure resource group in the Australia East, East US, Southeast Asia, or West Europe Azure regions:
 
 ```powershell
 Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"
 ```
 
-### Option 2: Use an Azure service principal
+### Option 2: use an Azure service principal
 
 If you don't have access to a subscription on which you're an **Owner**, you can register your AKS host to Azure for billing using a service principal. For more information about how to use a service principal, see [register AKS on Azure Local and Windows Server using a service principal](reference/ps/set-akshciregistration.md#register-aks-hybrid-using-a-service-principal).
 
-## Step 5: Start a new deployment
+## Step 5: start a new deployment
 
-Run the following command on any node in your Azure Local or Windows Server cluster.
+Run the following command on any node in your Windows Server cluster.
 
 After you configure your deployment, you must start it in order to install the AKS agents and services, and the AKS host. To begin deployment, run the following command:
 
@@ -152,7 +151,7 @@ Install-AksHci
 > [!WARNING]
 > During installation of your AKS host, a **Kubernetes - Azure Arc** resource type is created in the resource group that's set during registration. Do not delete this resource, as it represents your AKS host. You can identify the resource by checking its distribution field for a value of `aks_management`. If you delete this resource, it results in an out-of-policy deployment.
 
-## Step 6: Create a Kubernetes cluster
+## Step 6: create a Kubernetes cluster
 
 After you install your AKS host, you can deploy a Kubernetes cluster. Open PowerShell as an administrator and run the following [New-AksHciCluster](./reference/ps/new-akshcicluster.md) command. This example command creates a new Kubernetes cluster with one Linux node pool named `linuxnodepool` with a node count of 1.
 
@@ -196,7 +195,7 @@ VmSize       : Standard_K8S3_v1
 Phase        : Deployed
 ```
 
-## Step 7: Connect your cluster to Arc-enabled Kubernetes
+## Step 7: connect your cluster to Arc-enabled Kubernetes
 
 Connect your cluster to Arc-enabled Kubernetes by running the [Enable-AksHciArcConnection](./reference/ps/enable-akshciarcconnection.md) command. The following example connects your Kubernetes cluster to Arc using the subscription and resource group details you passed in the `Set-AksHciRegistration` command:
 
@@ -225,7 +224,7 @@ Set-AksHciNodePool -clusterName mycluster -name linuxnodepool -count 3
 ```
 
 > [!NOTE]
-> In previous versions of AKS on Azure Local and Windows Server, the [Set-AksHciCluster](/azure-stack/aks-hci/reference/ps/set-akshcicluster) command was also used to scale worker nodes. Now that AKS is introducing node pools in workload clusters, you can only use this command to scale worker nodes if your cluster was created with the old parameter set in [New-AksHciCluster](/azure-stack/aks-hci/reference/ps/new-akshcicluster).
+> In previous versions of AKS on Windows Server, the [Set-AksHciCluster](/azure-stack/aks-hci/reference/ps/set-akshcicluster) command was also used to scale worker nodes. Now that AKS is introducing node pools in workload clusters, you can only use this command to scale worker nodes if your cluster was created with the old parameter set in [New-AksHciCluster](/azure-stack/aks-hci/reference/ps/new-akshcicluster).
 
 To scale worker nodes in a node pool, use the [Set-AksHciNodePool](/azure-stack/aks-hci/reference/ps/set-akshcinodepool) command.
 

AKS-Arc/setup.md

@@ -3,7 +3,7 @@ title: Quickstart to set up AKS enabled by Azure Arc using Windows Admin Center
 description: Learn how to set up AKS enabled by Azure Arc using Windows Admin Center
 author: sethmanheim
 ms.topic: quickstart
-ms.date: 12/27/2023
+ms.date: 03/28/2025
 ms.author: sethm 
 ms.lastreviewed: 03/16/2022
 ms.reviewer: dawhite
@@ -77,7 +77,7 @@ Now that you verified the system settings, follow these steps:
 
    [![Screenshot that illustrates a static IP configuration on the Host Configuration page.](.\media\setup\host-configuration-static.png)](.\media\setup\host-configuration-static.png#lightbox)
 
-   (Optional) Configure proxy settings as required for the AKS host. These settings are dependent on the proxy settings that are provisioned on the Azure Local host machine. Make sure you also provision the list of IP addresses that needs to bypass the proxy. When complete, select **Next: Review + Create**.
+   (Optional) Configure proxy settings as required for the AKS host. Make sure you also provision the list of IP addresses that needs to bypass the proxy. When complete, select **Next: Review + Create**.
 
    [![Screenshot that shows the optional proxy settings that you configure on the Host Configuration page.](.\media\setup\proxy-settings-host-configuration.png)](.\media\setup\proxy-settings-host-configuration.png#lightbox)
 

AKS-Arc/tutorial-kubernetes-prepare-application.md

@@ -8,7 +8,7 @@ ms.lastreviewed: 1/14/2022
 ms.reviewer: jeguan
 author: sethmanheim
 
-# Intent: As an IT Pro, I want to learn how to prepare a multi-purpose application so I can add it to my AKS on Azure Local deployment.
+# Intent: As an IT Pro, I want to learn how to prepare a multi-purpose application so I can add it to my AKS deployment.
 # Keyword: multi-container Kubernetes service
 
 ---