More articles

sethmanheim · sethmanheim · commit a071b800c88c · 2024-08-15T14:03:40.000-07:00
diff --git a/azure-stack/operator/azure-stack-add-users-adfs.md b/azure-stack/operator/azure-stack-add-users-adfs.md
@@ -3,7 +3,7 @@ title: Add Azure Stack Hub users in AD FS
 description: Learn how to add Azure Stack Hub users for Active Directory Federation Services (AD FS) deployments.
 author: sethmanheim
 ms.topic: article
-ms.date: 06/03/2019
+ms.date: 08/15/2024
 ms.author: sethm
 ms.reviewer: unknown
 ms.lastreviewed: 06/03/2019
@@ -19,19 +19,18 @@ You can use the **Active Directory Users and Computers** snap-in to add addition
 
 ## Add Windows Server Active Directory users
 
-1. Sign in to a computer with an account that provides access to the Windows Administrative Tools and open a new Microsoft Management Console (MMC).
-2. Select **File > Add or remove snap-in**.
+1. Sign in to a computer with an account that provides access to the Windows administrative tools and open a new Microsoft Management Console (MMC).
+1. Select **File > Add or remove snap-in**.
 
    > [!TIP]
-   > Replace *directory-domain* with the domain that matches your directory. 
-
-3. Select **Active Directory Users and Computers** > *directory-domain* > **Users**.
-4. Select **Action** > **New** > **User**.
-5. In New Object - User, provide user details. Select **Next**.
-6. Provide and confirm a password.
-7. Select **Next** to complete the values. Select **Finish** to create the user.
+   > Replace **directory-domain** with the domain that matches your directory. 
 
+1. Select **Active Directory Users and Computers > directory-domain > Users**.
+1. Select **Action > New > User**.
+1. In **New Object - User**, provide user details. Select **Next**.
+1. Provide and confirm a password.
+1. Select **Next** to complete the values. Select **Finish** to create the user.
 
 ## Next steps
 
-[Create an app identity to access Azure Stack Hub resources](./give-app-access-to-resources.md)
+[Create an app identity to access Azure Stack Hub resources](give-app-access-to-resources.md)
diff --git a/azure-stack/operator/azure-stack-add-vm-image.md b/azure-stack/operator/azure-stack-add-vm-image.md
@@ -1,9 +1,9 @@
 ---
 title: Add a custom VM image to Azure Stack Hub 
-description: Learn how to add or remove a custom VM image to Azure Stack Hub.
+description: Learn how to add or remove a custom VM image to or from Azure Stack Hub.
 author: sethmanheim
 ms.topic: how-to
-ms.date: 07/21/2021
+ms.date: 08/15/2024
 ms.author: sethm
 ms.reviewer: unknown
 ms.lastreviewed: 9/8/2020
@@ -18,19 +18,19 @@ ms.lastreviewed: 9/8/2020
 In Azure Stack Hub, as an operator you can add your custom virtual machine (VM) image to the marketplace and make it available to your users. You can add VM images to the Azure Stack Hub Marketplace through the administrator portal or Windows PowerShell. Use either an image from global Microsoft Azure Marketplace as a base for your custom image, or create your own using Hyper-V.
 
 > [!NOTE]
-   > Blob access is required to allow the read access.
+> Blob access is required to allow the read access.
 
 ## Add an image
 
-You can find instructions for adding generalized and specialized images in the **Compute** section of the user guide. You will want to create a generalized image before offering the image to your users. For instructions, see [Move a VM to Azure Stack Hub Overview](../user/vm-move-overview.md). When creating images available for your tenants, use the Azure Stack Hub administrative portal or administrator endpoints rather than the user portal or tenant directory endpoints.
+You can find instructions for adding generalized and specialized images in the **Compute** section of the user guide. You must create a generalized image before offering the image to your users. For instructions, see [Move a VM to Azure Stack Hub overview](../user/vm-move-overview.md). When you create images and make them available for your tenants, use the Azure Stack Hub administrator portal or administrator endpoints, rather than the user portal or tenant directory endpoints.
 
 You have two options for making an image available to your users:
 
 - **Offer an image only accessible via Azure Resource Manager**  
-  If you add the image via the Azure Stack Hub administrative portal in **Compute** > **Images**, all of your tenants can access the image. However your users will need to use an Azure Resource Manager template to access it. It won't be visible in your Azure Stack Hub Marketplace.
+  If you add the image via the Azure Stack Hub administrator portal in **Compute > Images**, all of your tenants can access the image. However, your users need to use an Azure Resource Manager template to access it. It won't be visible in your Azure Stack Hub Marketplace.
 
 - **Offer an image through the Azure Stack Hub Marketplace**  
-    Once you have added your image through the Azure Stack Hub administrative portal, you can then create a marketplace offering. For instructions, see [Create and publish a custom Azure Stack Hub Marketplace item](azure-stack-create-and-publish-marketplace-item.md).
+  Once you add your image through the Azure Stack Hub administrator portal, you can then create a marketplace offering. For instructions, see [Create and publish a custom Azure Stack Hub Marketplace item](azure-stack-create-and-publish-marketplace-item.md).
 
 ## Add a platform image
 
@@ -42,31 +42,31 @@ Add a VM image as an Azure Stack Hub operator using the portal.
 
 1. Sign in to Azure Stack Hub as an operator. Select **Dashboard** from the left-hand navigation.
 
-2. In the **Resource providers** list, select **Compute**.
+1. In the **Resource providers** list, select **Compute**.
 
    [![Select Compute](./media/azure-stack-add-vm-image/dash-small.png)](./media/azure-stack-add-vm-image/dash.png#lightbox)
 
-3. Select **VM images**, then select **Add**.
+1. Select **VM images**, then select **Add**.
 
    [![Add a VM image](./media/azure-stack-add-vm-image/tca4-small.png)](./media/azure-stack-add-vm-image/tca4.png#lightbox)
 
-4. Under **Create image**, enter the **Publisher**, **Offer**, **SKU**, **Version**, and OS disk blob URI. Then, select **Create** to begin creating the VM image.
+1. Under **Create image**, enter the **Publisher**, **Offer**, **SKU**, **Version**, and OS disk blob URI. Then, select **Create** to begin creating the VM image.
 
    [![Custom image sideloading UI](./media/azure-stack-add-vm-image/tca5-small.png)](./media/azure-stack-add-vm-image/tca5.png#lightbox)
 
    When the image is successfully created, the VM image status changes to **Succeeded**.
 
-5. When you add an image, it is only available for Azure Resource Manager-based templates and PowerShell deployments. To make an image available to your users as a marketplace item, publish the marketplace item using the steps in the article [Create and publish a Marketplace item](azure-stack-create-and-publish-marketplace-item.md). Make sure you note the **Publisher**, **Offer**, **SKU**, and **Version** values. You will need them when you edit the Resource Manager template and Manifest.json in your custom .azpkg.
+1. When you add an image, it's only available for Azure Resource Manager-based templates and PowerShell deployments. To make an image available to your users as a marketplace item, publish the marketplace item using the steps in the article [Create and publish a Marketplace item](azure-stack-create-and-publish-marketplace-item.md). Make sure you note the **Publisher**, **Offer**, **SKU**, and **Version** values. You need them when you edit the Resource Manager template and Manifest.json in your custom .azpkg.
 
 ### [PowerShell](#tab/image-add-ps)
 
- Add a VM image as an Azure Stack Hub operator using PowerShell.
+ Add a VM image as an Azure Stack Hub operator using PowerShell:
 
 1. [Install PowerShell for Azure Stack Hub](azure-stack-powershell-install.md).  
 
-2. [Sign in to Azure Stack Hub as an operator](azure-stack-powershell-configure-admin.md).
+1. [Sign in to Azure Stack Hub as an operator](azure-stack-powershell-configure-admin.md).
 
-3. Open PowerShell with an elevated prompt, and run:
+1. Open PowerShell in an elevated prompt, and run:
 
    ```powershell
     Add-AzsPlatformimage -publisher "<publisher>" `
@@ -77,7 +77,7 @@ Add a VM image as an Azure Stack Hub operator using the portal.
       -OSUri "<OS URI>"
    ```
 
-   The **Add-AzsPlatformimage** cmdlet specifies values used by the Azure Resource Manager templates to reference the VM image. The values include:
+   The **Add-AzsPlatformimage** cmdlet specifies values used by the Azure Resource Manager templates to reference the VM image. These values include:
    - **publisher**  
      For example: `Canonical`  
      The **publisher** name segment of the VM image that users use when they deploy the image. Don't include a space or other special characters in this field.  
@@ -99,7 +99,7 @@ Add a VM image as an Azure Stack Hub operator using the portal.
 
      For more information, see the PowerShell reference for the [Add-AzsPlatformimage](/powershell/module/azs.compute.admin/add-azsplatformimage) cmdlet.
 
-4. When you add an image, it is only available for Azure Resource Manager-based templates and PowerShell deployments. To make an image available to your users as a marketplace item, publish the marketplace item using the steps in the article [Create and publish a Marketplace item](azure-stack-create-and-publish-marketplace-item.md). Make sure you note the **Publisher**, **Offer**, **SKU**, and **Version** values. You will need them when you edit the Resource Manager template and Manifest.json in your custom .azpkg.
+1. When you add an image, it's only available for Azure Resource Manager-based templates and PowerShell deployments. To make an image available to your users as a marketplace item, publish the marketplace item using the steps in the article [Create and publish a Marketplace item](azure-stack-create-and-publish-marketplace-item.md). Make sure you note the **Publisher**, **Offer**, **SKU**, and **Version** values. You need them when you edit the Resource Manager template and Manifest.json in your custom .azpkg.
 
 ---
 
@@ -112,22 +112,17 @@ You can remove a platform image using the portal or PowerShell.
 To remove the VM image as an Azure Stack Hub operator using the Azure Stack Hub portal, follow these steps:
 
 1. Open the Azure Stack Hub [administrator portal](https://portal.azure.com/signin/index).
-
-2. If the VM image has an associated Marketplace item, select **Marketplace management**, and then select the VM marketplace item you want to delete.
-
-3. If the VM image does not have an associated Marketplace item, navigate to **All services > Compute > VM Images**, and then select the ellipsis (**...**) next to the VM image.
-
-4. Select **Delete**.
+1. If the VM image has an associated Marketplace item, select **Marketplace management**, and then select the VM marketplace item you want to delete.
+1. If the VM image doesn't have an associated Marketplace item, navigate to **All services > Compute > VM Images**, and then select the ellipsis (**...**) next to the VM image.
+1. Select **Delete**.
 
 ### [PowerShell](#tab/image-rem-ps)
 
 To remove the VM image as an Azure Stack Hub operator using PowerShell, follow these steps:
 
 1. [Install PowerShell for Azure Stack Hub](azure-stack-powershell-install.md).
-
-2. [Sign in to Azure Stack Hub as an operator](azure-stack-powershell-configure-admin.md).
-
-3. Open PowerShell with an elevated prompt, and run:
+1. [Sign in to Azure Stack Hub as an operator](azure-stack-powershell-configure-admin.md).
+1. Open PowerShell in an elevated prompt, and run:
 
    ```powershell  
    Remove-AzsPlatformImage `
@@ -151,7 +146,7 @@ To remove the VM image as an Azure Stack Hub operator using PowerShell, follow t
      For example: `1.0.0`  
      The version of the VM image that users use when they deploy the VM image. This version is in the format **\#.\#.\#**. Don't include a space or other special characters in this field.  
 
-     For more info about the **Remove-AzsPlatformImage** cmdlet, see the Microsoft PowerShell [Azure Stack Hub Operator module documentation](/powershell/azurestackhub/overview).
+     For more information about the **Remove-AzsPlatformImage** cmdlet, see the Microsoft PowerShell [Azure Stack Hub Operator module documentation](/powershell/azurestackhub/overview).
 
 ---
 
