Proposed Pull Request Change

📄 Document Links

View on GitHub View on Microsoft Learn

--- title: CLI reference for `azcmagent check` description: Syntax for the `azcmagent check` command line tool ms.topic: reference ms.date: 12/01/2025 # Customer intent: As a system administrator, I want to run network connectivity checks using the command line tool, so that I can ensure the agent can communicate with required Azure endpoints accurately. --- # `azcmagent check` Run a series of network connectivity checks to see if the agent can successfully communicate with required network endpoints. The command outputs a table showing connectivity test results for each required endpoint, including whether the agent used a private endpoint, proxy server, and/or Arc gateway. ## Usage ``` azcmagent check [flags] ``` ## Examples Check connectivity with the agent's configured cloud and region: ``` azcmagent check ``` Check connectivity with the East US region using public endpoints: ``` azcmagent check --location "eastus" ``` Check connectivity for supported extensions (SQL Server enabled by Azure Arc) using public endpoints: ``` azcmagent check --extensions all ``` Check connectivity with the Central India region using private endpoints: ``` azcmagent check --location "centralindia" --enable-pls-check ``` ## Flags This command supports the flags described in [Common flags](azcmagent.md#common-flags) and the flags listed in this section. `--cloud` Specifies the Azure cloud instance. Must be used with the `--location` flag. If the machine is already connected to Azure Arc, the default value is the cloud to which the agent is already connected. Otherwise, the default value is `AzureCloud`. Supported values: * `AzureCloud` (public regions) * `AzureUSGovernment` (Azure US Government regions) * `AzureChinaCloud` (Microsoft Azure operated by 21Vianet regions) `-e`, `--extensions` Includes extra checks for extension endpoints to help validate end-to-end scenario readiness. This flag is available in agent version 1.41 and later. Supported values: * `all` (checks all supported extension endpoints) * `sql` (SQL Server enabled by Azure Arc) `--include-all` Includes connectivity checks for all extended use cases, such as [Windows Server Pay-as-you-go](/windows-server/get-started/windows-server-pay-as-you-go?tabs=gui%2Cazureportal). `-l`, `--location` The Azure region to check connectivity with. If the machine is already connected to Azure Arc, the current region is selected as the default. Sample value: `westeurope` `-p`, `--enable-pls-check` Checks if supported Azure Arc endpoints resolve to private IP addresses. This flag should be used when you intend to connect the server to Azure using an Azure Arc private link scope.