Restart-AzureVM

Module:: Azure

Restarts an Azure virtual machine.

Syntax

Restart-AzureVM
       [-ServiceName] <String>
       [-Name] <String>
       [-InformationAction <ActionPreference>]
       [-InformationVariable <String>]
       [-InitiateMaintenance]
       [-Profile <AzureSMProfile>]
       [<CommonParameters>]

Restart-AzureVM
       [-ServiceName] <String>
       [-InformationAction <ActionPreference>]
       [-InformationVariable <String>]
       [-InitiateMaintenance]
       [-Profile <AzureSMProfile>]
       -VM <PersistentVM>
       [<CommonParameters>]

Restart-AzureVM
       [-ServiceName] <String>
       [-Name] <String>
       [-InformationAction <ActionPreference>]
       [-InformationVariable <String>]
       [-Profile <AzureSMProfile>]
       [<CommonParameters>]

Restart-AzureVM
       [-ServiceName] <String>
       [-Name] <String>
       [-InformationAction <ActionPreference>]
       [-InformationVariable <String>]
       [-Profile <AzureSMProfile>]
       [-Redeploy]
       [<CommonParameters>]

Restart-AzureVM
       [-ServiceName] <String>
       [-InformationAction <ActionPreference>]
       [-InformationVariable <String>]
       [-Profile <AzureSMProfile>]
       [-Redeploy]
       -VM <PersistentVM>
       [<CommonParameters>]

Restart-AzureVM
       [-ServiceName] <String>
       [-InformationAction <ActionPreference>]
       [-InformationVariable <String>]
       [-Profile <AzureSMProfile>]
       -VM <PersistentVM>
       [<CommonParameters>]

Description

The Restart-AzureVM cmdlet requests a restart of an Azure virtual machine.

Examples

Example 1: Restart a virtual machine

PS C:\> Restart-AzureVM -ServiceName "MyService01" -Name "MyVM"

This command restarts the VirtualMachine27 virtual machine running in the Azure service named Service01.

Example 2: Restart a virtual machine by using a virtual machine object

PS C:\> Get-AzureVM -ServiceName "MyService01" -Name "VirtualMachine27" | Restart-AzureVM

This command retrieves the virtual machine object for the virtual machine named MyVM and then restarts it.

Required Parameters

-InitiateMaintenance

Initiate Maintenance on the Virtual Machine

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Specifies the name of the virtual machine to restart.

Type:	String
Position:	1
Default value:	None
Accept pipeline input:	True (ByPropertyName)
Accept wildcard characters:	False

-Redeploy

Indicates that the cmdlet redeploys the virtual machine.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ServiceName

Specifies the name of the Azure service that contains the virtual machine to restart.

Type:	String
Position:	0
Default value:	None
Accept pipeline input:	True (ByPropertyName)
Accept wildcard characters:	False

-VM

Specifies a virtual machine object that identifies the virtual machine to restart.

Type:	PersistentVM
Aliases:	InputObject
Position:	Named
Default value:	None
Accept pipeline input:	True (ByValue)
Accept wildcard characters:	False

Optional Parameters

-InformationAction

Specifies how this cmdlet responds to an information event.

The acceptable values for this parameter are:

Continue
Ignore
Inquire
SilentlyContinue
Stop
Suspend

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Specifies an information variable.

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Profile

Specifies the Azure profile from which this cmdlet reads. If you do not specify a profile, this cmdlet reads from the local default profile.

Type:	AzureSMProfile
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False