Command Sub-groups No Longer Appear #2830
Description
Environment summary
Install Method: How did you install the CLI? (e.g. pip, interactive script, apt-get, Docker, MSI, nightly)
Answer here: dev_setup.py
CLI Version: What version of the CLI and modules are installed? (Use az --version)
Answer here: latest master
OS Version: What OS and version are you using?
Answer here: Windows 10
Shell Type: What shell are you using? (e.g. bash, cmd.exe, Bash on Windows)
Answer here: cmd.exe
Description
PR #2819 caused a regression to the way help is displayed. Prior to the change, az vm -h looked like:
Group
az vm: Provision Linux or Windows virtual machines in seconds.
Subgroups:
availability-set : Group resources into availability sets for high-availability
requirements.
boot-diagnostics : Troubleshoot the start up of an Azure Virtual Machine.
diagnostics : Configure the Azure Virtual Machine diagnostics extension.
disk : Manage the managed data disks attached to a VM.
encryption : Manage encryption of VM disks.
extension : Extend the functionality of your VMs with extensions.
image : Virtual machine images that are available in the Azure Marketplace.
nic : Manage network interfaces, see also 'az network nic'.
unmanaged-disk : Manage the unmanaged data disks attached to a VM.
user : Manage a user account on a VM.
Commands:
capture : Captures the VM by copying virtual hard disks of the VM and outputs a
template that can be used to create similar VMs.
convert : Convert a VM with unmanaged disks to use managed disks.
create : Create an Azure Virtual Machine.
deallocate : Shuts down the virtual machine and releases the compute resources.
delete : The operation to delete a virtual machine.
format-secret : Format secrets to be used in `az vm create --secrets`.
generalize : Sets the state of the virtual machine to generalized.
get-instance-view : Get information about a VM including instance information (powerState).
list : List information about Virtual Machines.
list-ip-addresses : Get IP addresses from one or more Virtual Machines.
list-sizes : Lists all available virtual machine sizes for a subscription in a
location.
list-usage : Gets, for the specified location, the current compute resource usage
information as well as the limits for compute resources under the
subscription.
list-vm-resize-options: Lists all available virtual machine sizes to which the specified virtual
machine can be resized.
open-port : Opens a VM to inbound traffic on specified ports by adding a security
rule to the network security group (NSG) that is attached to the VM's
network interface (NIC) or subnet.
redeploy : The operation to redeploy a virtual machine.
resize : Update VM size.
restart : The operation to restart a virtual machine.
show : Show details of a VM.
start : The operation to start a virtual machine.
stop : The operation to power off (stop) a virtual machine.
update : Update the properties of a VM.
wait : Place the CLI in a waiting state until a condition of the VM is met.
Now it appears with all of the subgroups mixed together with the commands:
Group
az vm: Provision Linux or Windows virtual machines in seconds.
Commands:
availability-set : Group resources into availability sets for high-availability
requirements.
boot-diagnostics : Troubleshoot the start up of an Azure Virtual Machine.
capture : Captures the VM by copying virtual hard disks of the VM and outputs a
template that can be used to create similar VMs.
convert : Convert a VM with unmanaged disks to use managed disks.
create : Create an Azure Virtual Machine.
deallocate : Shuts down the virtual machine and releases the compute resources.
delete : The operation to delete a virtual machine.
diagnostics : Configure the Azure Virtual Machine diagnostics extension.
disk : Manage the managed data disks attached to a VM.
encryption : Manage encryption of VM disks.
extension : Extend the functionality of your VMs with extensions.
format-secret : Format secrets to be used in `az vm create --secrets`.
generalize : Sets the state of the virtual machine to generalized.
get-instance-view : Get information about a VM including instance information (powerState).
image : Virtual machine images that are available in the Azure Marketplace.
list : List information about Virtual Machines.
list-ip-addresses : Get IP addresses from one or more Virtual Machines.
list-sizes : Lists all available virtual machine sizes for a subscription in a
location.
list-usage : Gets, for the specified location, the current compute resource usage
information as well as the limits for compute resources under the
subscription.
list-vm-resize-options: Lists all available virtual machine sizes to which the specified virtual
machine can be resized.
nic : Manage network interfaces, see also 'az network nic'.
open-port : Opens a VM to inbound traffic on specified ports by adding a security
rule to the network security group (NSG) that is attached to the VM's
network interface (NIC) or subnet.
redeploy : The operation to redeploy a virtual machine.
resize : Update VM size.
restart : The operation to restart a virtual machine.
show : Show details of a VM.
start : The operation to start a virtual machine.
stop : The operation to power off (stop) a virtual machine.
unmanaged-disk : Manage the unmanaged data disks attached to a VM.
update : Update the properties of a VM.
user : Manage a user account on a VM.
wait : Place the CLI in a waiting state until a condition of the VM is met.