Important
Public preview Next-Generation Azure CLI & Azure PowerShell is in public preview. Commands, behavior, and packaging may change during the preview. See Known limitations before getting started.
Next-Generation Azure CLI & Azure PowerShell provides a lightweight, efficient and intelligent set of commands to manage Azure resources. Depending on preferences, scripting environment or other requirements, you can use the native command or its PowerShell equivalent to obtain identical outcomes.
The architecture used for these commands allows execution in secure, constrained environments and provides faster execution or a smaller disk footprint.
Preview capabilities (What's new)
- Profile-based login — sign in and manage which subscription and context your commands run against.
- Per-command subscription selection — specify a different subscription on commands that expose
--subscription-id(CLI) or-SubscriptionId(PowerShell). - Faster tab completion — press Tab to complete command groups, subcommands, and parameters, resolved against the installed CLI.
- AI-assisted error recovery — when a command fails, an integrated AI model explains what went wrong and suggests a guided fix. See AI-based error recovery.
Plus the basics: install, az --help, az --version and az config.
- Install — follow the Azure CLI install overview or the Azure PowerShell install overview for Windows, Linux, and macOS. Packages ship via GitHub Releases. Scripted and manual download options are documented in the install guides. The PowerShell modules require PowerShell 7.6+.
- Verify — for the CLI, follow the install guide's session
PATHinstructions, then runaz --versionto check the preview build rather than an existing classic CLI installation. If you choose the full-path option instead, invoke the preview executable by full path with--versionand use that full path for the CLI commands below. For PowerShell, follow the install guide's module verification steps. - Sign in — run
az loginfor the CLI orConnect-AzAccountfor PowerShell. - Explore supported commands
- CLI:
config,deployment,disk,extension,group,login,logout,profile,rest, andvm - PowerShell: Accounts, Resources, Compute, and Config
- Use
az --helpandGet-Command -Module Az.*to explore installed commands. - Additional commands will continue to be added in regular updates.
- CLI:
azinstalls side-by-side with the classicazure-cliand does not modify yourPATHby default. See the install overview for PATH and offline options.
Profile-based login — sign in, save a named profile, and switch between them:
az login --subscription-id <id> --out-profile prod # save a named profile
az profile list # list profiles
az profile set prod # switch the active profileTab completion — type a partial command and press Tab:
az pro<Tab> # completes to: az profileEnable it for bash, zsh, or PowerShell — see tab completion.
AI-powered error recovery — when a command fails, the AI explains the cause and suggests a fix:
az profile set does-not-exist
# → what went wrong, a suggested plan / next actions, and values to review.Start here, then follow the pointers into ./docs.
Install
- Install overview
- Manual / offline install
- Add-on CLI extensions
- Tab completion
- Azure PowerShell install overview
- Azure PowerShell modules
Azure CLI
Azure PowerShell
- Overview — getting-started guide in progress
Documentation is being consolidated during the preview, so paths may change.
This is a public preview — expect rough edges and change between builds.
- The preview focuses on interactive user scenarios. Non-interactive auth methods — Resource Owner Password Credentials (ROPC), service principals, and managed identities — aren't supported yet.
- Supported shells are PowerShell 7.6+, bash, and zsh. Windows PowerShell 5.1 and the PowerShell ISE aren't supported.
- Next-Generation Azure CLI & Azure PowerShell installs side-by-side and doesn't replace your existing Azure CLI or Azure PowerShell — you can roll back at any time.
- Commands, behavior, and packaging may change without notice during the preview.
For known issues and workarounds, see Troubleshooting.
Please share early and often.
- GitHub Issues — primary channel for bugs, install problems, doc gaps, command issues, and feature requests (templates provided).
- Support — how to get help and what to expect during the preview.
For security vulnerabilities, follow the Security Policy instead of opening a public issue.
Never include secrets, tokens, customer data, tenant IDs, or subscription IDs in feedback.
azclips/
├── Agent/ # Agent host, chat/agent-mode entry, hooks, and tools
├── build/ # Build scripts (build.ps1, module staging, help gen)
├── devops/ # DevOps helper scripts
├── docs/ # Documentation (getting-started & reference), being consolidated
│ ├── azure-cli/ # Azure CLI conceptual & reference docs
│ ├── azure-powershell/ # Azure PowerShell conceptual & reference docs
│ ├── howto/ # Task-focused guides (build, config, help, ...)
│ └── spec/ # Technical specifications
├── install/ # Single-command install for all platforms/architectures
│ └── docs/ # Manual/offline install, extensions, completions, PS modules
├── openspec/ # OpenSpec change proposals and specs
├── src/ # Product source code
│ ├── CLI/ # CLI entry point (produces the 'az' binary)
│ ├── Core/ # Core framework libraries
│ ├── Extensions/ # Extension modules
│ └── PS/ # PowerShell modules and manifests
├── tests/ # xUnit test projects and fixtures
├── toolkit/ # TypeScript toolkit packages
├── tools/ # Repository tooling (help generation, ...)
├── TUI/ # Terminal UI app
├── wiki/ # Rendered documentation site (npm run preview)
├── azclips.slnx # Main solution file
├── global.json # Pinned .NET SDK version
├── AGENTS.md # Repository guidelines
├── CHANGELOG.md # Version history
├── CONTRIBUTING.md # Contribution guidelines
└── LICENSE # MIT license
- License — MIT. (Open-source review in progress.)
- Support — SUPPORT.md
- Code of Conduct — CODE_OF_CONDUCT.md
- Security Policy — SECURITY.md
- Privacy & telemetry — the preview collects limited telemetry with your consent (command names, parameter names only, success/failure, and basic environment data — never parameter values, URLs, or personal content). Telemetry is on by default; opt out with
az config set --key telemetry.enabled --value false(Azure PowerShell equivalent:Set-AzConfig -Key telemetry.enabled -Value false). See Configuration Management.
The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft's privacy statement. Our privacy statement is located at https://go.microsoft.com/fwlink/?LinkID=824704. You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.
This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos is subject to those third-party policies.