Remove-AzStackHCIVMVirtualMachineNetworkInterface
The operation to delete a network interface from a virtual machine.
Syntax
ByResourceId (Default)
Remove-AzStackHCIVMVirtualMachineNetworkInterface
-ResourceId <String>
[-NicId <String[]>]
[-NicName <String[]>]
[-NicResourceGroup <String>]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByName
Remove-AzStackHCIVMVirtualMachineNetworkInterface
-Name <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
[-NicId <String[]>]
[-NicName <String[]>]
[-NicResourceGroup <String>]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The operation to delete a network interface from a virtual machine.
Examples
Example 1: Removes a Network Interface from a Virtual Machine
Remove-AzStackHCIVMVirtualMachineNetworkInterface -Name "testVm" -ResourceGroupName "test-rg" -NicName 'testNic'
Name ResourceGroupName
---- -----------------
testVm test-rg
This command removes a network interface from the virtual machine in the specified resource group.
Parameters
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
Type: SwitchParameter
Default value: None Supports wildcards: False DontShow: False Aliases: cf
Parameter sets
(All)
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-Name
Name of the virtual machine
Parameter properties
Type: String
Default value: None Supports wildcards: False DontShow: False Aliases: VirtualMachineName
Parameter sets
ByName
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-NicId
NetworkInterfaces - list of network interfaces to be attached from the virtual machine in id format.
Parameter properties
Type: String [ ]
Default value: None Supports wildcards: False DontShow: False
Parameter sets
(All)
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-NicName
NetworkInterfaces - list of network interfaces to be removed from the virtual machine in name format.
Parameter properties
Type: String [ ]
Default value: None Supports wildcards: False DontShow: False
Parameter sets
(All)
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-NicResourceGroup
NetworkInterfaces - resource group of the network interfaces
Parameter properties
Type: String
Default value: None Supports wildcards: False DontShow: False
Parameter sets
(All)
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-NoWait
Run the command asynchronously
Parameter properties
Type: SwitchParameter
Default value: None Supports wildcards: False DontShow: False
Parameter sets
(All)
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-ResourceGroupName
The name of the resource group.
The name is case insensitive.
Parameter properties
Type: String
Default value: None Supports wildcards: False DontShow: False
Parameter sets
ByName
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-ResourceId
The ARM Resource ID of the virtual machine.
Parameter properties
Type: String
Default value: None Supports wildcards: False DontShow: False
Parameter sets
ByResourceId
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-SubscriptionId
The ID of the target subscription.
Parameter properties
Type: String
Default value: (Get-AzContext).Subscription.Id Supports wildcards: False DontShow: False
Parameter sets
ByName
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-WhatIf
Shows what would happen if the cmdlet runs.
The cmdlet is not run.
Parameter properties
Type: SwitchParameter
Default value: None Supports wildcards: False DontShow: False Aliases: wi
Parameter sets
(All)
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters .
Outputs
