Skip to content

Commit 2648728

Browse files
authored
Merge pull request #6207 from evanwindom/admintasks2
Admintasks2: Update several admin-related articles for new screenshots, etc, to reflect the new UI/UX.
2 parents f58c9b0 + 496aa58 commit 2648728

18 files changed

+112
-35
lines changed
Loading
Loading
Loading
Loading
Loading
Loading
Loading
-82.5 KB
Loading
Loading
Loading
Loading

subscriptions/handle-overclaimed-license.md

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,20 +3,24 @@ title: Handle overallocated licenses | Microsoft Docs
33
author: evanwindom
44
ms.author: lank
55
manager: lank
6-
ms.date: 07/24/2019
6+
ms.date: 03/03/2020
77
ms.topic: conceptual
88
description: Learn how administrators can resolve overallocated subscriptions
99
---
1010

1111
# Overallocated subscriptions
12-
Sometimes orders are changed after subscribers have been added, which can result in having more assigned subscriptions than licenses owned by your company. This is called "overallocation". When this happens, the Subscribers tab shows an alert and provides you with further information about how many subscriptions have been overallocated.
12+
Sometimes orders are changed after subscribers have been added, which can result in having more assigned subscriptions than licenses owned by your company. This is called "overallocation".
13+
14+
To see your subscripton allocations, click on the top icon at the left to open the allocations pane.
1315

1416
> [!NOTE]
1517
> Overallocations are not allowed in Open License programs. Also, other programs may display this information in the portal differently.
1618
>
1719
> [!div class="mx-imgBorder"]
1820
> ![Notice of Over-claimed Subscriptions](_img/over-claimed/over-claimed-alert.png)
1921
22+
Notice that the display uses a hashed bar to indicate overallocated subscriptions. The number of overallocations across all subscription types is included in the Overview section at the top, and each subscription level also displays its own allocation status.
23+
2024
## Resolve overallocated subscriptions
2125
There are several ways to resolve overallocations:
2226
- Contact your reseller to purchase additional subscriptions.
@@ -31,6 +35,12 @@ If your organization has an Enterprise Agreement (EA), admins are able to assign
3135
>
3236
> It is the customer’s responsibility to ensure that for each GitHub subscription that is assigned there is a corresponding Visual Studio with GitHub subscription assigned in the Manage portal to remain in compliance with the licensing requirements for this subscription.
3337
38+
## See also
39+
- [Visual Studio documentation](https://docs.microsoft.com/visualstudio/)
40+
- [Azure DevOps documentation](https://docs.microsoft.com/azure/devops/)
41+
- [Azure documentation](https://docs.microsoft.com/azure/)
42+
- [Microsoft 365 documentation](https://docs.microsoft.com/microsoft-365/)
43+
3444
## Next steps
3545
- Learn more about managing [Visual Studio Subscriptions with GitHub Enterprise](assign-github.md).
36-
- For assistance with sales, subscriptions, accounts and billing for Visual Studio Subscriptions, contact Visual Studio [Subscriptions Support](https://visualstudio.microsoft.com/subscriptions/support/).
46+
- For assistance with sales, subscriptions, accounts and billing for Visual Studio Subscriptions, contact Visual Studio [Subscriptions Support](https://visualstudio.microsoft.com/subscriptions/support/).

subscriptions/maximum-usage.md

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -3,43 +3,45 @@ title: Use the Maximum Usage feature in the Administration Portal
33
author: evanwindom
44
ms.author: lank
55
manager: lank
6-
ms.date: 03/24/2019
6+
ms.date: 03/03/2020
77
ms.topic: conceptual
88
description: Learn how to view the maximum number of assigned subscriptions in the admin portal
99
---
10-
# Use the Maximum Usage feature to track the number of assigned subscriptions
10+
# Use the maximum usage feature to track the number of assigned subscriptions
1111
A new feature in the Visual Studio subscriptions administration portal helps you track how many subscriptions you've purchased and assigned, and identifies the peak number of subscriptions of each level you've assigned, both within the past year and throughout the duration of your agreement(s).
1212

1313
## View your maximum usage
1414
To see the peak number of subscriptions assigned for any agreement and subscription level:
1515
1. Select the agreement you wish to view in the drop-down at the top left of the portal. (If you only have one agreement, it will already be selected.)
16-
2. Click on the **Maximum Usage** tab.
16+
2. Click on the **maximum usage** icon which is the third icon from the top on the left side of the subscriber grid.
1717
> [!div class="mx-imgBorder"]
1818
> ![Maximum Usage Menu](_img/maximum-usage/maximum-usage-menu.png)
19-
3. The "Maximum Usage Summary" will appear, and the maximum number of subscriptions you've assigned within the past year for each level will be displayed, along with the date on which you reached that peak. If you reached that peak more than once, the first time you reached it will be displayed.
20-
> [!div class="mx-imgBorder"]
21-
> ![Maximum Usage Summary](_img/maximum-usage/maximum-usage-summary.png)
22-
4. To see the maximum number of subscriptions assigned for the life of the agreement, click the **Full-Term** tab.
19+
3. The "12-month maximum usage" will appear, and the maximum number of subscriptions you've assigned within the past year for each level will be displayed, along with the month in which you reached that peak.
2320

2421
## View your assignment history
25-
In addition to seeing the peak assignments for each subscription level, you can see a running account of the activity on the agreement, including purchases and assignments, by clicking the **Export full report** button.
22+
In addition to seeing the peak assignments for each subscription level, you can see a running account of the activity on the agreement, including purchases and assignments, by clicking the **Export full report** button. (You may need to scroll down to see the button.)
2623

2724
> [!div class="mx-imgBorder"]
2825
> ![Maximum Usage Full Report](_img/maximum-usage/maximum-usage-full-report.png)
2926
3027
For each subscription level, the report shows the date you reached a new maximum assignment level and the number of subscriptions you had purchased as of that date, allowing you to easily see any dates where you had overallocations.
3128

32-
For example, in the table above, you can see that on 12/13/2018 there were 123 Visual Studio Enterprise subscriptions in the agreement, and 120 were assigned. On 1/8/2019, one more subscription was assigned, bringing the total to 121. The next day, another six subscriptions were assigned, and another four subscriptions were added to the agreement to cover the new assignments.
33-
3429
## Frequently asked questions
35-
### Q: How is the information in the Maximum Usage different from the assignment information available in the "Overview" section on the left side of the portal?
36-
A: The information in the overview shows the *current* assignments and available subscriptions for each subscription level. This may be very different from the maximum number of subscriptions assigned for the agreement during the current year or the life of the agreement. The Maximum Usage feature allows you to see when the maximum assignment levels were reached and what the levels were. This is an important distinction, since billing for subscriptions during true-up is based on the maximum number of subscriptions assigned at any point throughout the year.
30+
### Q: How is the information in the maximum usage different from the assignment information available in the "Overview" section on the left side of the portal?
31+
A: The information in the overview shows the *current* assignments and available subscriptions for each subscription level. This may be very different from the maximum number of subscriptions assigned for the agreement during the current year or the life of the agreement. The maximum usage feature allows you to see when the maximum assignment levels were reached and what the levels were. This is an important distinction, since billing for subscriptions during true-up is based on the maximum number of subscriptions assigned at any point throughout the year.
3732

3833
## Resources
3934
- [Visual Studio licensing white paper](https://visualstudio.microsoft.com/wp-content/uploads/2019/06/Visual-Studio-Licensing-Whitepaper-May-2019.pdf)
4035
- [Visual Studio Administration and Subscriptions Support](https://visualstudio.microsoft.com/support/support-overview-vs)
4136
- [Volume Licensing terms](https://www.microsoft.com/licensing/product-licensing/products.aspx)
4237

38+
## See also
39+
- [Visual Studio documentation](https://docs.microsoft.com/visualstudio/)
40+
- [Azure DevOps documentation](https://docs.microsoft.com/azure/devops/)
41+
- [Azure documentation](https://docs.microsoft.com/azure/)
42+
- [Microsoft 365 documentation](https://docs.microsoft.com/microsoft-365/)
43+
4344
## Next steps
4445
- If you have any questions about subscription assignments or other aspects of the administration portal, please contact https://visualstudio.microsoft.com/subscriptions/support/ for assistance.
4546
- Learn more about what to do if you assign more subscriptions that you purchased, referred to as [overallocations](handle-overclaimed-license.md).
47+

subscriptions/mpsa.md

Lines changed: 23 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Visual Studio subscriptions in a Microsoft Products and Services Agreemen
33
author: evanwindom
44
ms.author: lank
55
manager: lank
6-
ms.date: 07/23/2019
6+
ms.date: 03/03/2020
77
ms.topic: conceptual
88
description: Visual Studio subscriptions in a Microsoft Products and Services Agreement (MPSA)
99
---
@@ -38,15 +38,34 @@ Once you have met the criteria above you may proceed to associate your Purchasin
3838
4. Select your **tenant** (i.e. contoso.onmicrosoft.com).
3939
5. Click **Associate Domain**.
4040

41-
Upon association, all users meeting the criteria will typically provision as Visual Studio subscriptions administrators within minutes. However, at times it may take up to 24 hours. Once your tenant is provisioned you will be able to access the Visual Studio Subscriptions Administration Portal. If this takes longer than 24 hours, please contact MPSA Support.
41+
Upon association, all users meeting the criteria will typically provision as Visual Studio subscriptions administrators within minutes. However, at times it may take up to 24 hours. Once your tenant is provisioned you will be able to access the Visual Studio Subscriptions Administration Portal. If this takes longer than 24 hours, please contact MPSA Support using these steps:
42+
1. Connect to https://www.microsoft.com/licensing/mpsa/default
43+
2. Click the **More** menu at the top of the page.
44+
3. Choose **Support**
45+
4. Choose **Licensing support**
46+
5. Select the support option that best fits your needs.
4247

4348
> [!NOTE]
4449
> If there are new users that meet the criteria in steps 2 and 5 (after association) you must contact MPSA Support. MPSA Support will provide assistance to provision the new Visual Studio Subscriptions administrators.
4550
4651
## Tenant association (unmanaged)
4752
If you registered to the Business Center with an email that was not a work account (not registered in the Azure Active Directory “Azure AD”), as explained above, the tenant association will be slightly different. You will need to perform what’s called a "domain take-over". During this process you will make yourself the Global Admin which will change your tenant from unmanaged to managed.
4853

49-
For a more detailed explanation for this process, you may use the [Quick Start guides](https://www.microsoft.com/en-us/Licensing/existing-customer/business-center-training-and-resources.aspx). Please download the guide named *"Setup and Use Your Online Services"* which will guide you through a domain take-over. Once this is completed your Purchasing Account will also be associated to your tenant.
54+
For a more detailed explanation for this process, you may use the [Quick Start guides](https://www.microsoft.com/Licensing/existing-customer/business-center-training-and-resources.aspx). Please download the guide named *"Setup and Use Your Online Services"* which will guide you through a domain take-over. Once this is completed your Purchasing Account will also be associated to your tenant.
5055

5156
> [!NOTE]
52-
> Once you complete the domain take-over process, you must adhere to the criteria from the five steps in the section for Pre Tenant Association (Managed). Once the criteria are met, it will only be necessary to contact MPSA Support to provision additional Visual Studio subscriptions administrators.
57+
> Once you complete the domain take-over process, you must adhere to the criteria from the five steps in the section for Pre Tenant Association (Managed). Once the criteria are met, it will only be necessary to contact MPSA Support to provision additional Visual Studio subscriptions administrators.
58+
59+
## See also
60+
- [Visual Studio documentation](https://docs.microsoft.com/visualstudio/)
61+
- [Azure DevOps documentation](https://docs.microsoft.com/azure/devops/)
62+
- [Azure documentation](https://docs.microsoft.com/azure/)
63+
- [Microsoft 365 documentation](https://docs.microsoft.com/microsoft-365/)
64+
65+
## Next steps
66+
Learn more about managing Visual Studio subscriptions.
67+
- [Assign individual subscriptions](assign-license.md)
68+
- [Assign multiple subscriptions](assign-license-bulk.md)
69+
- [Edit subscriptions](edit-license.md)
70+
- [Delete subscriptions](delete-license.md)
71+
- [Determine maximum usage](maximum-usage.md)

subscriptions/personal-email-sign-ins.md

Lines changed: 24 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Personal emails displayed in VLSC
33
author: evanwindom
44
ms.author: lank
55
manager: lank
6-
ms.date: 07/24/2019
6+
ms.date: 03/03/2020
77
ms.topic: conceptual
88
description: Visual Studio Subscriptions – Why Am I Seeing Hotmail or Gmail Addresses for My Subscribers?
99
---
@@ -22,12 +22,31 @@ A Microsoft Account (MSA) was required to sign-in. If the subscriber didn’t at
2222
> [!NOTE]
2323
> The new subscriber experience on [https://my.visualstudio.com](https://my.visualstudio.com?wt.mc_id=o~msft~docs) supports both Work/School and Microsoft Account (MAA) identity types.
2424
25-
Finally, since the administrator migration was taking data from VLSC regarding the subscriber’s “Sign-In Email Address” to populate the new subscriber management experience, recently migrated admins may have seen these previously unnoticed personal accounts due to changes to the user interface which made this information more visible.
26-
2725
## Solution
28-
To correct the problem, you'll need to edit subscriber information to update their sign-in email addresses. Edits can be made for individual subscribers, or in bulk. For complete information, please visit [Edit subscriptions](edit-license.md).
26+
To correct the problem, simply select the **Connect Emails** button and the system will attempt to match the accounts with MSAs to existing users in your organization’s Azure Active Directory (Azure AD) based on matching the first and last name. If there is an error, you can remove any match by clicking on the **X** to the right of the match.
27+
28+
> [!div class="mx-imgBorder"]
29+
> ![Connect Emails Button](_img/connect-emails/connect-emails-button.png)
30+
31+
You can also use the **Search Directory** to correct the errors or fill in missing information from your Azure AD. If the all the matches look correct, you can choose to “Select all matching subscribers”, rather than selecting them one at a time.
32+
33+
> [!div class="mx-imgBorder"]
34+
> ![Connect Emails Fly-out](_img/connect-emails/connect-emails-flyout.png)
35+
36+
Next click on “continue” which will take you to a screen outlining the changes to take place. If you agree, click “save” and the changes will be made. Your subscriber will also get a message informing them of the change the next time they sign in to their subscription.
37+
38+
> [!div class="mx-imgBorder"]
39+
> ![Connect Emails Confirmation](_img/connect-emails/connect-emails-confirm.png)
40+
41+
> [!NOTE]
42+
> When you edit the sign in email address is that this only updates the email used to sign in to their subscription on https://my.visualstudio.com. If the subscriber has already activated benefits such as Azure or Pluralsight using the other email address, they will need to continue to use those email addresses to access them. For any new benefits that they access, they should use the new email address.
43+
44+
## See also
45+
- [Visual Studio documentation](https://docs.microsoft.com/visualstudio/)
46+
- [Azure DevOps documentation](https://docs.microsoft.com/azure/devops/)
47+
- [Azure documentation](https://docs.microsoft.com/azure/)
48+
- [Microsoft 365 documentation](https://docs.microsoft.com/microsoft-365/)
2949

3050
## Next steps
3151
- If you have updated the subscriber(s) email address(es), you may want to notify them that their sign-in information has changed. They will also receive an email with the updated information.
3252
- It may be useful to [filter the list of subscribers](search-license.md) in your organization to look for any sign in email addresses that may need to be changed.
33-

subscriptions/search-license.md

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Search and filter | Microsoft Docs
33
author: evanwindom
44
ms.author: lank
55
manager: lank
6-
ms.date: 07/24/2019
6+
ms.date: 03/03/2020
77
ms.topic: conceptual
88
description: Learn how administrators can locate individual subscribers or groups in the Administration Portal.
99
---
@@ -14,7 +14,7 @@ The Visual Studio Subscriptions Administration Portal allows you to find a speci
1414
## To filter the subscriber list
1515
1. To search for a specific group of subscribers, select the **Filter** tab.
1616
> [!div class="mx-imgBorder"]
17-
> ![Select Filter to search a subscriber list](media/filter-list.png)
17+
> ![Select Filter to search a subscriber list](_img/search-filter/filter-list.png)
1818
1919
2. Enter the criteria you would like to use as the basis of your search, and then select **Filter** again.
2020
> [!div class="mx-imgBorder"]
@@ -24,10 +24,22 @@ The Visual Studio Subscriptions Administration Portal allows you to find a speci
2424
> [!NOTE]
2525
> The **Name** field is sorted by first name.
2626
27+
Notice that the **Filter** icon is highlighted, indicating that a filter is applied. A **Clear filter** choice is also displayed.
28+
2729
3. To clear the filter and restore the unfiltered list, click the **Clear filter** tab at the top right.
2830
> [!div class="mx-imgBorder"]
29-
> ![Clear the filter from the subscriber list](media/clear-filter.png)
31+
> ![Clear the filter from the subscriber list](_img/search-filter/clear-filter.png)
32+
33+
34+
## See also
35+
- [Visual Studio documentation](https://docs.microsoft.com/visualstudio/)
36+
- [Azure DevOps documentation](https://docs.microsoft.com/azure/devops/)
37+
- [Azure documentation](https://docs.microsoft.com/azure/)
38+
- [Microsoft 365 documentation](https://docs.microsoft.com/microsoft-365/)
39+
3040

3141
## Next steps
3242
- Now that you know how to find a subscriber, learn how to [edit](edit-license.md) their subscription.
33-
- Need help using the Administration Portal? Contact [Visual Studio Administration and Subscriptions Support](https://visualstudio.microsoft.com/support/support-overview-vs).
43+
- Need help using the Administration Portal? Contact [Visual Studio Administration and Subscriptions Support](https://visualstudio.microsoft.com/support/support-overview-vs).
44+
45+

0 commit comments

Comments
 (0)