Merge pull request #15669 from sethmanheim/hubfresh8-12

Hub freshness review 8/15

Author: sethmanheim

azure-stack/operator/azure-stack-add-manage-billing-as-a-csp.md

@@ -3,7 +3,7 @@ title: Manage Azure Stack Hub usage and billing as a Cloud Solution Provider
 description: Learn how to register Azure Stack Hub as a Cloud Solution Provider (CSP) and add customers for billing.
 author: sethmanheim
 ms.topic: article
-ms.date: 05/07/2024
+ms.date: 08/15/2024
 ms.author: sethm
 ms.reviewer: rtiberiu
 ms.lastreviewed: 10/15/2019
@@ -18,20 +18,22 @@ ms.lastreviewed: 10/15/2019
 
 This article describes how to register Azure Stack Hub as a Cloud Solution Provider (CSP) and how to add customers.
 
-As a CSP, you work with diverse customers using your Azure Stack Hub. Each customer has a CSP subscription in Azure. You must direct usage from your Azure Stack Hub to each user subscription.
+As a CSP, you work with diverse customers that use your Azure Stack Hub deployment. Each customer has a CSP subscription in Azure, and you must direct usage from your Azure Stack Hub instance to each user subscription.
 
 The following figure shows the required steps to choose your shared services account, and to register the Azure account with the Azure Stack Hub account. Once registered, you can onboard your end customers:
 
 [![Process for enabling usage and management as a Cloud Solution Provider](media/azure-stack-add-manage-billing-as-a-csp/process-add-useage-as-a-csp.svg "Process for enabling usage and management as a Cloud Solution Provider")](media/azure-stack-add-manage-billing-as-a-csp/process-add-useage-as-a-csp.svg)
 
 ## Create a CSP or APSS subscription
 
+This section describes how to create shared services subscriptions.
+
 ### CSP subscription types
 
 Choose the type of shared services account that you use for Azure Stack Hub. The types of subscriptions that can be used for registration of a multitenant Azure Stack Hub are:
 
-- Cloud Solution Provider
-- Azure Partner Shared Services subscription
+- Cloud Solution Provider (CSP)
+- Azure Partner Shared Services (APSS)
 
 See this tutorial video to help you understand how to manage your multitenant rights:
 
@@ -49,11 +51,11 @@ For a description of APSS subscriptions and how to create them, see [Add Azure P
 
 CSP subscriptions are the preferred choice for registration when a CSP reseller or an end customer operates Azure Stack Hub.
 
-Services such as [Azure Site Recovery](azure-site-recovery-overview.md#how-is-site-recovery-billed) only report usage data in the subscription associated with the Azure Stack Hub registration. The CSP that operates the multitenant environment typically managed this subscription. As a result, it's the responsibility of the CSP to accurately determine and bill each of their customers who utilize the Azure Site Recovery service.
+Services such as [Azure Site Recovery](azure-site-recovery-overview.md#how-is-site-recovery-billed) only report usage data in the subscription associated with the Azure Stack Hub registration. The CSP that operates the multitenant environment typically managed this subscription. As a result, it's the responsibility of the CSP to accurately determine and bill each of their customers who use the Azure Site Recovery service.
 
 ## Register Azure Stack Hub
 
-Use the APSS subscription created using the information in the preceding section to register Azure Stack Hub with Azure. For more information, see [Register Azure Stack Hub with your Azure subscription](azure-stack-registration.md).
+Use the APSS subscription you created using the information in the preceding section to register Azure Stack Hub with Azure. For more information, see [Register Azure Stack Hub with your Azure subscription](azure-stack-registration.md).
 
 ## Add end customer
 
@@ -68,7 +70,7 @@ Using registration, Azure Stack Hub can:
 - Forward [Azure Stack Hub usage data](azure-stack-billing-and-chargeback.md) to Azure Commerce and bill an Azure subscription.
 - Report each customer's usage on a different subscription with a multitenant Azure Stack Hub deployment. Multitenancy enables Azure Stack Hub to support different organizations on the same Azure Stack Hub instance.
 
-For each Azure Stack Hub, there is one default subscription and many tenant subscriptions. The default subscription is an Azure subscription that is charged if there's no tenant-specific subscription. It must be the first subscription to be registered. For multitenant usage reporting to work, the subscription must be a CSP or APSS subscription.
+For each Azure Stack Hub, there is one default subscription and many tenant subscriptions. The default subscription is an Azure subscription that's charged if there's no tenant-specific subscription. It must be the first subscription to be registered. For multitenant usage reporting to work, the subscription must be a CSP or APSS subscription.
 
 Then, the registration is updated with an Azure subscription for each tenant that uses Azure Stack Hub. Tenant subscriptions must be of the CSP type, and must roll up to the partner who owns the default subscription. You cannot register someone else's customers.
 

azure-stack/operator/azure-stack-add-new-user-aad.md

@@ -5,7 +5,7 @@ author: sethmanheim
 ms.topic: article
 ms.custom:
   - has-azure-ad-ps-ref
-ms.date: 03/19/2024
+ms.date: 08/15/2024
 ms.author: sethm
 ms.reviewer: thoroet
 ms.lastreviewed: 06/17/2021
@@ -23,27 +23,26 @@ Before you can test offers and plans and create resources, you'll need a user ac
 You must have an Azure subscription to use the Azure portal.
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
-2. Using the **Directory + Subscription** filter icon in the upper right, switch to the Microsoft Entra directory tenant you're using for Azure Stack Hub.
-3. Using the search bar at the top, search for and select the **Microsoft Entra ID** service. 
-4. In the left pane, select **Users**.
-5. On the **Users** page, select **+ New user**.
+1. Using the **Directory + Subscription** filter icon in the upper right, switch to the Microsoft Entra directory tenant you're using for Azure Stack Hub.
+1. Using the search bar at the top, search for and select the **Microsoft Entra ID** service.
+1. In the left pane, select **Users**.
+1. On the **Users** page, select **+ New user**.
 
     [![Users - Lists all existing user accounts](media/azure-stack-add-new-user-aad/new-user-all-users.png)](media/azure-stack-add-new-user-aad/new-user-all-users.png#lightbox)
 
-6. On the **New user** page, select **Create user** then fill in the required info:
+1. On the **New user** page, select **Create user** then fill in the required info:
 
     [![Users - Add a new user account](media/azure-stack-add-new-user-aad/new-user-user.png)](media/azure-stack-add-new-user-aad/new-user-user.png#lightbox)
 
-   - **User name (required)**: The identifier used for sign in. For example, [email protected].
-       The domain part of the user name must use either the initial default domain name, <_yourdomainname_>.onmicrosoft.com, or a custom domain name, such as contoso.com. For more info on how to create a custom domain name, see [How to add a custom domain name to Microsoft Entra ID](/azure/active-directory/fundamentals/add-custom-domain).
-   - **Name (required)**: The first and last name of the new user. For example, Mary Parker.
+   - **User name (required)**: The identifier used for sign in. For example, `[email protected]`. The domain part of the user name must use either the initial default domain name, `<yourdomainname>`.`onmicrosoft.com`, or a custom domain name, such as `contoso.com`. For more information about how to create a custom domain name, see [How to add a custom domain name to Microsoft Entra ID](/azure/active-directory/fundamentals/add-custom-domain).
+   - **Name (required)**: The first and last name of the new user. For example, `Mary Parker`.
    - **Show Password**: Select the checkbox and copy the autogenerated password provided in **Initial password**. You'll need this password for the initial sign-in process.
    - **Groups and roles**: Make sure the **User** directory role is selected.
    - **Settings** and **Job info**: Optionally, you can add more info about the user. You can also add user info later. For more details, see [How to add or change user profile information](/azure/active-directory/fundamentals/active-directory-users-profile-azure-portal).
 
-7. Select **Create**. You should see a "Successfully created user" notification in the upper right.
-8. Sign out and sign in to the Azure portal again, with the new account using the password you saved. Change the password when prompted.
-9. [Sign in to the Azure Stack Hub user portal](../user/azure-stack-use-portal.md#access-the-portal) with the new account to see the user portal.
+1. Select **Create**. You should see a "Successfully created user" notification in the upper right.
+1. Sign out and sign in to the Azure portal again, with the new account using the password you saved. Change the password when prompted.
+1. [Sign in to the Azure Stack Hub user portal](../user/azure-stack-use-portal.md#access-the-portal) with the new account to see the user portal.
 
 ## Create a user account using PowerShell
 
@@ -53,37 +52,41 @@ If you don't have an Azure subscription, you can't use the Azure portal to add a
 
 1. Install the Microsoft Azure AD module for Windows PowerShell with these steps:
 
-    - Open an elevated Windows PowerShell command prompt (run Windows PowerShell as admin).
-    - Run the **Install-Module AzureAD** command.
-    - If you're prompted to install the NuGet provider, select **Y** and **Enter**.
-    - If you're prompted to install the module from PSGallery, select **Y** and **Enter**.
-
-2. Run the following cmdlets to sign in and create the user account:
-
-    - If your directory **doesn't require** multi-factor authentication, use this sequence to authenticate:
-        ```powershell
-        # Wait for the prompt, then sign in using your Azure AD credentials
-        $aadcred = get-credential
-        Connect-AzureAD -credential $aadcred
-        ```
-
-    - If your directory **requires** multi-factor authentication, use this sequence to authenticate:
-        ```powershell
-        # Wait for the prompt, then sign in using your Azure AD credentials and MFA code
-        Connect-AzureAD -Confirm
-        ```
-
-    - Now that you've authenticated, complete the sequence by adding the new user:
-        ```powershell
-        # Create the new user account (be sure to replace all <placeholder> values first)
-        $passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
-        $passwordProfile.Password = "<Password>"
-        New-AzureADUser -DisplayName "<UserName>" -PasswordProfile $passwordProfile -UserPrincipalName "<username>@<yourdomainname>" -AccountEnabled $true -MailNickName "<MailNickName>"
-        ```
-
-3. Sign in to the [Azure portal](https://portal.azure.com) with the new user account. Change the password when prompted.
-4. [Sign in to the Azure Stack Hub user portal](../user/azure-stack-use-portal.md#access-the-portal) with the new account to see the user portal.
+   - Open an elevated Windows PowerShell command prompt (run Windows PowerShell as admin).
+   - Run the **Install-Module AzureAD** command.
+   - If you're prompted to install the NuGet provider, select **Y** and **Enter**.
+   - If you're prompted to install the module from PSGallery, select **Y** and **Enter**.
+
+1. Run the following cmdlets to sign in and create the user account:
+
+   - If your directory **doesn't require** multi-factor authentication, use this sequence to authenticate:
+
+   ```powershell
+   # Wait for the prompt, then sign in using your Azure AD credentials
+   $aadcred = get-credential
+   Connect-AzureAD -credential $aadcred
+   ```
+
+   - If your directory **requires** multi-factor authentication, use this sequence to authenticate:
+
+   ```powershell
+   # Wait for the prompt, then sign in using your Azure AD credentials and MFA code
+   Connect-AzureAD -Confirm
+   ```
+
+   - Now that you've authenticated, complete the sequence by adding the new user:
+
+   ```powershell
+   # Create the new user account (be sure to replace all <placeholder> values first)
+   $passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
+   $passwordProfile.Password = "<Password>"
+   New-AzureADUser -DisplayName "<UserName>" -PasswordProfile $passwordProfile -UserPrincipalName "<username>@<yourdomainname>" -AccountEnabled $true -MailNickName "<MailNickName>"
+   ```
+
+1. Sign in to the [Azure portal](https://portal.azure.com) with the new user account. Change the password when prompted.
+1. [Sign in to the Azure Stack Hub user portal](../user/azure-stack-use-portal.md#access-the-portal) with the new account to see the user portal.
 
 ## Next steps
+
 - Learn how to create and test a subscription by [subscribing to an offer](../user/azure-stack-subscribe-services.md)
 - [Add Azure Stack Hub users in AD FS](azure-stack-add-users-adfs.md)