Edit

Share via


Azure Developer CLI reference

This article explains the syntax and parameters for the various Azure Developer CLI commands.

azd

The Azure Developer CLI (azd) is an open-source tool that helps onboard and manage your project on Azure

Options

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --docs Opens the documentation for azd in your web browser. -h, --help Gets help for azd. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

  • azd add: Add a component to your project.
  • azd auth: Authenticate with Azure.
  • azd completion: Generate shell completion scripts.
  • azd config: Manage azd configurations (ex: default Azure subscription, location).
  • azd deploy: Deploy your project code to Azure.
  • azd down: Delete your project's Azure resources.
  • azd env: Manage environments (ex: default environment, environment variables).
  • azd extension: Manage azd extensions.
  • azd hooks: Develop, test and run hooks for a project.
  • azd infra: Manage your Infrastructure as Code (IaC).
  • azd init: Initialize a new application.
  • azd mcp: Manage Model Context Protocol (MCP) server. (Alpha)
  • azd monitor: Monitor a deployed project.
  • azd package: Packages the project's code to be deployed to Azure.
  • azd pipeline: Manage and configure your deployment pipelines.
  • azd provision: Provision Azure resources for your project.
  • azd publish: Publish a service to a container registry.
  • azd restore: Restores the project's dependencies.
  • azd show: Display information about your project and its resources.
  • azd template: Find and view template details.
  • azd up: Provision and deploy your project to Azure with a single command.
  • azd version: Print the version number of Azure Developer CLI.

azd add

Add a component to your project.

azd add [flags] 

Options

 --docs Opens the documentation for azd add in your web browser. -h, --help Gets help for add. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd auth

Authenticate with Azure.

Options

 --docs Opens the documentation for azd auth in your web browser. -h, --help Gets help for auth. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd auth login

Log in to Azure.

Synopsis

Log in to Azure.

When run without any arguments, log in interactively using a browser. To log in using a device code, pass --use-device-code.

To log in as a service principal, pass --client-id and --tenant-id as well as one of: --client-secret, --client-certificate, or --federated-credential-provider.

To log in using a managed identity, pass --managed-identity, which will use the system assigned managed identity. To use a user assigned managed identity, pass --client-id in addition to --managed-identity with the client id of the user assigned managed identity you wish to use.

azd auth login [flags] 

Options

 --check-status Checks the log-in status instead of logging in. --client-certificate string The path to the client certificate for the service principal to authenticate with. --client-id string The client id for the service principal to authenticate with. --client-secret string The client secret for the service principal to authenticate with. Set to the empty string to read the value from the console. --docs Opens the documentation for azd auth login in your web browser. --federated-credential-provider string The provider to use to acquire a federated token to authenticate with. Supported values: github, azure-pipelines, oidc -h, --help Gets help for login. --managed-identity Use a managed identity to authenticate. --redirect-port int Choose the port to be used as part of the redirect URI during interactive login. --tenant-id string The tenant id or domain name to authenticate with. --use-device-code[=true] When true, log in by using a device code instead of a browser. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd auth logout

Log out of Azure.

Synopsis

Log out of Azure

azd auth logout [flags] 

Options

 --docs Opens the documentation for azd auth logout in your web browser. -h, --help Gets help for logout. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd completion

Generate shell completion scripts.

Synopsis

Generate shell completion scripts for azd.

The completion command allows you to generate autocompletion scripts for your shell, currently supports bash, zsh, fish and PowerShell.

See each sub-command's help for details on how to use the generated script.

Options

 --docs Opens the documentation for azd completion in your web browser. -h, --help Gets help for completion. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd completion bash

Generate bash completion script.

azd completion bash 

Options

 --docs Opens the documentation for azd completion bash in your web browser. -h, --help Gets help for bash. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd completion fish

Generate fish completion script.

azd completion fish 

Options

 --docs Opens the documentation for azd completion fish in your web browser. -h, --help Gets help for fish. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd completion powershell

Generate PowerShell completion script.

azd completion powershell 

Options

 --docs Opens the documentation for azd completion powershell in your web browser. -h, --help Gets help for powershell. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd completion zsh

Generate zsh completion script.

azd completion zsh 

Options

 --docs Opens the documentation for azd completion zsh in your web browser. -h, --help Gets help for zsh. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd config

Manage azd configurations (ex: default Azure subscription, location).

Synopsis

Manage the Azure Developer CLI user configuration, which includes your default Azure subscription and location.

Available since azure-dev-cli_0.4.0-beta.1.

The easiest way to configure azd for the first time is to run azd init. The subscription and location you select will be stored in the config.json file located in the config directory. To configure azd anytime afterwards, you'll use azd config set.

The default value of the config directory is:

  • $HOME/.azd on Linux and macOS
  • %USERPROFILE%.azd on Windows

The configuration directory can be overridden by specifying a path in the AZD_CONFIG_DIR environment variable.

Options

 --docs Opens the documentation for azd config in your web browser. -h, --help Gets help for config. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd config get

Gets a configuration.

Synopsis

Gets a configuration in the configuration path.

The default value of the config directory is:

  • $HOME/.azd on Linux and macOS
  • %USERPROFILE%\.azd on Windows

The configuration directory can be overridden by specifying a path in the AZD_CONFIG_DIR environment variable.

azd config get <path> [flags] 

Options

 --docs Opens the documentation for azd config get in your web browser. -h, --help Gets help for get. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd config list-alpha

Display the list of available features in alpha stage.

azd config list-alpha [flags] 

Options

 --docs Opens the documentation for azd config list-alpha in your web browser. -h, --help Gets help for list-alpha. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd config reset

Resets configuration to default.

Synopsis

Resets all configuration in the configuration path.

The default value of the config directory is:

  • $HOME/.azd on Linux and macOS
  • %USERPROFILE%\.azd on Windows

The configuration directory can be overridden by specifying a path in the AZD_CONFIG_DIR environment variable to the default.

azd config reset [flags] 

Options

 --docs Opens the documentation for azd config reset in your web browser. -f, --force Force reset without confirmation. -h, --help Gets help for reset. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd config set

Sets a configuration.

Synopsis

Sets a configuration in the configuration path.

The default value of the config directory is:

  • $HOME/.azd on Linux and macOS
  • %USERPROFILE%\.azd on Windows

The configuration directory can be overridden by specifying a path in the AZD_CONFIG_DIR environment variable.

azd config set <path> <value> [flags] 

Examples

azd config set defaults.subscription <yourSubscriptionID> azd config set defaults.location eastus 

Options

 --docs Opens the documentation for azd config set in your web browser. -h, --help Gets help for set. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd config show

Show all the configuration values.

Synopsis

Show all configuration values in the configuration path.

The default value of the config directory is:

  • $HOME/.azd on Linux and macOS
  • %USERPROFILE%\.azd on Windows

The configuration directory can be overridden by specifying a path in the AZD_CONFIG_DIR environment variable.

azd config show [flags] 

Options

 --docs Opens the documentation for azd config show in your web browser. -h, --help Gets help for show. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd config unset

Unsets a configuration.

Synopsis

Removes a configuration in the configuration path.

The default value of the config directory is:

  • $HOME/.azd on Linux and macOS
  • %USERPROFILE%\.azd on Windows

The configuration directory can be overridden by specifying a path in the AZD_CONFIG_DIR environment variable.

azd config unset <path> [flags] 

Examples

azd config unset defaults.location 

Options

 --docs Opens the documentation for azd config unset in your web browser. -h, --help Gets help for unset. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd deploy

Deploy your project code to Azure.

azd deploy <service> [flags] 

Options

 --all Deploys all services that are listed in azure.yaml --docs Opens the documentation for azd deploy in your web browser. -e, --environment string The name of the environment to use. --from-package string Deploys the packaged service located at the provided path. Supports zipped file packages (file path) or container images (image tag). -h, --help Gets help for deploy. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd down

Delete your project's Azure resources.

azd down [flags] 

Options

 --docs Opens the documentation for azd down in your web browser. -e, --environment string The name of the environment to use. --force Does not require confirmation before it deletes resources. -h, --help Gets help for down. --purge Does not require confirmation before it permanently deletes resources that are soft-deleted by default (for example, key vaults). 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd env

Manage environments (ex: default environment, environment variables).

Options

 --docs Opens the documentation for azd env in your web browser. -h, --help Gets help for env. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd env get-value

Get specific environment value.

azd env get-value <keyName> [flags] 

Options

 --docs Opens the documentation for azd env get-value in your web browser. -e, --environment string The name of the environment to use. -h, --help Gets help for get-value. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

  • azd env: Manage environments (ex: default environment, environment variables).
  • Back to top

azd env get-values

Get all environment values.

azd env get-values [flags] 

Options

 --docs Opens the documentation for azd env get-values in your web browser. -e, --environment string The name of the environment to use. -h, --help Gets help for get-values. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

  • azd env: Manage environments (ex: default environment, environment variables).
  • Back to top

azd env list

List environments.

azd env list [flags] 

Options

 --docs Opens the documentation for azd env list in your web browser. -h, --help Gets help for list. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

  • azd env: Manage environments (ex: default environment, environment variables).
  • Back to top

azd env new

Create a new environment and set it as the default.

azd env new <environment> [flags] 

Options

 --docs Opens the documentation for azd env new in your web browser. -h, --help Gets help for new. -l, --location string Azure location for the new environment --subscription string Name or ID of an Azure subscription to use for the new environment 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

  • azd env: Manage environments (ex: default environment, environment variables).
  • Back to top

azd env refresh

Refresh environment values by using information from a previous infrastructure provision.

azd env refresh <environment> [flags] 

Options

 --docs Opens the documentation for azd env refresh in your web browser. -e, --environment string The name of the environment to use. -h, --help Gets help for refresh. --hint string Hint to help identify the environment to refresh 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

  • azd env: Manage environments (ex: default environment, environment variables).
  • Back to top

azd env select

Set the default environment.

azd env select <environment> [flags] 

Options

 --docs Opens the documentation for azd env select in your web browser. -h, --help Gets help for select. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

  • azd env: Manage environments (ex: default environment, environment variables).
  • Back to top

azd env set

Set one or more environment values.

Synopsis

Set one or more environment values using key-value pairs or by loading from a .env formatted file.

azd env set [<key> <value>] | [<key>=<value> ...] | [--file <filepath>] [flags] 

Options

 --docs Opens the documentation for azd env set in your web browser. -e, --environment string The name of the environment to use. --file string Path to .env formatted file to load environment values from. -h, --help Gets help for set. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

  • azd env: Manage environments (ex: default environment, environment variables).
  • Back to top

azd env set-secret

Set a name as a reference to a Key Vault secret in the environment.

Synopsis

You can either create a new Key Vault secret or select an existing one. The provided name is the key for the .env file which holds the secret reference to the Key Vault secret.

azd env set-secret <name> [flags] 

Options

 --docs Opens the documentation for azd env set-secret in your web browser. -e, --environment string The name of the environment to use. -h, --help Gets help for set-secret. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

  • azd env: Manage environments (ex: default environment, environment variables).
  • Back to top

azd extension

Manage azd extensions.

Options

 --docs Opens the documentation for azd extension in your web browser. -h, --help Gets help for extension. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd extension install

Installs specified extensions.

azd extension install <extension-name> [flags] 

Options

 --docs Opens the documentation for azd extension install in your web browser. -f, --force Force installation even if it would downgrade the current version -h, --help Gets help for install. -s, --source string The extension source to use for installs -v, --version string The version of the extension to install 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd extension list

List available extensions.

azd extension list [--installed] [flags] 

Options

 --docs Opens the documentation for azd extension list in your web browser. -h, --help Gets help for list. --installed List installed extensions --source string Filter extensions by source --tags strings Filter extensions by tags 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd extension show

Show details for a specific extension.

azd extension show <extension-name> [flags] 

Options

 --docs Opens the documentation for azd extension show in your web browser. -h, --help Gets help for show. -s, --source string The extension source to use. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd extension source

View and manage extension sources

Options

 --docs Opens the documentation for azd extension source in your web browser. -h, --help Gets help for source. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd extension source add

Add an extension source with the specified name

azd extension source add [flags] 

Options

 --docs Opens the documentation for azd extension source add in your web browser. -h, --help Gets help for add. -l, --location string The location of the extension source -n, --name string The name of the extension source -t, --type string The type of the extension source. Supported types are 'file' and 'url' 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd extension source list

List extension sources

azd extension source list [flags] 

Options

 --docs Opens the documentation for azd extension source list in your web browser. -h, --help Gets help for list. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd extension source remove

Remove an extension source with the specified name

azd extension source remove <name> [flags] 

Options

 --docs Opens the documentation for azd extension source remove in your web browser. -h, --help Gets help for remove. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd extension uninstall

Uninstall specified extensions.

azd extension uninstall <extension-name> [flags] 

Options

 --all Uninstall all installed extensions --docs Opens the documentation for azd extension uninstall in your web browser. -h, --help Gets help for uninstall. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd extension upgrade

Upgrade specified extensions.

azd extension upgrade <extension-name> [flags] 

Options

 --all Upgrade all installed extensions --docs Opens the documentation for azd extension upgrade in your web browser. -h, --help Gets help for upgrade. -s, --source string The extension source to use for upgrades -v, --version string The version of the extension to upgrade to 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd hooks

Develop, test and run hooks for a project.

Options

 --docs Opens the documentation for azd hooks in your web browser. -h, --help Gets help for hooks. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd hooks run

Runs the specified hook for the project and services

azd hooks run <name> [flags] 

Options

 --docs Opens the documentation for azd hooks run in your web browser. -e, --environment string The name of the environment to use. -h, --help Gets help for run. --platform string Forces hooks to run for the specified platform. --service string Only runs hooks for the specified service. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd infra

Manage your Infrastructure as Code (IaC).

Options

 --docs Opens the documentation for azd infra in your web browser. -h, --help Gets help for infra. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd infra generate

Write IaC for your project to disk, allowing you to manually manage it.

azd infra generate [flags] 

Options

 --docs Opens the documentation for azd infra generate in your web browser. -e, --environment string The name of the environment to use. --force Overwrite any existing files without prompting -h, --help Gets help for generate. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd init

Initialize a new application.

azd init [flags] 

Options

 -b, --branch string The template branch to initialize from. Must be used with a template argument (--template or -t). --docs Opens the documentation for azd init in your web browser. -e, --environment string The name of the environment to use. -f, --filter strings The tag(s) used to filter template results. Supports comma-separated values. --from-code Initializes a new application from your existing code. -h, --help Gets help for init. -l, --location string Azure location for the new environment -m, --minimal Initializes a minimal project. -s, --subscription string Name or ID of an Azure subscription to use for the new environment -t, --template string Initializes a new application from a template. You can use Full URI, <owner>/<repository>, or <repository> if it's part of the azure-samples organization. --up Provision and deploy to Azure after initializing the project from a template. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd mcp

Manage Model Context Protocol (MCP) server. (Alpha)

Options

 --docs Opens the documentation for azd mcp in your web browser. -h, --help Gets help for mcp. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

Manage MCP tool consent.

Synopsis

Manage consent rules for MCP tool execution.

Options

 --docs Opens the documentation for azd mcp consent in your web browser. -h, --help Gets help for consent. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

Grant consent trust rules.

Synopsis

Grant trust rules for MCP tools and servers.

This command creates consent rules that allow MCP tools to execute without prompting for permission. You can specify different permission levels and scopes for the rules.

azd mcp consent grant [flags] 

Examples:

Grant always permission to all tools globally:

azd mcp consent grant --global --permission always 

Grant project permission to a specific tool with read-only scope:

azd mcp consent grant --server my-server --tool my-tool --permission project --scope read-only 

Options

 --action string Action type: 'all' or 'readonly' (default "all") --docs Opens the documentation for azd mcp consent grant in your web browser. --global Apply globally to all servers -h, --help Gets help for grant. --operation string Operation type: 'tool' or 'sampling' (default "tool") --permission string Permission: 'allow', 'deny', or 'prompt' (default "allow") --scope string Rule scope: 'global', or 'project' (default "global") --server string Server name --tool string Specific tool name (requires --server) 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

List consent rules.

Synopsis

List all consent rules for MCP tools.

azd mcp consent list [flags] 

Options

 --action string Action type to filter by (readonly, any) --docs Opens the documentation for azd mcp consent list in your web browser. -h, --help Gets help for list. --operation string Operation to filter by (tool, sampling) --permission string Permission to filter by (allow, deny, prompt) --scope string Consent scope to filter by (global, project). If not specified, lists rules from all scopes. --target string Specific target to operate on (server/tool format) 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

Revoke consent rules.

Synopsis

Revoke consent rules for MCP tools.

azd mcp consent revoke [flags] 

Options

 --action string Action type to filter by (readonly, any) --docs Opens the documentation for azd mcp consent revoke in your web browser. -h, --help Gets help for revoke. --operation string Operation to filter by (tool, sampling) --permission string Permission to filter by (allow, deny, prompt) --scope string Consent scope to filter by (global, project). If not specified, revokes rules from all scopes. --target string Specific target to operate on (server/tool format) 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd mcp start

Starts the MCP server.

Synopsis

Starts the Model Context Protocol (MCP) server.

This command starts an MCP server that can be used by MCP clients to access azd functionality through the Model Context Protocol interface.

azd mcp start [flags] 

Options

 --docs Opens the documentation for azd mcp start in your web browser. -h, --help Gets help for start. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd monitor

Monitor a deployed project.

azd monitor [flags] 

Options

 --docs Opens the documentation for azd monitor in your web browser. -e, --environment string The name of the environment to use. -h, --help Gets help for monitor. --live Open a browser to Application Insights Live Metrics. Live Metrics is currently not supported for Python apps. --logs Open a browser to Application Insights Logs. --overview Open a browser to Application Insights Overview Dashboard. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd package

Packages the project's code to be deployed to Azure.

azd package <service> [flags] 

Options

 --all Packages all services that are listed in azure.yaml --docs Opens the documentation for azd package in your web browser. -e, --environment string The name of the environment to use. -h, --help Gets help for package. --output-path string File or folder path where the generated packages will be saved. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd pipeline

Manage and configure your deployment pipelines.

Options

 --docs Opens the documentation for azd pipeline in your web browser. -h, --help Gets help for pipeline. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd pipeline config

Configure your deployment pipeline to connect securely to Azure. (Beta)

azd pipeline config [flags] 

Options

 -m, --applicationServiceManagementReference string Service Management Reference. References application or service contact information from a Service or Asset Management database. This value must be a Universally Unique Identifier (UUID). You can set this value globally by running azd config set pipeline.config.applicationServiceManagementReference <UUID>. --auth-type string The authentication type used between the pipeline provider and Azure for deployment (Only valid for GitHub provider). Valid values: federated, client-credentials. --docs Opens the documentation for azd pipeline config in your web browser. -e, --environment string The name of the environment to use. -h, --help Gets help for config. --principal-id string The client id of the service principal to use to grant access to Azure resources as part of the pipeline. --principal-name string The name of the service principal to use to grant access to Azure resources as part of the pipeline. --principal-role stringArray The roles to assign to the service principal. By default the service principal will be granted the Contributor and User Access Administrator roles. (default [Contributor,User Access Administrator]) --provider string The pipeline provider to use (github for Github Actions and azdo for Azure Pipelines). --remote-name string The name of the git remote to configure the pipeline to run on. (default "origin") 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd provision

Provision Azure resources for your project.

azd provision [flags] 

Options

 --docs Opens the documentation for azd provision in your web browser. -e, --environment string The name of the environment to use. -h, --help Gets help for provision. --no-state (Bicep only) Forces a fresh deployment based on current Bicep template files, ignoring any stored deployment state. --preview Preview changes to Azure resources. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd publish

Publish a service to a container registry.

azd publish <service> [flags] 

Options

 --all Publishes all services that are listed in azure.yaml --docs Opens the documentation for azd publish in your web browser. -e, --environment string The name of the environment to use. --from-package string Publishes the service from a container image (image tag). -h, --help Gets help for publish. --to string The target container image in the form '[registry/]repository[:tag]' to publish to. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd restore

Restores the project's dependencies.

azd restore <service> [flags] 

Options

 --all Restores all services that are listed in azure.yaml --docs Opens the documentation for azd restore in your web browser. -e, --environment string The name of the environment to use. -h, --help Gets help for restore. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd show

Display information about your project and its resources.

azd show [resource name or ID] [flags] 

Options

 --docs Opens the documentation for azd show in your web browser. -e, --environment string The name of the environment to use. -h, --help Gets help for show. --show-secrets Unmask secrets in output. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd template

Find and view template details.

Options

 --docs Opens the documentation for azd template in your web browser. -h, --help Gets help for template. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd template list

Show list of sample azd templates. (Beta)

azd template list [flags] 

Options

 --docs Opens the documentation for azd template list in your web browser. -f, --filter strings The tag(s) used to filter template results. Supports comma-separated values. -h, --help Gets help for list. -s, --source string Filters templates by source. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd template show

Show details for a given template. (Beta)

azd template show <template> [flags] 

Options

 --docs Opens the documentation for azd template show in your web browser. -h, --help Gets help for show. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd template source

View and manage template sources. (Beta)

Options

 --docs Opens the documentation for azd template source in your web browser. -h, --help Gets help for source. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd template source add

Adds an azd template source with the specified key. (Beta)

Synopsis

The key can be any value that uniquely identifies the template source, with well-known values being: ・default: Default templates ・awesome-azd: Templates from https://aka.ms/awesome-azd

azd template source add <key> [flags] 

Options

 --docs Opens the documentation for azd template source add in your web browser. -h, --help Gets help for add. -l, --location string Location of the template source. Required when using type flag. -n, --name string Display name of the template source. -t, --type string Kind of the template source. Supported types are 'file', 'url' and 'gh'. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd template source list

Lists the configured azd template sources. (Beta)

azd template source list [flags] 

Options

 --docs Opens the documentation for azd template source list in your web browser. -h, --help Gets help for list. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd template source remove

Removes the specified azd template source (Beta)

azd template source remove <key> [flags] 

Options

 --docs Opens the documentation for azd template source remove in your web browser. -h, --help Gets help for remove. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd up

Provision and deploy your project to Azure with a single command.

azd up [flags] 

Options

 --docs Opens the documentation for azd up in your web browser. -e, --environment string The name of the environment to use. -h, --help Gets help for up. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also

azd version

Print the version number of Azure Developer CLI.

azd version [flags] 

Options

 --docs Opens the documentation for azd version in your web browser. -h, --help Gets help for version. 

Options inherited from parent commands

 -C, --cwd string Sets the current working directory. --debug Enables debugging and diagnostics logging. --no-prompt Accepts the default value instead of prompting, or it fails if there is no default. 

See also