Stop-AzureVM
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 Service Management API. Consulte el módulo de Az PowerShell para cmdlets para administrar recursos de 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
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.
Type: | SwitchParameter |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
- Stop
- Suspender
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
Especifica una variable de información.
Type: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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).
Type: | String[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Profile
Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServiceName
Especifica el nombre del servicio de Azure que contiene la máquina virtual que se va a apagar.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StayProvisioned
Especifica que este cmdlet mantiene la máquina virtual aprovisionada.
Type: | SwitchParameter |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VM
Especifica un objeto de máquina virtual que identifica la máquina virtual que se va a apagar.
Type: | IPersistentVM[] |
Aliases: | InputObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |