Compartir a través de

Stop-AzureVM

  • Referencia
Módulo:
Azure

Apaga una máquina virtual de Azure.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

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

El cmdlet Stop-AzureVM apaga una máquina virtual.

Ejemplos

Ejemplo 1: Apagar una máquina virtual

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

Este comando apaga una máquina virtual que contiene el servicio especificado.

Ejemplo 2: Apagar una máquina virtual mediante un objeto de máquina virtual

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

Este comando cierra una máquina virtual que contiene el servicio especificado mediante el objeto de máquina virtual que devuelve Get-AzureVM .

Ejemplo 3: Apagar una máquina virtual y mantener la máquina virtual aprovisionada

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

Este comando cierra una máquina virtual que contiene el servicio especificado y la mantiene aprovisionada.

Ejemplo 4: Apagar una máquina virtual y permitir la desasignación de la última máquina virtual en la implementación

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

Este comando cierra una máquina virtual que el servicio especificado contiene y permite la desasignación de la última máquina virtual de la implementación.

Ejemplo 5: Apagar varias máquinas virtuales

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

Este comando cierra varias máquinas virtuales que contiene el servicio especificado.

Parámetros

-Force

Especifica si se va a permitir la desasignación de la última máquina virtual de una implementación.

Tipo:SwitchParameter
Posición:3
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationAction

Especifica cómo responde este cmdlet a un evento de información.

Los valores permitidos para este parámetro son los siguientes:

  • Continuar
  • Ignore
  • Inquire
  • SilentlyContinue
  • Detención
  • Suspender
Tipo:ActionPreference
Alias:infa
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationVariable

Especifica una variable de información.

Tipo:String
Alias:iv
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica el nombre de la máquina virtual que se va a apagar.

Use el carácter comodín para detener varias máquinas virtuales de forma asincrónica. Con un carácter comodín, este cmdlet llama a la operación Shutdown Roleshttps://msdn.microsoft.com/en-us/library/azure/dn469421.aspx (https://msdn.microsoft.com/en-us/library/azure/dn469421.aspx), en lugar de a la operación Shutdown Rolehttps://msdn.microsoft.com/en-us/library/azure/jj157195.aspx (https://msdn.microsoft.com/en-us/library/azure/jj157195.aspx).

Tipo:String[]
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ServiceName

Especifica el nombre del servicio de Azure que contiene la máquina virtual que se va a apagar.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-StayProvisioned

Especifica que este cmdlet mantiene la máquina virtual aprovisionada.

Tipo:SwitchParameter
Posición:2
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VM

Especifica un objeto de máquina virtual que identifica la máquina virtual que se va a apagar.

Tipo:IPersistentVM[]
Alias:InputObject
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False