App-Center-Bulk-Import

msacbulkimport - Microsoft App Center Bulk Import utility

msacbulkimport is a .NET Core utility that allows users to import multiple users to an organization or team.

It is intended as a demo for how to use the App Center REST API for account management. No warranties about its correctness or performance are offered, but best-effort has been made to ensure that it runs correctly.

Building the code

msacbulkimport uses .NET Core 3.0, which you can download from dot.net. Build the project by running

dotnet build msacbulkimport.csproj

or by using your favorite editor or IDE.

Input file

The input file is expected to be a list of email addresses, one-per-line, with no headers or other information.

For example:

vanessa.manager@mydomain.com
rebecca.programmer@mydomain.com
brandon.productmanager@mydomain.com
megan.betatester@someotherdomain.com

Lines that are not email addresses will be shown as errors in the output file, and ignored.

Output file

All output is shown in the terminal window, and also written to an output file. By default, this file is called bulkimportresult.txt.

Examples:

Invite users to an organization:

msacbulkimport --apitoken <myApiToken> --organization My-Organization-Name --organizationrole member --inputfile C:\MyPath\userfile.txt

Sample output:

>.\msacbulkimport.exe --organization Scotts-org --organizationrole member --inputfile C:\MyPath\users.txt --apitoken XXX

msacbulkimport - Microsoft App Center Bulk Import utility

Tester1@scottarbeit.com: Sent invitation to join organization.
Tester2@scottarbeit.com: Sent invitation to join organization.
ProgramManager1@scottarbeit.com: Sent invitation to join organization.
ProgramManager2@scottarbeit.com: Sent invitation to join organization.
notvalid: Error: doesn't appear to be a valid email address.
notvalid@notvalid: Error: doesn't appear to be a valid email address.
msacpm1@outlook.com: Sent invitation to join organization.

Done.

Invite users to a team (they must already be in the organization):

msacbulkimport --apitoken <myApiToken> --organization My-Organization-Name --team My-Team-Name --teamrole member --inputfile C:\MyPath\userfile.txt

Sample output (with one user who has not accepted the invitation to join the organization):

>.\msacbulkimport.exe --organization Scotts-org --team "Team-1" --teamrole member --inputfile C:\MyPath\teammembers.txt --apitoken XXX

msacbulkimport - Microsoft App Center Bulk Import utility

msacpm1@outlook.com: Added team member.
Tester1@scottarbeit.com: Error: failed to add team member; {"error":{"code":"BadRequest","message":"The user with the email \"Tester1@scottarbeit.com\" is not a member of the organization \"Scotts-Org\""}}
notvalid: Error: doesn't appear to be a valid email address.
notvalid@notvalid: Error: doesn't appear to be a valid email address.

Done.

Show help:

msacbulkimport --help
msacbulkimport /?

Parameters:

--apitoken (required) The API token for your organization

--inputfile (required) The name of the file containing email addresses of users to import

--organization (required) The name of your organization (i.e. the slug used in AppCenter URL's)

--organizationrole The organization role for new collaborators; either admin, collaborator, or member

--team The name of the team (i.e. the slug used in AppCenter URL's), if adding team members

--teamrole The team role for new team members; either admin, collaborator, or member

--outputfile The name of the output file; default is bulkimportresult.txt

--help | /? Show help message