你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Stop-AzureVM

模块:

Azure

关闭 Azure 虚拟机。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时，建议不要使用旧的 PowerShell 模块，因为计划将停用 ASM。 有关详细信息，请参阅 Azure Service Manager 停用。

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。

语法

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>]

说明

Stop-AzureVM cmdlet 关闭虚拟机。

示例

示例 1：关闭虚拟机

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

此命令关闭指定服务包含的虚拟机。

示例 2：使用虚拟机对象关闭虚拟机

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

此命令使用 Get-AzureVM 返回的虚拟机对象关闭指定服务包含的虚拟机。

示例 3：关闭 VM 并保留 VM 预配

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

此命令关闭指定服务包含的虚拟机，并使其保持预配状态。

示例 4：关闭 VM 并允许解除分配部署中最后一个 VM

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

此命令关闭指定服务包含的虚拟机，并允许解除分配部署中最后一个虚拟机。

示例 5：关闭多个 VM

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

此命令关闭指定服务包含的多个虚拟机。

参数

-Force

指定是否允许在部署中解除分配最后一个虚拟机。

类型:	SwitchParameter
Position:	3
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InformationAction

指定此 cmdlet 如何响应信息事件。

此参数的可接受值为：

• 继续
• 忽略
• 询问
• SilentlyContinue
• 停止
• Suspend

类型:	ActionPreference
别名:	infa
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InformationVariable

指定信息变量。

类型:	String
别名:	iv
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

指定要关闭的虚拟机的名称。

使用通配符异步停止多个虚拟机。 使用通配符时，此 cmdlet 调用关闭角色https://msdn.microsoft.com/en-us/library/azure/dn469421.aspx 操作（https://msdn.microsoft.com/en-us/library/azure/dn469421.aspx），而不是关闭角色https://msdn.microsoft.com/en-us/library/azure/jj157195.aspx 操作（https://msdn.microsoft.com/en-us/library/azure/jj157195.aspx）。

类型:	String[]
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。

类型:	AzureSMProfile
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ServiceName

指定要关闭的虚拟机的 Azure 服务的名称。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-StayProvisioned

指定此 cmdlet 使虚拟机保持预配状态。

类型:	SwitchParameter
Position:	2
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-VM

指定要关闭的虚拟机的虚拟机对象。

类型:	IPersistentVM[]
别名:	InputObject
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

相关链接

• Get-AzureVM
• New-AzureVM
• Restart-AzureVM
• Start-AzureVM