Merge branch 'main' into md-crash-dump

Author: Manika Dhiman

azure-local/overview.md

@@ -102,7 +102,7 @@ You can use the Azure portal for an increasing number of tasks including:
 
 You can also subscribe to additional Azure hybrid services.
 
-For more details on the cloud service components of Azure Local, see [Azure Local hybrid capabilities with Azure services](./hybrid-capabilities-with-azure-services-23h2.md
+For more details on the cloud service components of Azure Local, see [Azure Local hybrid capabilities with Azure services](./hybrid-capabilities-with-azure-services-23h2.md).
 
 ## What you need for Azure Local
 

azure-stack/asdk/index.yml

@@ -6,8 +6,8 @@ summary: Learn how to deploy and use the Azure Stack Development Kit.
 metadata:
   title: Azure Stack Development Kit Documentation - Tutorials, API Reference # Required; page title displayed in search results. Include the brand. < 60 chars.
   description: The Azure Stack Development Kit (ASDK) is a single-node deployment of Azure Stack that you can download and use for free. The ASDK is meant to provide an environment in which you can evaluate Azure Stack and develop modern applications using APIs and tooling consistent with Azure in a non-production environment.
-  ms.service: azure-stack
-  ms.subservice: asdk 
+  ms.service: azure-stack-hub
+  ms.subservice: azure-stack-hub-asdk 
   ms.topic: landing-page
   author: sethmanheim
   ms.author: sethm

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/mdc/index.yml

@@ -6,8 +6,8 @@ summary: Learn how to operate and use the Azure Modular Data Center (MDC).
 metadata:
   title: Azure Modular Data Center (MDC) Operator and User Documentation - Tutorials, Concepts, How to articles # Required; page title displayed in search results. Include the brand. < 60 chars.
   description: The Azure Modular Data Center (MDC) is a modular data center that contains Azure Stack Hub solutions and storage. You can provide Azure services and host large scale compute and storage on-premises or at the edge, either disconnected from Azure or connected to it. It’s optimized for use cases that require data sovereignty and on-premises control.
-  ms.service: azure-stack
-  ms.subservice: asdk 
+  ms.service: azure-stack-hub
+  ms.subservice: azure-stack-hub-mdc
   ms.topic: landing-page
   author: sethmanheim
   ms.author: sethm

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

@@ -6,8 +6,7 @@ summary: Learn how to validate your hardware to host Azure Stack Hub. Validation
 metadata:
   title: Azure Stack Hub partner # Required; page title displayed in search results. Include the brand. < 60 chars.
   description: Learn how to validate your hardware to host Azure Stack Hub. Validation as a Service is a native Azure Service designed for use by solution partners who are co-engineering offerings with Microsoft.
-  ms.service: azure-stack
-  ms.subservice: partner
+  ms.service: azure-stack-hub
   ms.topic: landing-page
   author: sethmanheim
   ms.author: sethm

azure-stack/operator/azure-stack-powershell-configure-admin.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).