Skip to content

Commit 6157447

Browse files
authored
Merge pull request #6200 from evanwindom/admintasks
Admintasks: Update multiple admin-related articles to reflect the new UI/UX.
2 parents c98e0cc + 71f576f commit 6157447

13 files changed

+95
-46
lines changed
Loading
Loading
Loading
Loading
Loading
Loading

subscriptions/assign-github.md

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Visual Studio + GitHub Enterprise offer | Microsoft Docs
33
author: evanwindom
44
ms.author: lank
55
manager: lank
6-
ms.date: 07/28/2019
6+
ms.date: 03/03/2020
77
ms.topic: conceptual
88
description: Managing subscriptions in the Visual Studio + GitHub Enterprise offer
99
---
@@ -14,7 +14,7 @@ Customers who have Enterprise Agreements (EA) with Microsoft are eligible to pur
1414
When your organization purchases Visual Studio Subscriptions with GitHub Enterprise, they are provisioned and managed in two parts.
1515

1616
## Manage Visual Studio subscriptions
17-
When your organization purchases Visual Studio Subscriptions with GitHub Enterprise, the Visual Studio portion of the subscriptions is provisioned immediately and the subscriptions are available for assignment and management in the Visual Studio [Subscriptions Administration](https://manage.visualstudio.com) portal.
17+
When your organization purchases Visual Studio Subscriptions with GitHub Enterprise, the Visual Studio portion of the subscriptions is provisioned immediately, and the subscriptions are available for assignment and management in the Visual Studio [Subscriptions Administration](https://manage.visualstudio.com) portal.
1818

1919
For more information about managing subscriptions, check out these topics:
2020
- [Using the Admin Portal](using-admin-portal.md)
@@ -26,7 +26,7 @@ For more information about managing subscriptions, check out these topics:
2626
> [!Important]
2727
> If Visual Studio Subscriptions with GitHub Enterprise are assigned by Visual Studio subscription admins and there has never been a purchase of those subscriptions, they will not be visible to GitHub Enterprise admins within the organization. To ensure GitHub Enterprise subscriptions are visible, a purchase including **at least one** Visual Studio Professional with GitHub Enterprise or Visual Studio Enterprise with GitHub Enterprise subscription should be made the first time the subscriptions are assigned.
2828
>
29-
> 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.
29+
> 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 Visual Studio Subscriptions Administration portal to remain in compliance with the licensing requirements for this subscription.
3030
3131
## Manage GitHub Enterprise subscriptions
3232
When GitHub Enterprise subscriptions are purchased, GitHub partners with customers to help create and configure the organizations that will access GitHub and identify administrators. Those administrators then receive a notification that they've been set up as admins.
@@ -66,5 +66,20 @@ GitHub Help provides a variety of administrator guides to answer questions and g
6666
- Have a question about Visual Studio IDE, Azure DevOps Services or other Visual Studio products or services? Visit [Visual Studio Support](https://visualstudio.microsoft.com/support/).
6767
- Get [technical support](https://support.microsoft.com/en-us/supportforbusiness/productselection?sapId=b77fe80f-5417-80bd-4b2a-275cf0018c24) for GitHub Enterprise.
6868

69+
## See also
70+
- [Visual Studio documentation](https://docs.microsoft.com/visualstudio/)
71+
- [Azure DevOps documentation](https://docs.microsoft.com/azure/devops/)
72+
- [Azure documentation](https://docs.microsoft.com/azure/)
73+
- [Microsoft 365 documentation](https://docs.microsoft.com/microsoft-365/)
74+
6975
## Next steps
76+
Learn more about managing Visual Studio subscriptions.
77+
- [Assign individual subscriptions](assign-license.md)
78+
- [Assign multiple subscriptions](assign-license-bulk.md)
79+
- [Edit subscriptions](edit-license.md)
80+
- [Delete subscriptions](delete-license.md)
81+
- [Determine maximum usage](maximum-usage.md)
82+
7083
For more information about managing Visual Studio Subscriptions with GitHub Enterprise, check out the Visual Studio [subscriptions admin portal](https://visualstudio.microsoft.com/subscriptions-administration/).
84+
85+

subscriptions/assign-license-bulk.md

Lines changed: 7 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Assign licenses to groups of users for Visual Studio subscriptions | Micr
33
author: evanwindom
44
ms.author: lank
55
manager: lank
6-
ms.date: 02/26/2020
6+
ms.date: 03/02/2020
77
ms.topic: conceptual
88
description: Learn how administrators can assign licenses to multiple subscribers using either the Bulk add feature or Microsoft Azure Active Directory groups
99
---
@@ -13,7 +13,6 @@ The Subscriptions Administration Portal lets you add users one-at-a-time, or in
1313

1414
To add large groups of users, you can use the bulk add feature, or if your organization is using Microsoft Azure Active Directory (Azure AD), you can use Azure AD groups. This article will explain the process for both options.
1515

16-
1716
## Use Bulk add to assign subscriptions
1817
1. Sign into the Visual Studio Subscriptions Administration Portal at https://manage.visualstudio.com.
1918

@@ -54,19 +53,16 @@ To add large groups of users, you can use the bulk add feature, or if your organ
5453
> [!div class="mx-imgBorder"]
5554
> ![Confirmation message if the upload of multiple subscribers succeeds](media/bulk-add-template-success.png)
5655
57-
## Use Azure AD groups to assign subscriptions
58-
Using this feature makes it easy to stay on top of your subscription assignments. You can add Azure AD Security Groups in the Subscriptions Administration Portal which will ensure that all individuals in the group are assigned a subscription. And to make it easier, when individuals leave your organization and are removed from Azure AD, their access to subscriptions is also removed.
59-
60-
> [!NOTE]
61-
> This capability is being deployed in phases, so it may not be availability immediately for your organization.
56+
## Use Azure Active Directory groups to assign subscriptions
57+
Using this feature makes it easy to stay on top of your subscription assignments. You can add Azure Active Directory Security Groups in the Subscriptions Administration Portal which will ensure that all individuals in the group are assigned a subscription. And to make it easier, when individuals leave your organization and are removed from Azure Active Directory, their access to subscriptions is also removed.
6258

6359
> [!IMPORTANT]
6460
> The following limitations apply to the use of Azure AD groups for adding subscribers:
6561
> - Groups must contain at least one member. Empty groups are not supported.
66-
> - Groups must have less than 1,000 users.
67-
> - All users must be in the top level of the group. Nested groups are not supported.
68-
> - Only trusted agreements are supported.
69-
> - All members of the group must have an email address associated with their Azure AD account.
62+
> - Groups must have less than 1,000 users
63+
> - All users must be in the top level of the group. Nested groups are not supported
64+
> - Only trusted agreements are supported
65+
> - All members of the group must have an email address associated with their Azure AD account
7066
7167

7268
1. Sign in to the Visual Studio Subscriptions Administration Portal at [https://manage.visualstudio.com](https://manage.visualstudio.com).
@@ -113,5 +109,3 @@ A: Depending on how your organization has configured Azure AD, you may see delay
113109
- Have just one or two subscribers to add? Check out [Add single users](assign-license.md)
114110
- Need help? Contact [Visual Studio Administration and Subscriptions Support](https://visualstudio.microsoft.com/support/support-overview-vs).
115111

116-
117-

subscriptions/assign-license.md

Lines changed: 17 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,23 +3,27 @@ title: Assign licenses to Visual Studio subscriptions | Microsoft Docs
33
author: evanwindom
44
ms.author: lank
55
manager: lank
6-
ms.date: 07/24/2019
6+
ms.date: 03/02/2020
77
ms.topic: conceptual
88
description: Learn how administrators can assign licenses to subscribers
99
---
1010

1111
# Assign licenses in the Visual Studio Subscriptions Administration Portal
1212
As a Visual Studio subscriptions administrator, you can use the administration portal to assign subscriptions to individual users and groups of users.
1313

14-
For groups of users, you can assign subscriptions to them one at a time, or use the [Bulk Add](assign-license-bulk.md) feature to quickly and easily upload lists of subscribers and their subscription information.
14+
For groups of users, you have choices for how you assign subscriptions.
15+
- You can assign subscriptions one at a time.
16+
- You can also quickly and easily upload lists of subscribers and their subscription information using the [Bulk add](assign-license-bulk.md) feature.
17+
- If your organization uses Microsoft Azure Active Directory (Azure AD), you can use Azure AD groups to assign subscriptions to groups of users. (This feature is being deployed in phases and may not be immediately available to your organization.)
18+
1519

1620
## Add a single subscriber
17-
Here's how to assign a Visual Studio subscription license to a new user so that they can access the subscription benefits.
21+
Here's how to assign a Visual Studio subscription to a new user so that they can access the subscription benefits.
1822

1923
1. Sign in to the [administration portal](https://manage.visualstudio.com).
20-
2. To assign a license to a single Visual Studio subscriber, at the top of the table, select **Add**.
24+
2. To assign a license to a single Visual Studio subscriber, at the top of the table, select **Add**, then choose **Individual subscriber**.
2125
> [!div class="mx-imgBorder"]
22-
> ![Add a single subscriber](media/add-single-subscriber.png)
26+
> ![Add a single subscriber](_img/assign-license-add/add-subscriber-individual.png)
2327
3. Enter the information into the form fields for the new subscriber. If your organization is using Azure Active Directory, the **Name** field acts as a search function to find people in your current directory so you can select the correct user from the search results. After you select that person, sign-in email and notification email will automatically populate.
2428
> [!div class="mx-imgBorder"]
2529
> ![Subscriber details](_img/assign-license-add/subscriber-details.png)
@@ -39,7 +43,15 @@ Here's how to assign a Visual Studio subscription license to a new user so that
3943
## Resend assignment emails
4044
After you add a subscriber, an assignment email will be automatically sent to the new subscriber with further instructions. You can send the assignment email again at any time by selecting the subscriber and clicking the **Resend** button in the top menu. To resend emails to multiple users, hold down the **Ctrl** key while selecting the subscribers. When you click the **Resend** button, you'll see a dialog asking you to confirm you want to resend to those subscribers.
4145

46+
## See also
47+
- [Visual Studio documentation](https://docs.microsoft.com/visualstudio/)
48+
- [Azure DevOps documentation](https://docs.microsoft.com/azure/devops/)
49+
- [Azure documentation](https://docs.microsoft.com/azure/)
50+
- [Microsoft 365 documentation](https://docs.microsoft.com/microsoft-365/)
51+
52+
4253
## Next steps
4354
- Have a lot of users to add? Learn how to assign subscriptions to [multiple subscribers](assign-license-bulk.md).
4455
- Need help? Contact [Visual Studio Administration and Subscriptions Support](https://visualstudio.microsoft.com/support/support-overview-vs).
4556

57+

subscriptions/delete-license.md

Lines changed: 15 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,22 +3,33 @@ title: Delete subscription assignments in the Visual Studio Subscriptions Admin
33
author: evanwindom
44
ms.author: lank
55
manager: lank
6-
ms.date: 07/28/2019
6+
ms.date: 03/03/2020
77
ms.topic: conceptual
88
description: Learn how administrators can delete subscription assignments
99
---
1010

1111
# Delete assignments in Visual Studio subscriptions
12-
When a subscriber no longer requires a Visual Studio subscription, such as when they leave the company, complete a project, or switch to a new job role, you can remove their subscription and assign it to someone else. Please note that when you reassign a subscription, the subscriber benefits will not be reset. The new user will be able to claim any unclaimed keys and view previously claimed keys but claim limits are **not** reset.
12+
When a subscriber no longer requires a Visual Studio subscription, such as when they leave the company, complete a project, or switch to a new job role, you can remove their subscription and assign it to someone else. Please note that when you reassign a subscription, not all the subscriber benefits will be reset. The new user will be able to claim any unclaimed keys and view previously claimed keys but claim limits are **not** reset. For organizations that have Enterprise Agreements (EA), any benefits that were used by the original user, such as Pluralsight training, will be reset.
1313

1414
## Delete a subscription assignment
15-
1. Click the name of the subscriber you want to remove. To select multiple subscribers for removal, hold down the **CTRL** key and click each subscriber you wish to remove, or press **CTRL + A** to select and remove all subscribers. The image below shows three subscribers selected.
15+
1. Click the name of the subscriber you want to remove. To select multiple subscribers for removal, you can click the circle to the left of the subscriber name to select each one. Alternatively, you can hold down the **CTRL** key and click each subscriber you wish to remove. Press **CTRL + A** to select and remove all subscribers.
1616
2. To delete the selected subscriber(s), click **Delete**.
1717
3. When the message appears asking you to confirm the deletion, click **OK**.
1818
> [!div class="mx-imgBorder"]
1919
> ![Delete subscribers](_img/delete-license/delete-subscribers.png)
2020
21+
> [!NOTE]
22+
> Bulk delete using a template is not available. For organizations that manage subscription assignments through Azure Active Directory Security Groups, see [our article](assign-license-bulk.md#use-azure-active-directory-groups-to-assign-subscriptions) for more information about how deletions happen.
23+
24+
## See also
25+
- [Visual Studio documentation](https://docs.microsoft.com/visualstudio/)
26+
- [Azure DevOps documentation](https://docs.microsoft.com/azure/devops/)
27+
- [Azure documentation](https://docs.microsoft.com/azure/)
28+
- [Microsoft 365 documentation](https://docs.microsoft.com/microsoft-365/)
29+
2130
## Next steps
2231
- Need to change a subscription without deleting it? Learn how to [Edit subscriptions](edit-license.md)
2332
- For help finding a particular subscription, check out [Search for a subscription](search-license.md).
24-
- Need to create a list of all your subscriptions? Please see [Export subscriptions](exporting-subscriptions.md).
33+
- Need to create a list of all your subscriptions? Please see [Export subscriptions](exporting-subscriptions.md).
34+
35+

subscriptions/edit-license.md

Lines changed: 18 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,46 +3,55 @@ title: Edit subscriptions in the Administration Portal | Microsoft Docs
33
author: evanwindom
44
ms.author: lank
55
manager: lank
6-
ms.date: 07/28/2019
6+
ms.date: 03/03/2020
77
ms.topic: conceptual
88
description: Learn how administrators can edit subscription assignments.
99
---
1010

1111
# Edit Visual Studio subscription assignments
1212
As a subscription administrator, you can make changes to the subscriptions assigned to individuals within your organization. This article discusses the types of changes you can make and provides the necessary steps.
1313

14+
> [!NOTE]
15+
> If you need to change subscription details for a subscriber assigned through an Azure Active Directory Group, you will need to remove them from the group and add them into the Administration Portal individually.
16+
1417
## Change subscriber information
1518
You can edit a subscriber’s information to correct errors or update information.
1619

17-
To edit a subscriber, select the ellipses (…) that appear next to the subscriber’s email address when you hover your mouse over it. A dropdown will appear. Select **Edit** to modify the subscriber’s details. You can also double-click on the subscriber's row in the grid to open the edit window.
20+
To edit a subscriber, select the ellipses (…) that appear next to the subscriber’s email address when you hover your mouse over it. A dropdown will appear. Select **Edit** to modify the subscriber’s details.
1821
> [!div class="mx-imgBorder"]
1922
> ![Select subscriber to edit](_img/edit-license/select-subscriber.png)
2023
21-
You can update the subscriber’s first name, last name, country, language and downloads. Edit the subscriber’s information, and then click **Save**.
22-
23-
> [!NOTE]
24-
> If you need to change the subscription level for a subscriber, you will need to delete the user from the portal and add them again. Subscription levels are not editable.
24+
You can update the subscriber’s first name, last name, subscription level, email address, country, language, downloads and reference field. Edit the subscriber’s information, and click **Save**.
2525

2626
## Edit multiple subscribers using bulk edit
2727
You can edit multiple subscribers at once using the bulk edit process. This feature is primarily used for organizations that are going through corporate email address changes or if an organization has decided to restrict access to downloads.
2828

2929
> [!IMPORTANT]
30-
> Subscription levels (i.e. Enterprise, Professional, etc.) and subscription GUIDs cannot be altered. If you attempt an upload with these items changed, the upload will fail.
30+
> Subscription levels (i.e. Enterprise, Professional, etc.) and subscription GUIDs cannot be altered using Bulk edit. If you need to assign specific subscription GUIDs to you users, use the process for adding users by choosing the subscription ID. If you attempt an upload with these items changed in the Bulk edit template, the upload will fail.
3131
3232
1. To edit multiple subscribers at once, navigate to the Subscribers tab. In the ribbon at the top, click **Bulk Edit**.
3333

3434
2. Bulk edit uses an Excel template to make edits to subscriber information. In the Bulk Edit box, click **Export this excel** to download the current list of subscribers including all of their information.
3535
> [!div class="mx-imgBorder"]
3636
> ![Editing a License - Export Bulk Edits List](_img/edit-license/edit-license-bulk-edit-export.png)
3737
38-
3. Next, save the file locally so you can easily find it and make any necessary changes prior to uploading it. To ensure a successful upload, **don’t edit the subscription level or the subscription GUID** as doing so will cause the upload to fail.
38+
3. Next, save the file locally so you can easily find it and make any necessary changes prior to uploading it. To ensure a successful upload, **don’t edit the subscription level or the subscription GUID** in the Bulk edit file as doing so will cause the upload to fail.
3939

4040
4. Return to the Visual Studio Subscriptions Administration portal and in the Bulk Edit dialog box, click **Browse**. Select the Excel file you saved and click **OK**. You will see the upload progress on the screen.
4141
> [!div class="mx-imgBorder"]
4242
> ![Editing a License - Bulk Edits File Upload](_img/edit-license/edit-license-bulk-file-upload1.png)
4343
4444
5. Once you’ve uploaded the file, you will see a notification letting you know it was successful. At this point, your edits will be reflected in the subscriber information.
4545

46+
## See also
47+
- [Visual Studio documentation](https://docs.microsoft.com/visualstudio/)
48+
- [Azure DevOps documentation](https://docs.microsoft.com/azure/devops/)
49+
- [Azure documentation](https://docs.microsoft.com/azure/)
50+
- [Microsoft 365 documentation](https://docs.microsoft.com/microsoft-365/)
51+
4652
## Next steps
53+
- Need to assign a specific subscription ID? Check out Assigning a subscription ID.
4754
- For help finding a particular subscription, check out [Search for a subscription](search-license.md).
48-
- Need to create a list of all your subscriptions? Check out [Export subscriptions](exporting-subscriptions.md).
55+
- Need to create a list of all your subscriptions? Check out [Export subscriptions](exporting-subscriptions.md).
56+
57+

0 commit comments

Comments
 (0)