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

Remove-WAPackVMRole

模块:

Azure

删除虚拟机角色对象。

注意

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

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

语法

Remove-WAPackVMRole
      -VMRole <VMRole>
      [-PassThru]
      [-Force]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-WAPackVMRole
      -VMRole <VMRole>
      -CloudServiceName <String>
      [-PassThru]
      [-Force]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

这些主题已弃用，将来将被删除。 本主题介绍 Microsoft Azure PowerShell 模块的 0.8.1 版本中的 cmdlet。 若要了解正在使用的模块版本，请从 Azure PowerShell 控制台键入 (Get-Module -Name Azure).Version。

Remove-WAPackVMRole cmdlet 删除虚拟机角色对象。

示例

示例 1：删除虚拟机角色（使用 WAP 门户创建）

PS C:\> $VMRole = Get-WAPackVMRole -Name "ContosoVMRole01"
PS C:\> Remove-WAPackVMRole -VMRole $VMRole

第一个命令使用 Get-WAPackVMRole cmdlet 获取名为 ContosoVMRole01 的虚拟机角色，然后将该对象存储在$VMRole变量中。

第二个命令删除存储在$VMRole中的虚拟机角色。 该命令会提示你进行确认。假设此虚拟机角色是使用 WAP 门户创建的，则无需指定云服务名称。

示例 2：删除在手动创建云服务后创建的虚拟机角色

PS C:\> $VMRole = Get-WAPackVMRole -Name "ContosoVMRole02"
PS C:\> Remove-WAPackVMRole -VMRole $VMRole -CloudServiceName "ContosoCloudService02"

第一个命令使用 Get-WAPackVMRole cmdlet 获取名为“ContosoVMRole02”的虚拟机角色，然后将该对象存储在$VMRole变量中。

第二个命令删除存储在$VMRole中的虚拟机角色。 该命令会提示你进行确认。 假设未使用门户创建此虚拟机角色，用户需要指定云服务名称。 在本例中，名为“ContosoCloudService02”。

示例 3：在不确认的情况下删除虚拟机角色

PS C:\> $VMRole = Get-WAPackVMRole -Name "ContosoVMRole03"
PS C:\> Remove-WAPackVMRole -VMRole $VMRole -Force

第一个命令使用 Get-WAPackVMRole cmdlet 获取名为 ContosoVMRole03 的云服务，然后将该对象存储在$VMRole变量中。

第二个命令删除存储在$VMRole中的虚拟机角色。 此命令包括 Force 参数。 该命令不会提示你进行确认。

参数

-CloudServiceName

指定虚拟机角色的云服务名称。

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-Force

强制运行命令而不要求用户确认。

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

-PassThru

返回一个代表你所处理的项目的对象。 默认情况下，此 cmdlet 将不产生任何输出。

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

-Profile

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

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

-VMRole

指定虚拟机角色。 若要获取虚拟机角色，请使用 Get-WAPackVMRole cmdlet。

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

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

相关链接

• Get-WAPackVMRole
• New-WAPackVMRole
• Set-WAPackVMRole