About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
missing_linux_example
⚠️
windows_tools
⚠️
windows_first
Summary:
The documentation exclusively uses PowerShell and Windows-centric tooling (Invoke-RestMethod, PowerShell syntax) for all examples and instructions. There are no equivalent examples for Linux users (e.g., using Bash, curl, or az CLI), and the workflow assumes familiarity with Windows scripting and tools. This creates a significant bias toward Windows environments and leaves Linux users without clear guidance.
Recommendations:
- Provide equivalent examples using Bash and curl for REST API calls.
- Include az CLI commands for all operations where possible, as az CLI is cross-platform.
- Explicitly mention that the steps can be performed from any OS, and clarify tool requirements.
- Structure the documentation to present both Windows/PowerShell and Linux/Bash examples side by side.
- Avoid assuming PowerShell as the default scripting environment; offer alternatives for Linux/macOS users.
Create pull request
Flagged Code Snippets
## Adjusting the location
Creating the profile in a new location is as simple as changing the `Location` property to our desired Azure Region.
We also will need to create a new name for this profile. Let's change the name of the Configuration Profile `profileUk`. We should update the `Name` property within the profile, and also in the URL. We can use the `-replace` format operator to make this simple.
Now that we have changed the Location value, this updated Configuration Profile will be created in Western Europe when we submit it.
## Creating the new profile in the desired location
All that remains now is to `PUT` this new profile, using `Invoke-RestMethod` once more.