Azure DevOps organization and projects - Commands & Configuration

Introduction

When you want to manage your software development work in one place, Azure DevOps helps by organizing your teams and projects. It lets you keep code, tasks, and builds tidy and easy to find.

When you want to keep your team’s code and work organized in one online place.

When you need to track tasks and bugs for a software project.

When you want to set up automated builds and tests for your app.

When you want to share code and collaborate with others securely.

When you want to manage multiple projects under one company or team.

Commands

This command sets your default Azure DevOps organization and project so you don't have to type them every time.

Terminal

az devops configure --defaults organization=https://dev.azure.com/exampleorg project=exampleproject

Expected Output

No output (command runs silently)

→

--defaults - Sets default values for organization and project

This command creates a new project named 'exampleproject' inside the specified Azure DevOps organization.

Terminal

az devops project create --name exampleproject --organization https://dev.azure.com/exampleorg

Expected Output

{

  "id": "00000000-0000-0000-0000-000000000000",

  "name": "exampleproject",

  "url": "https://dev.azure.com/exampleorg/exampleproject"

}

→

--name - Specifies the project name

→

--organization - Specifies the Azure DevOps organization URL

This command lists all projects in the specified Azure DevOps organization so you can see what projects exist.

Terminal

az devops project list --organization https://dev.azure.com/exampleorg

Expected Output

[

  {

    "id": "00000000-0000-0000-0000-000000000000",

    "name": "exampleproject",

    "url": "https://dev.azure.com/exampleorg/exampleproject"

  }

]

→

--organization - Specifies the Azure DevOps organization URL

Key Concept

If you remember nothing else, remember: an Azure DevOps organization holds projects, and projects hold your code and work items.

Common Mistakes

Not setting the default organization and project before running commands.

Commands will fail or require you to specify the organization and project every time.

Run 'az devops configure --defaults organization=https://dev.azure.com/exampleorg project=exampleproject' once to set defaults.

Trying to create a project with a name that already exists in the organization.

Azure DevOps will reject duplicate project names within the same organization.

Choose a unique project name or check existing projects with 'az devops project list'.

Summary

Set your default Azure DevOps organization and project to simplify commands.

Create new projects inside your organization to organize your work.

List projects to see what is available in your organization.

Practice

1. What is the main purpose of an Azure DevOps organization?

easy

A. To manage virtual machines

B. To store only your code repositories

C. To replace Azure subscriptions

D. To hold and manage all your projects in one place

Solution

1. Step 1: Understand the role of an Azure DevOps organization

   An Azure DevOps organization acts as a container for all your projects, grouping them together for management.

2. Step 2: Differentiate from other Azure services

   It is not for managing virtual machines or replacing subscriptions, but specifically for organizing projects and related resources.

3. Final Answer:

   To hold and manage all your projects in one place -> Option D

4. Quick Check:

   Organization = container for projects [OK]

Hint: Organization groups projects, not just code or VMs [OK]

Common Mistakes:

• Confusing organization with Azure subscription
• Thinking organization manages VMs
• Assuming organization stores only code

2. Which Azure CLI command correctly creates a new Azure DevOps project named MyProject in an organization?

easy

A. az devops create project MyProject

B. az devops project create --name MyProject

C. az project create --org MyProject

D. az devops new project --project MyProject

Solution

1. Step 1: Identify the correct Azure CLI syntax for project creation

   The correct command uses az devops project create with the --name parameter to specify the project name.

2. Step 2: Check the options for syntax errors

   The other options use incorrect command structures or parameters not recognized by Azure CLI.

3. Final Answer:

   az devops project create --name MyProject -> Option B

4. Quick Check:

   Correct CLI syntax = az devops project create --name MyProject [OK]

Hint: Use 'az devops project create --name' to create projects [OK]

Common Mistakes:

• Using wrong command order
• Missing --name parameter
• Confusing project and organization parameters

3. What will be the output of this Azure CLI command if the organization MyOrg has two projects named Alpha and Beta?

az devops project list --organization https://dev.azure.com/MyOrg

medium

A. An empty list with no projects

B. An error saying organization not found

C. A list showing projects Alpha and Beta with their IDs and descriptions

D. A list of all Azure subscriptions

Solution

1. Step 1: Understand the command purpose

   The command az devops project list lists all projects in the specified organization URL.

2. Step 2: Predict output based on existing projects

   Since the organization has two projects, the output will list both with details like IDs and descriptions.

3. Final Answer:

   A list showing projects Alpha and Beta with their IDs and descriptions -> Option C

4. Quick Check:

   List projects command outputs existing projects [OK]

Hint: List projects shows all projects in the given organization [OK]

Common Mistakes:

• Expecting subscription list instead of projects
• Assuming error if organization exists
• Thinking output is empty when projects exist

4. You run the command az devops project create --name without specifying a project name. What is the most likely result?

medium

A. The CLI returns an error about missing required parameter

B. The command runs but creates an empty project

C. A new organization is created instead

D. The project is created with a default name

Solution

1. Step 1: Analyze the command syntax

   The --name parameter is required to specify the project name when creating a project.

2. Step 2: Predict CLI behavior on missing required parameter

   Without a project name, the CLI will return an error indicating the missing required argument.

3. Final Answer:

   The CLI returns an error about missing required parameter -> Option A

4. Quick Check:

   Missing required parameter causes CLI error [OK]

Hint: Always provide --name when creating projects [OK]

Common Mistakes:

• Assuming default project name is assigned
• Expecting organization creation instead
• Thinking command silently succeeds

5. You want to organize your team's work by creating multiple projects under one Azure DevOps organization. Which of the following is the best practice?

hard

A. Create multiple projects within a single organization to share resources and users

B. Use a single project for all work to simplify management

C. Create one organization per project to isolate resources

D. Create projects only after creating separate Azure subscriptions

Solution

1. Step 1: Understand organization and project roles

   An Azure DevOps organization is designed to hold multiple projects, allowing teams to share users and resources efficiently.

2. Step 2: Evaluate best practice for team collaboration

   Creating multiple projects within one organization is best for managing related work and sharing access, rather than isolating each project in separate organizations.

3. Final Answer:

   Create multiple projects within a single organization to share resources and users -> Option A

4. Quick Check:

   One organization, many projects = best practice [OK]

Hint: Use one organization for many projects to share access [OK]

Common Mistakes:

• Creating too many organizations causing management overhead
• Putting all work in one project losing separation
• Confusing Azure subscriptions with DevOps organizations