Compartir a través de

Remove-WAPackVMRole

  • Referencia
Módulo:
Azure

Quita objetos de rol de máquina virtual.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

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

Description

Estos temas están en desuso y se quitarán en el futuro. En este tema se describe el cmdlet de la versión 0.8.1 del módulo de Microsoft Azure PowerShell. Para averiguar la versión del módulo que usa, en la consola de Azure PowerShell, escriba (Get-Module -Name Azure).Version.

El cmdlet Remove-WAPackVMRole quita objetos de rol de máquina virtual.

Ejemplos

Ejemplo 1: Eliminación de un rol de máquina virtual (que se creó mediante el portal de WAP)

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

El primer comando obtiene el rol de máquina virtual denominado ContosoVMRole01 mediante el cmdlet Get-WAPackVMRole y, a continuación, almacena ese objeto en la variable $VMRole.

El segundo comando quita el rol de máquina virtual almacenado en $VMRole. El comando le pide confirmación. Suponiendo que este rol de máquina virtual se creó mediante el portal de WAP, no es necesario especificar el nombre del servicio en la nube.

Ejemplo 2: Eliminación de un rol de máquina virtual que se creó después de crear manualmente un servicio en la nube

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

El primer comando obtiene el rol de máquina virtual denominado "ContosoVMRole02" mediante el cmdlet Get-WAPackVMRole y, a continuación, almacena ese objeto en la variable $VMRole.

El segundo comando quita el rol de máquina virtual almacenado en $VMRole. El comando le pide confirmación. Suponiendo que este rol de máquina virtual no se creó mediante el portal, el usuario debe especificar el nombre del servicio en la nube. En este caso, se denomina "ContosoCloudService02".

Ejemplo 3: Eliminación de un rol de máquina virtual sin confirmación

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

El primer comando obtiene el servicio en la nube denominado ContosoVMRole03 mediante el cmdlet Get-WAPackVMRole y, a continuación, almacena ese objeto en la variable $VMRole.

El segundo comando quita el rol de máquina virtual almacenado en $VMRole. Este comando incluye el parámetro Force . El comando no le pide confirmación.

Parámetros

-CloudServiceName

Especifica el nombre del servicio en la nube del rol de máquina virtual.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ningún resultado.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VMRole

Especifica un rol de máquina virtual. Para obtener un rol de máquina virtual, use el cmdlet Get-WAPackVMRole .

Tipo:VMRole
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False