Stop-AzureVM

  • Referência
Módulo:
Azure

Desliga uma máquina virtual do Azure.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

Syntax

Stop-AzureVM
    [-Name] <String[]>
    [-StayProvisioned]
    [-Force]
    [-ServiceName] <String>
    [-Profile <AzureSMProfile>]
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [<CommonParameters>]
Stop-AzureVM
    -VM <IPersistentVM[]>
    [-StayProvisioned]
    [-Force]
    [-ServiceName] <String>
    [-Profile <AzureSMProfile>]
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [<CommonParameters>]

Description

O cmdlet Stop-AzureVM desliga uma máquina virtual.

Exemplos

Exemplo 1: Desligar uma máquina virtual

PS C:\> Stop-AzureVM -ServiceName "ContosoService01" -Name "MyVM"

Esse comando desliga uma máquina virtual que contém o serviço especificado.

Exemplo 2: Desligar uma máquina virtual usando um objeto de máquina virtual

PS C:\> Get-AzureVM -ServiceName "ContosoService01" -Name "MyVM" | Stop-AzureVM

Esse comando desliga uma máquina virtual que o serviço especificado contém, usando o objeto de máquina virtual que Get-AzureVM retorna.

Exemplo 3: Desligar uma VM e manter a VM provisionada

PS C:\> Stop-AzureVM -ServiceName "ContosoService01" -Name "MyVM" -StayProvisioned

Esse comando desliga uma máquina virtual que o serviço especificado contém e a mantém provisionada.

Exemplo 4: Desligar uma VM e permitir a desalocação da última VM na implantação

PS C:\> Stop-AzureVM -ServiceName "ContosoService01" -Name "MyVM" -Force

Esse comando desliga uma máquina virtual que o serviço especificado contém e permite a desalocação da última máquina virtual na implantação.

Exemplo 5: Desligar várias VMs

PS C:\> Stop-AzureVM -ServiceName "PSTestService" -Name "*" -Force

Esse comando desliga várias máquinas virtuais que o serviço especificado contém.

Parâmetros

-Force

Especifica se a desalocação da última máquina virtual em uma implantação deve ser permitida.

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

-InformationAction

Especifica como esse cmdlet responde a um evento de informações.

Os valores aceitáveis para esse parâmetro são:

  • Continuar
  • Ignorar
  • Perguntar
  • SilentlyContinue
  • Stop
  • Suspend
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Especifica uma variável de informação.

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

-Name

Especifica o nome da máquina virtual a ser desligada.

Use o caractere curinga para parar várias máquinas virtuais de forma assíncrona. Com um caractere curinga, esse cmdlet chama a operação Funções de Desligamentohttps://msdn.microsoft.com/en-us/library/azure/dn469421.aspx (), em vez da operação Função de Desligamentohttps://msdn.microsoft.com/en-us/library/azure/jj157195.aspx (https://msdn.microsoft.com/en-us/library/azure/dn469421.aspxhttps://msdn.microsoft.com/en-us/library/azure/jj157195.aspx).

Type:String[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

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

-ServiceName

Especifica o nome do serviço do Azure que contém a máquina virtual a ser desligada.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StayProvisioned

Especifica que esse cmdlet mantém a máquina virtual provisionada.

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

-VM

Especifica um objeto de máquina virtual que identifica a máquina virtual a ser desligada.

Type:IPersistentVM[]
Aliases:InputObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False