az stack-hci-vm

Note

This reference is part of the stack-hci-vm extension for the Azure CLI (version 2.15.0 or higher). The extension will automatically install the first time you run an az stack-hci-vm command. Learn more about extensions.

This command group is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Manage virtualmachine with stack-hci-vm.

Commands

Name	Description	Type	Status
az stack-hci-vm create	Create a VM.	Extension	Experimental
az stack-hci-vm delete	Delete a VM.	Extension	Experimental
az stack-hci-vm disk	Manage virtualharddisk with stack-hci-vm.	Extension	Experimental
az stack-hci-vm disk attach	Attach disk to a VM.	Extension	Experimental
az stack-hci-vm disk create	Create a virtual hard disk.	Extension	Experimental
az stack-hci-vm disk delete	Delete a virtual hard disk.	Extension	Experimental
az stack-hci-vm disk detach	Detach disk from a VM.	Extension	Experimental
az stack-hci-vm disk list	List all virtual hard disks.	Extension	Experimental
az stack-hci-vm disk show	Get the details of a virtual hard disk.	Extension	Experimental
az stack-hci-vm disk update	Update a virtual hard disk.	Extension	Experimental
az stack-hci-vm image	Manage images with stack-hci-vm.	Extension	Experimental
az stack-hci-vm image create	Create a gallery image.	Extension	Experimental
az stack-hci-vm image delete	Delete an image.	Extension	Experimental
az stack-hci-vm image list	List all gallery images.	Extension	Experimental
az stack-hci-vm image show	Get the details of an image.	Extension	Experimental
az stack-hci-vm image update	Update an image.	Extension	Experimental
az stack-hci-vm list	List all the VMs.	Extension	Experimental
az stack-hci-vm network	Manage network with stack-hvi-vm.	Extension	Experimental
az stack-hci-vm network lnet	Manage logicalnetworks with stack-hci-vm.	Extension	Experimental
az stack-hci-vm network lnet create	Create a logical network.	Extension	Experimental
az stack-hci-vm network lnet delete	Delete a logical network.	Extension	Experimental
az stack-hci-vm network lnet list	List all the logical networks.	Extension	Experimental
az stack-hci-vm network lnet show	Get the details of a logical network.	Extension	Experimental
az stack-hci-vm network lnet update	Update a logical network.	Extension	Experimental
az stack-hci-vm network nic	Manage networkinterface with stack-hci-vm.	Extension	Experimental
az stack-hci-vm network nic create	Create a network interface.	Extension	Experimental
az stack-hci-vm network nic delete	Delete a network interface.	Extension	Experimental
az stack-hci-vm network nic list	List all network interfaces.	Extension	Experimental
az stack-hci-vm network nic show	Get the details of a network interface.	Extension	Experimental
az stack-hci-vm network nic update	Update a network interface.	Extension	Experimental
az stack-hci-vm nic	Manage vNIC of a virtual machine with stack-hci-vm.	Extension	Experimental
az stack-hci-vm nic add	Add existing vNICs to a VM.	Extension	Experimental
az stack-hci-vm nic remove	Remove vNICs from a VM.	Extension	Experimental
az stack-hci-vm restart	Restart a VM.	Extension	Experimental
az stack-hci-vm show	Get the details of a VM.	Extension	Experimental
az stack-hci-vm start	Start a stopped VM.	Extension	Experimental
az stack-hci-vm stop	Power off (stop) a running VM.	Extension	Experimental
az stack-hci-vm storagepath	Manage storagepath with stack-hci-vm.	Extension	Experimental
az stack-hci-vm storagepath create	Create a storage path.	Extension	Experimental
az stack-hci-vm storagepath delete	Delete a storage path.	Extension	Experimental
az stack-hci-vm storagepath list	List all the storage paths.	Extension	Experimental
az stack-hci-vm storagepath show	Get the details of a storage path.	Extension	Experimental
az stack-hci-vm storagepath update	Update a storage path.	Extension	Experimental
az stack-hci-vm update	Update a VM.	Extension	Experimental

az stack-hci-vm create

Experimental

Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Create a VM.

az stack-hci-vm create --custom-location
                       --name
                       --resource-group
                       [--admin-password]
                       [--admin-username]
                       [--attach-data-disks]
                       [--authentication-type {all, password, ssh}]
                       [--computer-name]
                       [--enable-agent {false, true}]
                       [--enable-secure-boot {false, true}]
                       [--enable-vm-config-agent {false, true}]
                       [--enable-vtpm {false, true}]
                       [--image]
                       [--location]
                       [--nics]
                       [--os-disk-name]
                       [--os-type {linux, windows}]
                       [--polling-interval]
                       [--proxy-configuration]
                       [--security-type {ConfidentialVM, TrustedLaunch}]
                       [--size]
                       [--ssh-dest-key-path]
                       [--ssh-key-values]
                       [--storage-path-id]
                       [--tags]

Examples

Create a Stack HCI VM

az stack-hci-vm create --resource-group "test-rg" --custom-location "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocatio n/customLocations/dogfood-location" --location "West US2" --size "Default" --nics "test-nic" --computer-name "test-machine" --admin-username xxx --admin-password xxx --image "test-gallery-image" --storage-path-id "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/storagecontainers/test-storagepath" --name "test-vm" --authentication-type all --enable-agent true --ssh-key-values @key-file

Required Parameters

--custom-location

The ID of the extended location.

--name

Name of the virtual machine.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--admin-password

Password for the VM if authentication type is 'Password'.

--admin-username

Username for the VM.

--attach-data-disks

Attach existing data disks to the VM. Can use the name or ID of a managed disk.

--authentication-type

Type of authentication to use with the VM. Defaults to password for Windows and SSH public key for Linux. "all" enables both ssh and password authentication.

accepted values: all, password, ssh

--computer-name

Name of the Computer.

--enable-agent

Indicates whether virtual machine agent should be provisioned on the virtual machine. When this property is not specified, default behavior is to set it to true. This will ensure that VM Agent is installed on the VM so that extensions can be added to the VM later.

accepted values: false, true

--enable-secure-boot

Enable secure boot.

accepted values: false, true

--enable-vm-config-agent

Indicates whether virtual machine configuration agent should be provisioned on the virtual machine. When this property is not specified, default behavior is to set it to true.

accepted values: false, true

--enable-vtpm

Enable vtpm - Enable vTPM in security settings for the VMs. If the flag is not provided, default value is False.

Usage: --enable-vtpm=XX.

accepted values: false, true

default value: False

--image

Image - gallery image name the vm should use to provision.

--location -l

If location is not specified, the location of the resource group is used.

--nics

Names or IDs of existing NICs to attach to the VM.

--os-disk-name

Os Disk - name of the vhd the vm should use to provision.

--os-type

Type of OS installed on a custom VHD. Do not use when specifying an URN or URN alias.

accepted values: linux, windows

--polling-interval

ARM polling interval for long running operations.

--proxy-configuration

ProxyConfiguration - describes the proxy configuration for the virtual machine.

--security-type

Specifies the security type of the virtual machine.

accepted values: ConfidentialVM, TrustedLaunch

--size

The VM size to be created.

--ssh-dest-key-path

Destination file path on the VM for the SSH key.

--ssh-key-values

Space-separated list of SSH public keys or public key file paths.

--storage-path-id

Azure ID of the Storage Path pointing to the location where the VM config files are stored.

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az stack-hci-vm delete

Experimental

Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Delete a VM.

az stack-hci-vm delete [--ids]
                       [--name]
                       [--polling-interval]
                       [--resource-group]
                       [--subscription]
                       [--yes]

Examples

DeleteVirtualMachine

az stack-hci-vm delete --resource-group "test-rg" --name "test-vm"

Optional Parameters

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name

Name of the virtual machine.

--polling-interval

ARM polling interval for long running operations.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--yes -y

Do not prompt for confirmation.

default value: False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az stack-hci-vm list

Experimental

Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

List all the VMs.

az stack-hci-vm list [--resource-group]

Examples

ListVirtualMachineByResourceGroup

az stack-hci-vm list --resource-group "test-rg"

ListVirtualMachineBySubscription

az stack-hci-vm list

Optional Parameters

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az stack-hci-vm restart

Experimental

Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Restart a VM.

az stack-hci-vm restart [--ids]
                        [--name]
                        [--polling-interval]
                        [--resource-group]
                        [--subscription]

Examples

RestartVirtualMachine

az stack-hci-vm restart --resource-group "test-rg" --name "test-vm"

Optional Parameters

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name

Name of the virtual machine.

--polling-interval

ARM polling interval for long running operations.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az stack-hci-vm show

Experimental

Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Get the details of a VM.

az stack-hci-vm show [--ids]
                     [--name]
                     [--resource-group]
                     [--subscription]

Examples

GetVirtualMachine

az stack-hci-vm show --resource-group "test-rg" --name "test-vm"

Optional Parameters

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name

Name of the virtual machine.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az stack-hci-vm start

Experimental

Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Start a stopped VM.

az stack-hci-vm start [--ids]
                      [--name]
                      [--polling-interval]
                      [--resource-group]
                      [--subscription]

Examples

StartVirtualMachine

az stack-hci-vm start --resource-group "test-rg" --name "test-vm"

Optional Parameters

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name

Name of the virtual machine.

--polling-interval

ARM polling interval for long running operations.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az stack-hci-vm stop

Experimental

Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Power off (stop) a running VM.

az stack-hci-vm stop [--ids]
                     [--name]
                     [--polling-interval]
                     [--resource-group]
                     [--subscription]

Examples

StopVirtualMachine

az stack-hci-vm stop --resource-group "test-rg" --name "test-vm"

Optional Parameters

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name

Name of the virtual machine.

--polling-interval

ARM polling interval for long running operations.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az stack-hci-vm update

Experimental

Command group 'stack-hci-vm' is experimental and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Update a VM.

az stack-hci-vm update [--add]
                       [--computer-name]
                       [--enable-agent {false, true}]
                       [--enable-vm-config-agent {false, true}]
                       [--force-string]
                       [--ids]
                       [--memory-mb]
                       [--name]
                       [--nics]
                       [--polling-interval]
                       [--remove]
                       [--resource-group]
                       [--set]
                       [--subscription]
                       [--tags]
                       [--v-cpus-available]
                       [--vhds]

Examples

UpdateVirtualMachine

az stack-hci-vm update --resource-group "test-rg" --tags additionalProperties="sample" --name "test-vm" --v-cpus-available XX --memory-mb XX

Optional Parameters

--add

Add an object to a list of objects by specifying a path and key value pairs. Example: --add property.listProperty <key=value, string or JSON string>.

default value: []

--computer-name

Update the hostname of the VM.

--enable-agent

Indicates whether virtual machine agent should be provisioned on the virtual machine during virtual machine update. This will ensure that VM Agent is installed on the VM so that extensions can be added to the VM later.

accepted values: false, true

--enable-vm-config-agent

Indicates whether virtual machine configuration agent should be provisioned on the virtual machine during the virtual machine update .

accepted values: false, true

--force-string

When using 'set' or 'add', preserve string literals instead of attempting to convert to JSON.

default value: False

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--memory-mb

RAM in mb for the virtual machine.

--name

Name of the virtual machine.

--nics

List of vnic names.

--polling-interval

ARM polling interval for long running operations.

--remove

Remove a property or an element from a list. Example: --remove property.list <indexToRemove> OR --remove propertyToRemove.

default value: []

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--set

Update an object by specifying a property path and value to set. Example: --set property1.property2=<value>.

default value: []

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.

--v-cpus-available

Specify the number of vCPUs available.

--vhds

List of virtual hard disk names.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.