Phone Numbers Az Cli - Document Details

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.

View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected 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	Status	Result
2025-07-12 23:44	#41	cancelled	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: