Merge pull request #16859 from sethmanheim/frsh1-24

Hub freshness pass

Author: sethmanheim

azure-stack/includes/note-powershell-adfs.md

@@ -3,10 +3,8 @@ author: sethmanheim
 ms.author: sethm
 ms.service: azure-stack
 ms.topic: include
-ms.date: 2/1/2021
-ms.reviewer: thoroet
-ms.lastreviewed: 08/04/2020
+ms.date: 01/24/2025
 ---
 
-> [!Note]  
-> AD FS only supports interactive authentication with user identities. If a credential object is required, you must use a service principal (SPN). For more information on setting up a service principal with Azure Stack Hub and AD FS as your identity management service, see [Manage an AD FS app identity](../operator/give-app-access-to-resources.md#manage-an-azure-ad-app).
+> [!NOTE]
+> AD FS only supports interactive authentication with user identities. If a credential object is required, you must use a service principal (SPN). For more information about setting up a service principal with Azure Stack Hub and AD FS as your identity management service, see [Manage an AD FS app identity](../operator/give-app-access-to-resources.md#manage-an-azure-ad-app).

azure-stack/includes/remove-account-az.md

@@ -2,13 +2,11 @@
 title: Include for Remove-AzureRmAccount 
 description: An include file that explains how to run Remove-AzureRmAccount.
 author: sethmanheim
-
 ms.topic: include
-ms.date: 11/23/2020
+ms.date: 01/23/2025
 ms.author: sethm
-ms.reviewer: avishwan
 ms.lastreviewed: 11/23/2020
 ---
 
->[!Note]
->If your session expires, your password has changed, or you simply wish to switch accounts, run the following cmdlet before you sign in using Connect-AzAccount: `Remove-AzAccount -Scope Process`
+> [!NOTE]
+> If your session expires, your password has changed, or you want to switch accounts, run the following cmdlet before you sign in using `Connect-AzAccount`: `Remove-AzAccount -Scope Process`.

azure-stack/operator/azure-stack-integrate-security.md

@@ -2,12 +2,11 @@
 title: Connect to Azure Stack Hub with PowerShell 
 description: Learn how to connect to Azure Stack Hub with PowerShell.
 author: sethmanheim
-
 ms.topic: article
-ms.date: 2/1/2021
+ms.date: 01/24/2025
 ms.author: sethm
 ms.reviewer: thoroet
-ms.lastreviewed: 2/1/2021
+ms.lastreviewed: 02/01/2021
 
 # Intent: As an Azure Stack operator, I want to learn how to connect to Azure Stack using Powershell.
 # Keyword: connect azure stack powershell
@@ -17,7 +16,7 @@ ms.lastreviewed: 2/1/2021
 
 # Connect to Azure Stack Hub with PowerShell
 
-You can configure Azure Stack Hub to use PowerShell to manage resources like creating offers, plans, quotas, and alerts. This topic helps you configure the operator environment.
+You can configure Azure Stack Hub to use PowerShell to manage resources like creating offers, plans, quotas, and alerts. This article helps you configure the operator environment.
 
 ## Prerequisites
 
@@ -30,11 +29,9 @@ Run the following prerequisites either from the [Azure Stack Development Kit (AS
 
 ## Connect with Microsoft Entra ID
 
-To configure the Azure Stack Hub operator environment with PowerShell, run one of the scripts below. Replace the Microsoft Entra tenantName and Azure Resource Manager endpoint values with your own environment configuration.
-
-### [Az modules](#tab/az1)
+To configure the Azure Stack Hub operator environment with PowerShell, run the following script. Replace the Microsoft Entra tenantName and Azure Resource Manager endpoint values with your own environment configuration.
 
-[!include[Remove Account](../includes/remove-account-az.md)]
+[!INCLUDE [remove-account-az](../includes/remove-account-az.md)]
 
 ```powershell  
     # Register an Azure Resource Manager environment that targets your Azure Stack Hub instance. Get your Azure Resource Manager endpoint value from your service provider.
@@ -51,79 +48,17 @@ To configure the Azure Stack Hub operator environment with PowerShell, run one o
     # can be easily targeted at your Azure Stack Hub instance.
     Connect-AzAccount -EnvironmentName "AzureStackAdmin" -TenantId $TenantId
 ```
-### [AzureRM modules](#tab/azurerm1)
-
-[!include[Remove Account](../includes/remove-account-azurerm.md)]
-
-```powershell  
-    # Register an Azure Resource Manager environment that targets your Azure Stack Hub instance. Get your Azure Resource Manager endpoint value from your service provider.
-    Add-AzureRMEnvironment -Name "AzureStackAdmin" -ArmEndpoint "https://adminmanagement.local.azurestack.external" `
-      -AzureKeyVaultDnsSuffix adminvault.local.azurestack.external `
-      -AzureKeyVaultServiceEndpointResourceId https://adminvault.local.azurestack.external
-
-    # Set your tenant name.
-    $AuthEndpoint = (Get-AzureRmEnvironment -Name "AzureStackAdmin").ActiveDirectoryAuthority.TrimEnd('/')
-    $AADTenantName = "<myDirectoryTenantName>.onmicrosoft.com"
-    $TenantId = (invoke-restmethod "$($AuthEndpoint)/$($AADTenantName)/.well-known/openid-configuration").issuer.TrimEnd('/').Split('/')[-1]
-
-    # After signing in to your environment, Azure Stack Hub cmdlets
-    # can be easily targeted at your Azure Stack Hub instance.
-    Add-AzureRmAccount -EnvironmentName "AzureStackAdmin" -TenantId $TenantId
-```
-
----
-
-
-## Connect with AD FS
-
-Connect to the Azure Stack Hub operator environment with PowerShell with Microsoft Entra ID Federated Services (Azure AD FS). For the ASDK, this Azure Resource Manager endpoint is set to `https://adminmanagement.local.azurestack.external`. To get the Azure Resource Manager endpoint for Azure Stack Hub integrated systems, contact your service provider.
 
-### [Az modules](#tab/az2)
-
-  ```powershell  
-  # Register an Azure Resource Manager environment that targets your Azure Stack Hub instance. Get your Azure Resource Manager endpoint value from your service provider.
-    Add-AzEnvironment -Name "AzureStackAdmin" -ArmEndpoint "https://adminmanagement.local.azurestack.external" `
-      -AzureKeyVaultDnsSuffix adminvault.local.azurestack.external `
-      -AzureKeyVaultServiceEndpointResourceId https://adminvault.local.azurestack.external
-
-  # Sign in to your environment.
-  Connect-AzAccount -EnvironmentName "AzureStackAdmin"
-  ```
-
-### [AzureRM modules](#tab/azurerm2)
-
-```powershell  
-# Register an Azure Resource Manager environment that targets your Azure Stack Hub instance. Get your Azure Resource Manager endpoint value from your service provider.
-  Add-AzureRMEnvironment -Name "AzureStackAdmin" -ArmEndpoint "https://adminmanagement.local.azurestack.external" `
-    -AzureKeyVaultDnsSuffix adminvault.local.azurestack.external `
-    -AzureKeyVaultServiceEndpointResourceId https://adminvault.local.azurestack.external
-
-# Sign in to your environment.
-Login-AzureRmAccount -EnvironmentName "AzureStackAdmin"
-```
-
----
-
-[!Include [AD FS only supports interactive authentication with user identities](../includes/note-powershell-adfs.md)]
+[!INCLUDE [note-powershell-adfs](../includes/note-powershell-adfs.md)]
 
 ## Test the connectivity
 
-Now that you've got everything set-up, use PowerShell to create resources within Azure Stack Hub. For example, you can create a resource group for an app and add a virtual machine. Use the following command to create a resource group named **MyResourceGroup**.
+Now that you have everything set up, use PowerShell to create resources within Azure Stack Hub. For example, you can create a resource group for an app and add a virtual machine. Use the following command to create a resource group named **MyResourceGroup**:
 
-### [Az modules](#tab/az3)
 ```powershell  
 New-AzResourceGroup -Name "MyResourceGroup" -Location "Local"
 ```
 
-### [AzureRM modules](#tab/azurerm3)
-
-```powershell  
-New-AzureRmResourceGroup -Name "MyResourceGroup" -Location "Local"
-```
-
----
-
-
 ## Next steps
 
 - [Use PowerShell to manage subscriptions, plans, and offers in Azure Stack Hub](azure-stack-powershell-plan-offer.md)

azure-stack/operator/azure-stack-network.md

@@ -2,12 +2,11 @@
 title: Deploy Python web app to VM in Azure Stack Hub
 description: Deploy a Python web app to a virtual machine in Azure Stack Hub.
 author: sethmanheim
-
 ms.topic: how-to
-ms.date: 9/29/2021
+ms.date: 01/24/2025
 ms.author: sethm
 ms.reviewer: thoroet
-ms.lastreviewed: 9/29/2021
+ms.lastreviewed: 09/29/2021
 
 # Intent: As an Azure Stack Hub user, I want to deploy a Python web app to a virtual machine in Azure Stack Hub.
 # Keyword: deploy python webapp VM azure stack hub
@@ -18,100 +17,97 @@ ms.lastreviewed: 9/29/2021
 You can create a VM to host your Python web app in Azure Stack Hub. In this article, you set up a server, configure the server to host your Python web app, and then deploy the app to Azure Stack Hub.
 
 This article uses Python 3.x running Flask in a virtual environment on an Nginx server. Use **Ubuntu Server 18.04 LTS** from the Azure Stack Hub Marketplace.
+
 ## Create a VM
 
 1. Set up your VM in Azure Stack Hub by following the instructions in [Deploy a Linux VM to host a web app in Azure Stack Hub](azure-stack-dev-start-howto-deploy-linux.md). Use **Ubuntu Server 18.04 LTS** from the Azure Stack Hub Marketplace.
+1. In the VM network pane, make sure that the following ports are accessible:
 
-2. In the VM network pane, make sure that the following ports are accessible:
-
-    | Port | Protocol | Description |
-    | --- | --- | --- |
-    | 80 | HTTP | Hypertext Transfer Protocol (HTTP) is the protocol that's used to deliver webpages from servers. Clients connect via HTTP with a DNS name or IP address. |
-    | 443 | HTTPS | Hypertext Transfer Protocol Secure (HTTPS) is a secure version of HTTP that requires a security certificate and allows for the encrypted transmission of information. |
-    | 22 | SSH | Secure Shell (SSH) is an encrypted network protocol for secure communications. You use this connection with an SSH client to configure the VM and deploy the app. |
-    | 3389 | RDP | Optional. The Remote Desktop Protocol (RDP) allows a remote desktop connection to use a graphic user interface on your machine.   |
-    | 5000, 8000 | Custom | The ports that are used by the Flask web framework in development. For a production server, you route your traffic through 80 and 443. |
+   | Port | Protocol | Description |
+   | --- | --- | --- |
+   | 80 | HTTP | Hypertext Transfer Protocol (HTTP) is the protocol that's used to deliver webpages from servers. Clients connect via HTTP with a DNS name or IP address. |
+   | 443 | HTTPS | Hypertext Transfer Protocol Secure (HTTPS) is a secure version of HTTP that requires a security certificate and allows for the encrypted transmission of information. |
+   | 22 | SSH | Secure Shell (SSH) is an encrypted network protocol for secure communications. You use this connection with an SSH client to configure the VM and deploy the app. |
+   | 3389 | RDP | Optional. The Remote Desktop Protocol (RDP) allows a remote desktop connection to use a graphic user interface on your machine.   |
+   | 5000, 8000 | Custom | The ports that are used by the Flask web framework in development. For a production server, you route your traffic through 80 and 443. |
 
-3. In the **Overview** pane, select **configure** under DNS name.
-
-4. Select **static** and then name the machine so that you have a DNS name such as: `<yourmachine>.<local>.cloudapp.azurestack.contoso.com`.
+1. In the **Overview** pane, select **configure** under DNS name.
+1. Select **static** and then name the machine so that you have a DNS name such as: `<yourmachine>.<local>.cloudapp.azurestack.contoso.com`.
 
 ## Install Python
 
 1. Connect to your VM by using your SSH client. For instructions, see [Connect via SSH with PuTTy](azure-stack-dev-start-howto-ssh-public-key.md#connect-with-ssh-by-using-putty).
-2. At your bash prompt on your VM, enter the following command:
+1. At your bash prompt on your VM, enter the following command:
 
-    ```bash  
-    sudo apt-get update
-    sudo apt-get -y install python3 python3-dev
-    sudo apt install python3-pip
-    ```
+   ```bash  
+   sudo apt-get update
+   sudo apt-get -y install python3 python3-dev
+   sudo apt install python3-pip
+   ```
 
-3. Validate your installation. While you're still connected to your VM in your SSH session, enter the following command to open Python and note the version number. Then type `quit()` to exit the Python REPL.
+1. Validate your installation. While you're still connected to your VM in your SSH session, enter the following command to open Python and note the version number. Then type `quit()` to exit the Python REPL.
 
-    ```bash  
-    python3
-    quit()
-    ```
+   ```bash  
+   python3
+   quit()
+   ```
 
-3. [Install Nginx](https://www.nginx.com/resources/wiki/), a lightweight web server. While you're still connected to your VM in your SSH session, enter the following command:
+1. [Install Nginx](https://www.nginx.com/resources/wiki/), a lightweight web server. While you're still connected to your VM in your SSH session, enter the following command:
 
-    ```bash  
-    sudo apt-get -y install nginx
-    ```
+   ```bash  
+   sudo apt-get -y install nginx
+   ```
 
-4. [Install Git](https://git-scm.com), a widely distributed version control and source code management (SCM) system. While you're still connected to your VM in your SSH session, enter the following command:
+1. [Install Git](https://git-scm.com). While you're still connected to your VM in your SSH session, enter the following command:
 
-    ```bash  
-    sudo apt-get -y install git
-    ```
+   ```bash  
+   sudo apt-get -y install git
+   ```
 
 ## Deploy and run the app
 
 1. Set up your Git repository on the VM. While you're still connected to your VM in your SSH session, enter the following commands:
 
-    ```bash  
-       git clone https://github.com/Azure-Samples/azure-stack-hub-flask-hello-world.git
-    
-       cd azure-stack-hub-flask-hello-world
-    ```
+   ```bash  
+   git clone https://github.com/Azure-Samples/azure-stack-hub-flask-hello-world.git   
+   cd azure-stack-hub-flask-hello-world
+   ```
 
-2. While you're still connected to your VM in your SSH session, enter the following commands to install the dependencies. Install Flask using apt, and then pip to load the modules from `requirements.txt`.
+1. While you're still connected to your VM in your SSH session, enter the following commands to install the dependencies. Install Flask using apt, and then pip to load the modules from `requirements.txt`:
 
-    ```bash  
-    sudo apt install python3-flask
-    pip3 install -r requirements.txt
+   ```bash  
+   sudo apt install python3-flask
+   pip3 install -r requirements.txt
 
-    export FLASK_APP=application.py
-    flask run -h 0.0.0.0
-    ```
+   export FLASK_APP=application.py
+   flask run -h 0.0.0.0
+   ```
 
-3. Go to your new server. You should see your running web application.
+1. Go to your new server. You should see your running web application.
 
-    ```HTTP  
-    <yourmachine>.<local>.cloudapp.azurestack.contoso.com:5000
-    ```
+   ```HTTP  
+   <yourmachine>.<local>.cloudapp.azurestack.contoso.com:5000
+   ```
 
 ## Update your server
 
 1. Connect to your VM in your SSH session. Stop the server by typing Ctrl+C.
+1. Enter the following commands:
 
-2. Enter the following commands:
-
-    ```bash  
-    cd azure-stack-hub-flask-hello-world
-    git pull
-    ```
+   ```bash  
+   cd azure-stack-hub-flask-hello-world
+   git pull
+   ```
 
-3. Activate the virtual environment and start the app:
+1. Activate the virtual environment and start the app:
 
-    ```bash  
-    export FLASK_APP=application.py
-    flask run -h 0.0.0.0
-    ```
+   ```bash  
+   export FLASK_APP=application.py
+   flask run -h 0.0.0.0
+   ```
 
 ## Next steps
 
-- Learn more about how to [develop for Azure Stack Hub](azure-stack-dev-start.md).
+- Learn more about [how to develop for Azure Stack Hub](azure-stack-dev-start.md).
 - Learn about [common deployments for Azure Stack Hub as IaaS](azure-stack-dev-start-deploy-app.md).
 - To learn the Python programming language and find additional resources for Python, see [Python.org](https://www.python.org).

azure-stack/operator/azure-stack-powershell-configure-admin.md

@@ -1,12 +1,10 @@
 ---
-title: What is AKS engine on Azure Stack Hub? 
+title: What is the AKS engine on Azure Stack Hub? 
 description: Learn how to use the AKS engine command-line tool to deploy and manage a Kubernetes cluster on Azure and Azure Stack Hub. 
 author: sethmanheim
-
 ms.topic: article
-ms.date: 12/19/2022
+ms.date: 01/24/2025
 ms.author: sethm
-ms.reviewer: waltero
 ms.lastreviewed: 09/02/2020
 
 # Intent: As an Azure Stack Hub user, I want to learn how to use the AKS engine command-line so that I can deploy and manage a Kubernetes cluster on Azure and Azure Stack Hub.
@@ -15,31 +13,29 @@ ms.lastreviewed: 09/02/2020
 ---
 
 
-# What is AKS engine on Azure Stack Hub?
+# What is the AKS engine on Azure Stack Hub?
 
 You can use the AKS engine command-line tool to deploy and manage a Kubernetes cluster on Azure and Azure Stack Hub. Use AKS engine to create, upgrade, and scale Azure Resource Manager native clusters. You can use the engine to deploy a cluster in both connected and disconnected environments. This article provides an overview of AKS engine, supported scenarios for using the engine with Azure Stack Hub, and an introduction to operations such as deploy, upgrade, and scale.
 
-## Overview of AKS engine
+## Overview of the AKS engine
 
-[AKS engine](https://github.com/Azure/aks-engine) provides a command-line tool to bootstrap Kubernetes clusters on Azure and Azure Stack Hub. By using the Azure Resource Manager, AKS engine helps you create and maintain clusters running on VMs, virtual networks, and other infrastructure-as-a-service (IaaS) resources in Azure Stack Hub.
+The [AKS engine](https://github.com/Azure/aks-engine) provides a command-line tool to bootstrap Kubernetes clusters on Azure and Azure Stack Hub. By using the Azure Resource Manager, AKS engine helps you create and maintain clusters running on VMs, virtual networks, and other infrastructure-as-a-service (IaaS) resources in Azure Stack Hub.
 
 ## AKS engine on Azure Stack Hub considerations
 
-Before you use AKS engine on Azure Stack Hub, it's important to understand the differences between Azure Stack Hub and Azure. This section identifies different features and key considerations when using Azure Stack Hub with AKS engine to manage your Kubernetes cluster.
-
-For more information on the specifics of AKS engine on Azure Stack Hub and its differences with respect to Azure, see [AKS engine on Azure Stack Hub](https://github.com/Azure/aks-engine/blob/master/docs/topics/azure-stack.md).
+Before you use the AKS engine on Azure Stack Hub, it's important to understand the differences between Azure Stack Hub and Azure. This section identifies different features and key considerations when using Azure Stack Hub with AKS engine to manage your Kubernetes cluster.
 
-For more information on AKS engine and Azure Stack Hub, see [Support policies for AKS engine on Azure Stack Hub](azure-stack-kubernetes-aks-engine-support.md).
+For more information about the AKS engine and Azure Stack Hub, see [Support policies for AKS engine on Azure Stack Hub](azure-stack-kubernetes-aks-engine-support.md).
 
-## Install AKS engine and deploy a Kubernetes cluster
+## Install the AKS engine and deploy a Kubernetes cluster
 
-To deploy a Kubernetes cluster with AKS engine on Azure Stack Hub:
+To deploy a Kubernetes cluster with the AKS engine on Azure Stack Hub:
 
-1. [Set up the prerequisites for AKS engine](azure-stack-kubernetes-aks-engine-set-up.md)
-2. Install AKS engine on a machine with access to your Azure Stack Hub environment.
+1. [Set up the prerequisites for the AKS engine](azure-stack-kubernetes-aks-engine-set-up.md)
+1. Install the AKS engine on a machine with access to your Azure Stack Hub environment.
      - [Install AKS engine on Windows in Azure Stack Hub](azure-stack-kubernetes-aks-engine-deploy-windows.md)
      - [Install AKS engine on Linux in Azure Stack Hub](azure-stack-kubernetes-aks-engine-deploy-linux.md)
-3. [Deploy a Kubernetes cluster with AKS engine on Azure Stack Hub](azure-stack-kubernetes-aks-engine-deploy-cluster.md)
+1. [Deploy a Kubernetes cluster with AKS engine on Azure Stack Hub](azure-stack-kubernetes-aks-engine-deploy-cluster.md)
 
 ## Next steps