Skip to content

Fix git push error for protected CLA branch #3814

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 15 commits into from
Aug 23, 2019
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions docs/extensibility/extending-and-customizing-tool-windows.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,10 +35,12 @@ Visual Studio provides several different types of windows, for example tool wind
You can subscribe to tool window events: [Subscribe to an event](../extensibility/subscribing-to-an-event.md).

## Extend existing tool windows
You can add information about your tool window to a new **Options** page and a new setting on the **Properties** page, write to the **Task List** and **Output** windows. For more information, see [Extend the Properties, Task List, Output, and Options windows](../extensibility/extending-the-properties-task-list-output-and-options-windows.md) and [Extend the Properties, Task List, Output, and Options windows](../extensibility/extending-the-properties-task-list-output-and-options-windows.md).
You can add information about your tool window to a new **Options** page and a new setting on the **Properties** page, write to the **Task List** and **Output** windows. For more information, see [Extend the Properties, Task List, Output, and Options windows](../extensibility/extending-the-properties-task-list-output-and-options-windows.md).

## Modal dialog boxes
In a Visual Studio extension you should create modal dialog boxes by deriving them from <xref:Microsoft.VisualStudio.PlatformUI.DialogWindow?displayProperty=fullName>, which allows you to control them and the rest of the UI. For more information, see [Create and manage modal dialog boxes](../extensibility/creating-and-managing-modal-dialog-boxes.md).

## See also
- [Create an extension with a tool window](../extensibility/creating-an-extension-with-a-tool-window.md)
- [Create an extension with a tool window](../extensibility/creating-an-extension-with-a-tool-window.md)
- [Extend projects](../extensibility/extending-projects.md)
- [Extend solutions](../extensibility/extending-solutions.md)
1 change: 1 addition & 0 deletions docs/install/modify-visual-studio.md
Original file line number Diff line number Diff line change
Expand Up @@ -121,4 +121,5 @@ If you don't want to install workloads to customize your Visual Studio installat
* [Update a network-based installation of Visual Studio](update-a-network-installation-of-visual-studio.md)
* [Update Visual Studio while on a servicing baseline](update-servicing-baseline.md)
* [Control updates to network-based Visual Studio deployments](controlling-updates-to-visual-studio-deployments.md)
* [Workload & component IDs](workload-and-component-ids.md)
* [Uninstall Visual Studio](uninstall-visual-studio.md)
16 changes: 11 additions & 5 deletions subscriptions/TOC.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@
#### [Anonymizations of subscriber data](anonymization.md)
### [Subscriptions portal overview](using-the-subscriber-portal.md)
### [Manage your subscriptions](manage-vs-subscriptions.md)
### [Contact your subscriptions administrator](contact-my-admin.md)
### Benefits
#### Tools
##### [Azure credit](vs-azure.md)
Expand Down Expand Up @@ -58,17 +59,22 @@
#### [Find and claim keys](find-keys.md)
#### [Internet demonstrations](internet-demos.md)
## Administrators
### [Administrator responsibilities](admin-responsibilities.md)
### Administrator responsibilities
#### [Administrator responsibilities](admin-responsibilities.md)
#### [Pre-production inventory](admin-inventory.md)
#### [Manage large teams and external contractors](manage-teams.md)
#### [Track user assignments and process orders](assignments-orders.md)
### Onboarding your organization
#### [Open and Open License Migration](open-migration.md)
### Accessing the admin portal
#### [Volume License](volume-license.md)
#### [MPSA](mpsa.md)
#### [Cloud subscriptions](cloud-admin.md)
#### [Onboarding video](https://youtu.be/plSu6fpi7UI)
#### [Partners managing for customers](open-migration.md)
#### [Video tutorial: Access the admin portal](https://youtu.be/plSu6fpi7UI)
### Using the admin portal
#### [Super admins and administrators](admin-roles.md)
#### [Set agreement preferences](admin-prefs.md)
#### [Overview](using-admin-portal.md)
#### [Video tutorial: Use the admin portal](https://www.youtube.com/watch?v=XG-E-IDjA-w&list=PLReL099Y5nReJhZ6o8CQFPSBgzGCHX99_&index=3&t=0s)
#### Assign subscriptions
##### [Add single users](assign-license.md)
##### [Add multiple users](assign-license-bulk.md)
Expand All @@ -81,7 +87,7 @@
#### [Expired subscriptions](handle-expired-license.md)
#### [Subscribers using aliases](aliasing.md)
#### [Subscribers with personal email sign-ins](personal-email-sign-ins.md)
### [Managing Visual Studio with GitHub Enterprise](assign-github.md)
#### [Managing Visual Studio with GitHub Enterprise](assign-github.md)
## Resources
### [Visual Studio licensing white paper](https://aka.ms/vslicensing)
### [Compare subscription options and pricing](https://visualstudio.microsoft.com/vs/pricing)
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added subscriptions/_img/admin-roles/add-admins.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added subscriptions/_img/admin-roles/add-form.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
74 changes: 74 additions & 0 deletions subscriptions/admin-prefs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
---
title: Set agreement preferences in the Administration Portal
author: evanwindom
ms.author: lank
manager: lank
ms.date: 08/21/2019
ms.topic: conceptual
description: Learn how to set preferences for language, contacts, subscription level and others in the Administration Portal
---

# Set preferences for your agreements in the Administration Portal
Super admins can now set certain preferences in the Administration Portal (admin portal) that will be applied globally for each agreement. These preferences will determine what administrators on your agreements can set when they are adding subscribers, and can only be modified globally by super admins.

## Access preferences
You must be signed in to the [admin portal](https://manage.visualstudio.com) using a sign in ID that has super admin rights on the agreement in order to view or modify the preferences.

To set your preferences:
1. Sign in to the admin portal with an ID that has super admin privileges.
2. Click on the **Manage Administrators** tab.
> [!div class="mx-imgBorder"]
> ![Admin Preferences button](_img/admin-prefs/admin-prefs-button.png)

3. Click **Agreement Preferences**.
A panel will open on the right and your available preferences will be displayed.

> [!div class="mx-imgBorder"]
> ![Admin Preferences flyout dialog](_img/admin-prefs/admin-prefs-flyout.png)

## Set your preferences
Let's explore each of the available preferences, and their effects.

### Agreement
If you have multiple agreements for which you're a super admin, you'll be able to choose the desired agreement in the drop-down. The preferences you set will apply only to that agreement. Individual admins can override some of these preferences on a case-by-case basis when assigning subscriptions.

If there is only one agreement associated with the email address you used to sign in, it will be displayed and the drop-down will be disabled.

### Contact email address
This preferences provides a way for your subscribers to reach out to administrators through the use of the **Contact my Admin** button on the [subscriptions page](https://my.visualstudio.com/subscriptions) of the subscriber portal. If this preference is left blank, subscriber messages will be forwarded to all administrators and super admins on the agreement. We recommend using a group email alias or security group to tailor your audience for this contact email. You can also choose to input an individual’s email address if you prefer.

> [!NOTE]
> The email address you list here will NOT be provided to subscribers. When a subscriber submits a **Contact my Admin** request in the subscriber portal, the message will be forwarded to the alias without exposing it to subscribers.

### Default external subscribers setting
This preference allows you to decide whether administrators can add subscribers from outside your organization's tenant/directory. If you turn this off, no outside subscribers will be allowed. If you enable it and an admin attempts to add an outside subscriber, they will be asked to confirm their choice, and will be allowed to assign the subscription. Admins cannot override this setting.

### Default downloads setting
Enabling this setting, which is on by default, will enable subscribers to access downloads when admins create new subscriptions. Admins can still disable downloads on an individual subscription basis.

### Default subscription level
You can use this setting to determine which of the subscription levels included in your agreement is selected by default when a subscription is assigned to a user. Admins can change the setting to any subscription level in your agreement -- This just prevents having to repeatedly make your most common choice.

### Default communication preferences
Setting a default communication language and locale can streamline the process of assigning subscriptions. For example, if your development team is based in a different country than your admin team, you can set the preferences best suited to the subscribers' location. These settings can still be changed by all admins for individual subscribers.

## Frequently asked questions
### Q: Can I disable the **Contact email address** so subscribers cannot contact administrators?
A: No - while you can determine which administrators are contacted using a security group, group email alias or an individual email address, the feature cannot be disabled.

### Q: If I answer a subscriber's email, will they have my email address?
A: Since your response will come from whatever email client you're using, the response the subscriber receives will show whatever email address you're using. So, if you're responding from a group alias, they'll see the group alias. If you respond from your own email address, they will see that.

### Q: Where can I find out more about the **Contact my Admin** feature in the subscriber portal?
A: Check out our [Contact my Admin](contact-my-admin.md) article.

### Q: If we don't complete the **Contact email address** and a subscriber uses the **Contact my Admin** feature, who receives their request?
A: If no specific email address is set in the **Contact email address** preference, all admins on the agreement will receive the request.

## Resources
- [Visual Studio Administration and Subscriptions Support](https://visualstudio.microsoft.com/support/support-overview-vs)

## Next steps
- Learn how to [assign subscriptions](assign-license.md)
- Learn more about the full range of [subscription benefits](https://visualstudio.microsoft.com/vs/benefits/)

43 changes: 43 additions & 0 deletions subscriptions/admin-roles.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
---
title: Super admin and administrator roles in the Administration Portal
author: evanwindom
ms.author: lank
manager: lank
ms.date: 08/21/2019
ms.topic: conceptual
description: Learn about the super admin and administrator roles, and how to assign administrators.
---

# Super admins and administrators for Visual Studio subscription agreements

There are two different roles in the new Visual Studio Subscriptions Administration Portal for Volume Licensing customers. These roles are like the Primary/Notices Contact role and the Subscriptions Manager role that used to exist in the VLSC.

**Super admins:** When an organization is initially set up, the Primary or Notices Contact becomes a super admin by default. The Primary or Notices Contact can choose to assign additional super admins or administrators. A super admin can add and remove other administrators as well as subscribers. If there are more than two super admins in the system, a super-admin can delete all but the last two for security.

**Administrators:** An administrator can only be assigned by a super admin. An administrator can only manage subscribers in the agreements that the super admin assigns to them.

## Assigning administrators
To assign new administrators (admins):
1. Sign in to https://manage.visualstudio.com using an email address that's assigned as a super admin on the agreement through which the subscriptions were purchased.
2. Click on the tab labeled **Manage Administrators**.
3. Click **Add**.
> [!div class="mx-imgBorder"]
> ![Add administrators](_img/admin-roles/add-admins.png)
4. Complete the form with the new admin's information.
> [!div class="mx-imgBorder"]
> ![Add administrator form](_img/admin-roles/add-form.png)

> [!NOTE]
> If you want this admin to be able to assign additional admins, remember to check the **Super Admin** box.

5. After you click **Add** to assign the new admin, they will receive an email inviting them to sign in to the portal.

## Resources
- [Visual Studio Administration and Subscriptions Support](https://visualstudio.microsoft.com/support/support-overview-vs)

## Next steps
- Learn how to [assign subscriptions](assign-license.md)
- Learn more about the full range of [subscription benefits](https://visualstudio.microsoft.com/vs/benefits/)
- [Set agreement preferences](admin-prefs.md)


36 changes: 36 additions & 0 deletions subscriptions/contact-my-admin.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
---
title: Contact your subscription administrator from within the Subscriber Portal
author: evanwindom
ms.author: lank
manager: lank
ms.date: 08/21/2019
ms.topic: conceptual
description: Learn how to contact your subscription administrator for assistance with questions or issues.
---

# Get assistance from your subscriptions adminstrator
If your Visual Studio subscription is provided to you by your work or school, chances are it was assigned to you by a subscriptions administrator, or "admin". Admins can assign or remove subscriptions, change sign-in email addresses, determine whether you have the ability to download software, and perform other functions related to your subscription.

Given the size and complexity of many organizations, you may not be aware of who your admin is, so it can be tough to know where to get help. We've added a new feature to the subscriber portal to assist you with contacting your admin.

## How to contact your admin
1. Sign in to the subscriber portal at https://my.visualstudio.com
2. Click on the **Subscriptions** tab.
3. Click the **Contact my Admin** button at the top right.
> [!div class="mx-imgBorder"]
> ![Contact my Admin](_img/contact-my-admin/contact-my-admin-button.png)
4. Enter the message for your admin.
5. If you'd like to receive a copy of the message sent to your admin, click the **Send me a copy** checkbox.
6. Finally, click **Send**.

## Resources
- [Visual Studio Administration and Subscriptions Support](https://visualstudio.microsoft.com/support/support-overview-vs)

## Next steps
If you haven't already done so, we recommend activating these benefits to get the most out of your Visual Studio subscription:
- [Visual Studio IDE](vs-ide-benefit.md)
- [Azure](vs-azure.md)
- [Azure DevOps](vs-azure-devops.md)

These benefits and more can be found at https://my.visualstudio.com/benefits.

11 changes: 6 additions & 5 deletions subscriptions/open-migration.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
---
title: Open and Open License order management | Microsoft Docs
title: Partners managing Visual Studio subscriptions for customers | Microsoft Docs
author: evanwindom
ms.author: lank
manager: lank
ms.date: 07/23/2019
ms.date: 08/21/2019
ms.topic: conceptual
description: Learn about management of order for subscriptions using Open and Open License programs.
description: Learn how partners manage Visual Studio subscriptions for their customers.
---

# Open and Open License management for new orders
To manage subscriptions in the Visual Studio [Subscriptions Administration Portal](https://manage.visualstudio.com), there are a few steps that partners and customers will need to follow. The process will be:
# Partners managing subscriptions on behalf of customers
To manage subscriptions in the Visual Studio [Subscriptions Administration Portal](https://manage.visualstudio.com), there are a few steps they will need to follow. The process will be:
- Partners will place a new order on behalf of a customer, entering the customer’s business email address.
- The customer will receive a notification inviting them to assign administrators and access their subscriptions in the [Visual Studio Subscriptions Administration Portal](https://manage.visualstudio.com).
- For partners to manage subscriptions on behalf of customers, they will need to register on the administration portal. The various ways to access gain access are listed below (similar to the add-open process).
Expand All @@ -34,6 +34,7 @@ This applies to new partners placing new Open License orders, but who register o
> [!NOTE]
> The customer will receive a notification email informing them that a Partner has been added to the Open License. They can choose to remove the Partner’s access.


## New partners visiting the Visual Studio Subscriptions Administration Portal directly
This scenario applies to new partners, who have already placed new Open License orders, but who haven’t registered on the [VLSC](https://www.microsoft.com/Licensing/servicecenter/default.aspx) and go directly to the [Visual Studio Subscriptions Administration Portal](https://manage.visualstudio.com). Follow these steps:
- Visit https://manage.visualstudio.com.
Expand Down
28 changes: 28 additions & 0 deletions subscriptions/volume-license.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
---
title: Accessing the Administration Portal for Volume License customers | Microsoft Docs
author: evanwindom
ms.author: lank
manager: lank
ms.date: 08/22/2019
ms.topic: conceptual
description: Learn how administrators on Volume License agreements can access the Visual Studio subscriptions Administration Portal
---

# Accessing the Administation Portal as an admin on a Volume License agreement

If you are the primary or notices contact on your organization’s agreement, you will be automatically provisioned access to the portal upon setting up your Volume Licensing agreement. You’ll receive a system-triggered welcome email which will prompt you to sign into the portal. The email will indicate which email address to use to sign into the portal.

> [!div class="mx-imgBorder"]
> ![Volume License admin notification](_img/volume-license/super-admin-notice.png)

Once you’re signed in, you will be automatically set up as a super admin and can begin managing subscriptions and other administrators. For information about the differences between super admins and administrators, take a look at our article about [admin roles](admin-roles.md).

This applies to all Volume Licensing agreement types including, but not limited to: Enterprise agreements, Enterprise subscriptions, Select, Select Plus, Open, Open License, Govt. and Academic agreements.

## Resources
- [Visual Studio Administration and Subscriptions Support](https://visualstudio.microsoft.com/support/support-overview-vs)

## Next steps
- Learn how to [assign subscriptions](assign-license.md)
- Learn more about the full range of [subscription benefits](https://visualstudio.microsoft.com/vs/benefits/)
- [Set agreement preferences](admin-prefs.md)