Document Details
Phone Numbers Az Cli
❌
This page contains Windows bias
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:
⚠️
windows_first
⚠️
missing_linux_example
Summary:
The documentation demonstrates a mild Windows bias. The Azure CLI installation link points only to Windows instructions, omitting direct links or guidance for Linux or macOS. In the environment variable section, Windows instructions are presented first, followed by macOS and Linux, which may reinforce a Windows-centric perspective. There are no PowerShell-specific examples, but Linux users may find the installation and environment setup less accessible due to missing or less prominent Linux guidance.
Recommendations:
- Provide installation links for Azure CLI for all major platforms (Windows, Linux, macOS) in the prerequisites section, or use a platform-neutral link.
- Rotate or randomize the order of OS-specific tabs (Windows, macOS, Linux) or default to the user's detected OS if possible.
- Ensure Linux and macOS instructions are as detailed and prominent as Windows instructions.
- Consider including a brief note that all CLI commands work cross-platform, and highlight any OS-specific differences if they exist.
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-07-12 23:44 | #41 | in_progress | ❌ Biased |
| 2025-07-12 00:58 | #8 | cancelled | ✅ Clean |
| 2025-07-10 05:06 | #7 | processing | ✅ Clean |
Flagged Code Snippets
After you add the environment variable, you may need to restart any running programs that will need to read the environment variable, including the console window. For example, if you're using Visual Studio as your editor, restart Visual Studio before running the example.
#### [macOS](#tab/unix)
Edit your **`.zshrc`**, and add the environment variable:
Make these replacements in the code:
- Replace `<purchasedPhoneNumber>` with a phone number that's associated with your Communication Services resource.
- Replace `<yourConnectionString>` with your connection string.
> [!NOTE]
> The Azure CLI option provides functionality only for listing and showing phone numbers. It does not support other operations such as searching, purchasing, editing or releasing phone numbers.
### (Optional) Use Azure CLI phone numbers operations without passing in a connection string
You can configure the `AZURE_COMMUNICATION_CONNECTION_STRING` environment variable to use Azure CLI phone numbers operations without having to use `--connection_string` to pass in the connection string. To configure an environment variable, open a console window and select your operating system from the below tabs. Replace `<yourConnectionString>` with your actual connection string.
#### [Windows](#tab/windows)
Open a console window and enter the following command: