az scvmm vm nic
Note
This reference is part of the scvmm extension for the Azure CLI (version 2.15.0 or higher). The extension will automatically install the first time you run an az scvmm vm nic command. Learn more about extensions.
Managing the NICs of Arc for SCVMM Virtual Machine.
Commands
Name | Description | Type | Status |
---|---|---|---|
az scvmm vm nic add |
Add a network interface card to a virtual machine. |
Extension | GA |
az scvmm vm nic delete |
Delete NICs of a virtual machine. |
Extension | GA |
az scvmm vm nic list |
Retrieve the list of NICs present in a VM. |
Extension | GA |
az scvmm vm nic show |
Get the details of a NIC present in a VM. |
Extension | GA |
az scvmm vm nic update |
Update a NIC of a VM. |
Extension | GA |
az scvmm vm nic wait |
Place the CLI in a waiting state until a condition of the vm nic is met. |
Extension | GA |
az scvmm vm nic add
Add a network interface card to a virtual machine.
az scvmm vm nic add --name
--resource-group
--vm-name
[--ipv4-address-type {Dynamic, Static}]
[--ipv6-address-type {Dynamic, Static}]
[--mac-address]
[--mac-address-type {Dynamic, Static}]
[--network]
[--no-wait]
Examples
Add a NIC to a virtual machine
az scvmm vm nic add --subscription contoso-sub --resource-group contoso-rg --vm-name contoso-vm --name nic_1 --network contoso-vnet --ipv4-address-type Dynamic --mac-address-type Dynamic
Required Parameters
Name of the NIC.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name of the virtual machine.
Optional Parameters
The allocation type of the ipv4 address.
The allocation type of the ipv6 address.
MAC address of the NIC.
The allocation type of the MAC address.
Name or Id of the virtual network.
Do not wait for the long-running operation to finish.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az scvmm vm nic delete
Delete NICs of a virtual machine.
az scvmm vm nic delete --nics
--resource-group
--vm-name
[--no-wait]
[--yes]
Examples
Delete NICs of a virtual machine
az scvmm vm nic delete --subscription contoso-sub --resource-group contoso-rg --vm-name contoso-vm --nics nic_1 nic_2
Required Parameters
Names of the NICs.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name of the virtual machine.
Optional Parameters
Do not wait for the long-running operation to finish.
Do not prompt for confirmation.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az scvmm vm nic list
Retrieve the list of NICs present in a VM.
az scvmm vm nic list --resource-group
--vm-name
Examples
Retrieve the list of NICs present in a VM
az scvmm vm nic list --subscription contoso-sub --resource-group contoso-rg --vm-name contoso-vm
Required Parameters
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name of the virtual machine.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az scvmm vm nic show
Get the details of a NIC present in a VM.
az scvmm vm nic show --name
--resource-group
--vm-name
Examples
Get details of vm NIC
az scvmm vm nic show --subscription contoso-sub --resource-group contoso-rg --vm-name contoso-vm --name nic_1
Required Parameters
Name of the NIC.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name of the virtual machine.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az scvmm vm nic update
Update a NIC of a VM.
az scvmm vm nic update --resource-group
--vm-name
[--disconnect {false, true}]
[--ipv4-address-type {Dynamic, Static}]
[--ipv6-address-type {Dynamic, Static}]
[--mac-address-type {Dynamic, Static}]
[--name]
[--network]
[--nic-id]
[--no-wait]
Examples
Update a NIC of a VM
az scvmm vm nic update --subscription contoso-sub --resource-group contoso-rg --vm-name contoso-vm --name nic_1 --network contoso-vnet --ipv4-address-type Dynamic --mac-address-type Dynamic
Required Parameters
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name of the virtual machine.
Optional Parameters
Disconnect the NIC from any virtual network it is connected to.
The allocation type of the ipv4 address.
The allocation type of the ipv6 address.
The allocation type of the MAC address.
Name of the NIC.
Name or Id of the virtual network.
UUID of the NIC.
Do not wait for the long-running operation to finish.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az scvmm vm nic wait
Place the CLI in a waiting state until a condition of the vm nic is met.
az scvmm vm nic wait --resource-group
--virtual-machine-name
[--created]
[--custom]
[--deleted]
[--exists]
[--interval]
[--timeout]
[--updated]
Required Parameters
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name of the VirtualMachine.
Optional Parameters
Wait until created with 'provisioningState' at 'Succeeded'.
Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Wait until deleted.
Wait until the resource exists.
Polling interval in seconds.
Maximum wait in seconds.
Wait until updated with provisioningState at 'Succeeded'.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.