你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Stop-AzureVM
关闭 Azure 虚拟机。
注意
本文档中引用的 cmdlet 用于管理使用服务管理 API 的旧式 Azure 资源。 若要了解用于管理 Azure 资源管理器资源的 cmdlet，请参阅 Az 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
指定是否允许在部署中解除分配最后一个虚拟机。
| Type: | SwitchParameter |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InformationAction
指定此 cmdlet 如何响应信息事件。
此参数的可接受值为：
- 继续
- 忽略
- 询问
- SilentlyContinue
- 停止
- 暂停
| Type: | ActionPreference |
| Aliases: | infa |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InformationVariable
指定信息变量。
| Type: | String |
| Aliases: | iv |
| Position: | Named |
| Default value: | None |
| Required: | 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）。
| Type: | String[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Profile
指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。
| Type: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ServiceName
指定要关闭的虚拟机的 Azure 服务的名称。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StayProvisioned
指定此 cmdlet 使虚拟机保持预配状态。
| Type: | SwitchParameter |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VM
指定要关闭的虚拟机的虚拟机对象。
| Type: | IPersistentVM[] |
| Aliases: | InputObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |