Remove-AzureVM
[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]
Remove-AzureVM
Removes a Windows Azure virtual machine.
Syntax
Parameter Set: Default
Remove-AzureVM [-ServiceName] <String> [-Name] <String> [ <CommonParameters>]
Detailed Description
This topic describes the cmdlet in the 0.8.10 version of the Microsoft Azure PowerShell module. To get the version of the module you're using, in the Azure PowerShell console, type (Get-Module -Name Azure).Version.
The Remove-AzureVM cmdlet deletes a Windows Azure virtual machine. This process doesn’t delete the underlying .vhd files of the disks mounted on that virtual machine.
Parameters
-Name<String>
Specifies the name of the virtual machine being removed.
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ServiceName<String>
Specifies the name of the Windows Azure service from which the virtual machine is being removed.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1
This command removes the "MyVM" virtual machine running in the "MySvc1" service.
C:\PS> Remove-AzureVM -ServiceName "MySvc1" -Name "MyVM"
Related topics
Create or Delete Virtual Machines Using Windows Azure Cmdlets