Skip to content
This repository was archived by the owner on Jan 21, 2026. It is now read-only.

Commit 817ed82

Browse files
authored
Merge pull request #470 from mkennten/patch-5
"Validate lab environment": clarification where to begin
2 parents a9cd460 + e3a169d commit 817ed82

1 file changed

Lines changed: 22 additions & 21 deletions

File tree

Instructions/Labs/AZ400_M00_Validate_lab_environment.md

Lines changed: 22 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -10,30 +10,31 @@ lab:
1010

1111
## Instructions to create an Azure DevOps Organization (you only have to do this once)
1212

13-
> **Note**: Start at step 4, if you do already have a **personal Microsoft Account** setup and an active Microsoft Azure Pass subscription linked to that account.
14-
13+
### Start here if you don't have an Azure subscription:
1514
1. Get a new **Azure Pass promocode** from the instructor or other source.
16-
2. Use a private browser session to get a new **personal Microsoft Account (MSA)** at [https://account.microsoft.com](https://account.microsoft.com).
17-
3. Using the same browser session, go to [https://www.microsoftazurepass.com](https://www.microsoftazurepass.com) to redeem your Azure Pass using your Microsoft Account (MSA). For details, see [Redeem a Microsoft Azure Pass](https://www.microsoftazurepass.com/Home/HowTo?Length=5). Follow the instructions for redemption.
18-
19-
4. Open a browser and navigate to [https://portal.azure.com](https://portal.azure.com), then search at the top of the Azure portal screen for **Azure DevOps**. In the resulting page, click **Azure DevOps organizations**.
20-
5. Next, click on the link labelled **My Azure DevOps Organizations** or navigate directly to [https://aex.dev.azure.com](https://aex.dev.azure.com).
21-
6. On the **We need a few more details** page, select **Continue**.
22-
7. In the drop-down box on the left, choose **Default Directory**, instead of “Microsoft Account”.
23-
8. If prompted (*"We need a few more details"*), provide your name, e-mail address, and location and click **Continue**.
24-
9. Back at [https://aex.dev.azure.com](https://aex.dev.azure.com) with **Default Directory** selected click the blue button **Create new organization**.
25-
10. Accept the *Terms of Service* by clicking **Continue**.
26-
11. If prompted (*"Almost done"*), leave the name for the Azure DevOps organization at default (it needs to be a globally unique name) and pick a hosting location close to you from the list.
27-
12. Once the newly created organization opens in **Azure DevOps**, click **Organization settings** in the bottom left corner.
28-
13. At the **Organization settings** screen click **Billing** (opening this screen takes a few seconds).
29-
14. Click **Setup billing** and on the right-hand side of the screen select the **Azure Pass - Sponsorship** subscription and click **Save** to link the subscription with the organization.
30-
15. Once the screen shows the linked Azure Subscription ID at the top, change the number of **Paid parallel jobs** for **MS Hosted CI/CD** from 0 to **1**. Then click the **SAVE** button at the bottom.
31-
16. In **Organization Settings**, go to section **Security** and click **Policies**.
32-
17. Toggle the switch to **On** for **Third-party application access via OAuth**
15+
1. Use a private browser session to get a new **personal Microsoft Account (MSA)** at [https://account.microsoft.com](https://account.microsoft.com).
16+
1. Using the same browser session, go to [https://www.microsoftazurepass.com](https://www.microsoftazurepass.com) to redeem your Azure Pass using your Microsoft Account (MSA). For details, see [Redeem a Microsoft Azure Pass](https://www.microsoftazurepass.com/Home/HowTo?Length=5). Follow the instructions for redemption.
17+
18+
### Start here if you have an Azure subscription:
19+
20+
1. Open a browser and navigate to [https://portal.azure.com](https://portal.azure.com), then search at the top of the Azure portal screen for **Azure DevOps**. In the resulting page, click **Azure DevOps organizations**.
21+
1. Next, click on the link labelled **My Azure DevOps Organizations** or navigate directly to [https://aex.dev.azure.com](https://aex.dev.azure.com).
22+
1. On the **We need a few more details** page, select **Continue**.
23+
1. In the drop-down box on the left, choose **Default Directory**, instead of “Microsoft Account”.
24+
1. If prompted (*"We need a few more details"*), provide your name, e-mail address, and location and click **Continue**.
25+
1. Back at [https://aex.dev.azure.com](https://aex.dev.azure.com) with **Default Directory** selected click the blue button **Create new organization**.
26+
1. Accept the *Terms of Service* by clicking **Continue**.
27+
1. If prompted (*"Almost done"*), leave the name for the Azure DevOps organization at default (it needs to be a globally unique name) and pick a hosting location close to you from the list.
28+
1. Once the newly created organization opens in **Azure DevOps**, click **Organization settings** in the bottom left corner.
29+
1. At the **Organization settings** screen click **Billing** (opening this screen takes a few seconds).
30+
1. Click **Setup billing** and on the right-hand side of the screen select the **Azure Pass - Sponsorship** subscription and click **Save** to link the subscription with the organization.
31+
1. Once the screen shows the linked Azure Subscription ID at the top, change the number of **Paid parallel jobs** for **MS Hosted CI/CD** from 0 to **1**. Then click the **SAVE** button at the bottom.
32+
1. In **Organization Settings**, go to section **Security** and click **Policies**.
33+
1. Toggle the switch to **On** for **Third-party application access via OAuth**
3334
> Note: The OAuth setting helps enable tools such as the DemoDevOpsGenerator to register extensions. Without this, several labs may fail due to a lack of the required extensions.
34-
18. Toggle the switch to **On** for **Allow public projects**
35+
1. Toggle the switch to **On** for **Allow public projects**
3536
> Note: Extensions used in some labs might require a public project to allow using the free version.
36-
19. **Wait at least 3 hours before using the CI/CD capabilities** so that the new settings are reflected in the backend. Otherwise, you will still see the message *"No hosted parallelism has been purchased or granted"*.
37+
1. **Wait at least 3 hours before using the CI/CD capabilities** so that the new settings are reflected in the backend. Otherwise, you will still see the message *"No hosted parallelism has been purchased or granted"*.
3738

3839
## Instructions to create the sample Azure DevOps Project (you only have to do this once)
3940

0 commit comments

Comments
 (0)