About setup of Visual Studio subscriptions with GitHub Enterprise
Visual Studio subscriptions with GitHub Enterprise is a combined offering from Microsoft that allows a subscriber to use both Visual Studio and GitHub Enterprise. See About Visual Studio subscriptions with GitHub Enterprise.
This guide shows you how your team can get Visual Studio subscribers licensed and started with GitHub Enterprise.
Roles for Visual Studio subscriptions with GitHub Enterprise
Before setting up Visual Studio subscriptions with GitHub Enterprise, it's important to understand the roles for this combined offering.
| Role | Service | Description | More information |
|---|---|---|---|
| Subscriptions admin | Visual Studio subscription | Person who assigns licenses for Visual Studio subscription | Overview of admin responsibilities in Microsoft Docs |
| Subscriber | Visual Studio subscription | Person who uses a license for Visual Studio subscription | Visual Studio Subscriptions documentation in Microsoft Docs |
| Enterprise owner | GitHub | Person who has a personal account that's an administrator of an enterprise on GitHub.com | Roles in an enterprise |
| Organization owner | GitHub | Person who has a personal account that's an owner of an organization in your team's enterprise on GitHub.com | Roles in an organization |
| Enterprise member | GitHub | Person who has a personal account that's a member of an enterprise on GitHub.com | Roles in an enterprise |
Prerequisites
-
Your team's Visual Studio subscription must include GitHub Enterprise. For more information, see Visual Studio Subscriptions and Benefits on the Visual Studio website and Overview of admin responsibilities in Microsoft Docs.
-
Your team must have an enterprise on GitHub.com. If you're not sure whether your team has an enterprise, contact your GitHub administrator. If you're not sure who on your team is responsible for GitHub, contact GitHub's Sales team. For more information, see About enterprise accounts.
Setting up Visual Studio subscriptions with GitHub Enterprise
To set up Visual Studio subscriptions with GitHub Enterprise, members of your team must complete the following tasks.
One person may be able to complete the tasks because the person has all of the roles, but you may need to coordinate the tasks with multiple people. For more information, see Roles for Visual Studio subscriptions with GitHub Enterprise.
-
An enterprise owner must create at least one organization in your enterprise on GitHub.com. For more information, see Adding organizations to your enterprise.
-
The subscription admin must assign a license for Visual Studio to a subscriber in the administrator portal for Visual Studio subscriptions. For more information, see Overview of the Visual Studio Subscriptions Administrator Portal and Assign Visual Studio Licenses in the Visual Studio Subscriptions Administration Portal in Microsoft Docs.
-
Optionally, if the subscription admin assigned licenses to subscribers in Visual Studio before adding GitHub Enterprise to the subscription, the subscription admin can move the subscribers to the combined offering in the Visual Studio administration portal. For more information, see Manage Visual Studio subscriptions with GitHub Enterprise in Microsoft Docs.
-
If the subscription admin has not disabled email notifications, the subscriber will receive two confirmation emails. For more information, see Visual Studio subscriptions with GitHub Enterprise in Microsoft Docs.
-
An organization owner must invite the subscriber to the organization on GitHub.com from step 1. The subscriber can accept the invitation with an existing personal account or create a new account. After the subscriber joins the organization, the subscriber becomes an enterprise member. For more information, see Inviting users to join your organization.
Tip
- While not required, we recommend that the organization owner sends an invitation to the same email address used for the subscriber's User Primary Name (UPN). When the email address on GitHub.com matches the subscriber's UPN, you can ensure that another enterprise does not claim the subscriber's license.
- If the subscriber accepts the invitation to the organization with an existing personal account on GitHub.com, we recommend that the subscriber add the email address they use for Visual Studio to their personal account on GitHub.com. For more information, see Adding an email address to your GitHub account.
- If the organization owner must invite a large number of subscribers, a script may make the process faster. For more information, see the sample PowerShell script in the
github/platform-samplesrepository.
After Visual Studio subscriptions with GitHub Enterprise is set up for subscribers on your team, enterprise owners can review licensing information on GitHub.com. For more information, see Viewing the subscription and usage for your enterprise account.