Compartilhar via

Remove-WAPackVMRole

  • Referência
Módulo:
Azure

Remove objetos de função de máquina virtual.

Observação

Os cmdlets referenciados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.

O módulo do Az PowerShell é o módulo recomendado do PowerShell para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

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

Esses tópicos foram descontinuados e serão removidos no futuro. Este tópico descreve o cmdlet na versão 0.8.1 do módulo do Microsoft Azure PowerShell. Para descobrir a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.

O cmdlet Remove-WAPackVMRole remove objetos de função de máquina virtual.

Exemplos

Exemplo 1: Remover uma função de máquina virtual (que foi criada usando o portal WAP)

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

O primeiro comando obtém a função de máquina virtual chamada ContosoVMRole01 usando o cmdlet Get-WAPackVMRole e, em seguida, armazena esse objeto na variável $VMRole.

O segundo comando remove a função de máquina virtual armazenada no $VMRole. O comando solicita a confirmação. Supondo que essa função de máquina virtual tenha sido criada usando o portal WAP, não há necessidade de especificar o nome do serviço de nuvem.

Exemplo 2: Remover uma função de máquina virtual que foi criada após a criação manual de um serviço de nuvem

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

O primeiro comando obtém a função de máquina virtual chamada "ContosoVMRole02" usando o cmdlet Get-WAPackVMRole e, em seguida, armazena esse objeto na variável $VMRole.

O segundo comando remove a função de máquina virtual armazenada no $VMRole. O comando solicita a confirmação. Supondo que essa função de máquina virtual não tenha sido criada usando o portal, o usuário precisa especificar o nome do serviço de nuvem. Nesse caso, chamado "ContosoCloudService02".

Exemplo 3: Remover uma função de máquina virtual sem confirmação

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

O primeiro comando obtém o serviço de nuvem chamado ContosoVMRole03 usando o cmdlet Get-WAPackVMRole e, em seguida, armazena esse objeto na variável $VMRole.

O segundo comando remove a função de máquina virtual armazenada no $VMRole. Este comando inclui o parâmetro Force . O comando não solicita confirmação.

Parâmetros

-CloudServiceName

Especifica o nome do serviço de nuvem da função de máquina virtual.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

Retorna um objeto que representa o item com que você está trabalhando. Por padrão, este cmdlet não gera saída.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Profile

Especifica o perfil do Azure do qual esse cmdlet é lido. Se você não especificar um perfil, esse cmdlet lerá o perfil padrão local.

Tipo:AzureSMProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VMRole

Especifica uma função de máquina virtual. Para obter uma função de máquina virtual, use o cmdlet Get-WAPackVMRole .

Tipo:VMRole
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False