你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Stop-AzureVM
关闭 Azure 虚拟机。
注意
本文档中引用的 cmdlet 用于管理使用 Azure Service Manager （ASM） API 的旧 Azure 资源。 创建新的资源时，不建议使用此旧版 PowerShell 模块，因为 ASM 计划停用。 有关详细信息，请参阅 Azure Service Manager 停用。
Az PowerShell 模块是推荐的 PowerShell 模块，用于使用 PowerShell 管理 Azure 资源管理器 （ARM） 资源。
语法
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 |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InformationAction
指定此 cmdlet 如何响应信息事件。
此参数的可接受值为：
- 继续
- 忽略
- 询问
- SilentlyContinue
- 停止
- Suspend
| 类型: | ActionPreference |
| Aliases: | infa |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InformationVariable
指定信息变量。
| 类型: | String |
| Aliases: | iv |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Profile
指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。
| 类型: | AzureSMProfile |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ServiceName
指定要关闭的虚拟机的 Azure 服务的名称。
| 类型: | String |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StayProvisioned
指定此 cmdlet 使虚拟机保持预配状态。
| 类型: | SwitchParameter |
| Position: | 2 |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VM
指定要关闭的虚拟机的虚拟机对象。
| 类型: | IPersistentVM[] |
| Aliases: | InputObject |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |