Compartilhar via

Stop-AzureVM

  • Referência
Módulo:
Azure

Desliga uma máquina virtual do Azure.

Observação

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo do PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

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.

Tipo:SwitchParameter
Cargo:3
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
  • Parar
  • Suspend
Tipo:ActionPreference
Aliases:infa
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InformationVariable

Especifica uma variável de informação.

Tipo:String
Aliases:iv
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 (https://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/jj157195.aspx).

Tipo:String[]
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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.

Tipo:AzureSMProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ServiceName

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

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-StayProvisioned

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

Tipo:SwitchParameter
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VM

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

Tipo:IPersistentVM[]
Aliases:InputObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False