Update devops-build-tools.md

[magesoe]

It is currently unclear from the documentation that the service principal needs to be added as an admin application as well as being system admin on the environment. I suggest adding something to the documentation.

https://learn.microsoft.com/en-us/power-platform/admin/powerplatform-api-create-service-principal

[learn-build-service-prod]

Learn Build status updates of commit c6cf841:

⚠️ Validation status: warnings

File	Status	Preview URL	Details
power-platform/alm/devops-build-tools.md	⚠️Warning		Details

power-platform/alm/devops-build-tools.md

• Line 95, Column 134: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/power-platform/admin/powerplatform-api-create-service-principal' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
• Line 95, Column 134: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/power-platform/admin/powerplatform-api-create-service-principal' will be broken in isolated environments. Replace with a relative link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

• Try searching the learn.microsoft.com contributor guides
• Post your question in the Learn support channel

[devkeydet]

I'm not sure why you want to add a link on how to use an API in this situation. In the very next section, we provide instructions on how to create the service principal and add it to the environment.

Can you clarify why this is unclear?

Perhaps helping people understand how to also add an existing SPN? Maybe something like this would help?

If you already created the service principal, you can check if it has been added to the environment using pac admin list-service-principal. If it hasn't been added to the environment, you can add it using pac admin assign-user

We want to encourage people to use pac and not raw API calls.

[phecke]

The existing documentation seems complete. Closing this PR.