Remove-WAPackVMRole
Remove objetos de função de máquina virtual.
Observação
Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.
Syntax
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 preteridos e serão removidos no futuro.
Este tópico descreve o cmdlet na versão 0.8.1 do módulo PowerShell do Microsoft Azure.
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 $VMRoleO primeiro comando obtém a função de máquina virtual chamada ContosoVMRole01 usando o cmdlet Get-WAPackVMRole e 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 foi 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 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 foi 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 -ForceO 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. Esse comando inclui o parâmetro Force . O comando não solicita a confirmação.
Parâmetros
-CloudServiceName
Especifica o nome do serviço de nuvem da função de máquina virtual.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Força o comando a ser executado sem solicitar a confirmação do usuário.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Retorna um objeto que representa o item com que você está trabalhando. Por padrão, este cmdlet não gera saída.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Profile
Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.
| Type: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMRole
Especifica uma função de máquina virtual. Para obter uma função de máquina virtual, use o cmdlet Get-WAPackVMRole .
| Type: | VMRole |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |