Delen via

Remove-WAPackVMRole

  • Referentie
Module:
Azure

Hiermee verwijdert u functieobjecten voor virtuele machines.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

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

Deze onderwerpen zijn afgeschaft en worden in de toekomst verwijderd. In dit onderwerp wordt de cmdlet in de versie 0.8.1 van de Microsoft Azure PowerShell-module beschreven. Als u wilt achterhalen welke versie van de module u gebruikt, typt (Get-Module -Name Azure).Versionu in de Azure PowerShell-console.

De cmdlet Remove-WAPackVMRole verwijdert virtuele-machinerolobjecten.

Voorbeelden

Voorbeeld 1: Een virtuele-machinerol verwijderen (die is gemaakt met behulp van de WAP-portal)

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

Met de eerste opdracht wordt de rol van de virtuele machine met de naam ContosoVMRole01 opgehaald met behulp van de cmdlet Get-WAPackVMRole en wordt dat object vervolgens opgeslagen in de variabele $VMRole.

Met de tweede opdracht wordt de rol van de virtuele machine verwijderd die is opgeslagen in $VMRole. De opdracht vraagt u om bevestiging. Ervan uitgaande dat deze virtuele-machinerol is gemaakt met behulp van de WAP-portal, hoeft u de naam van de cloudservice niet op te geven.

Voorbeeld 2: Een virtuele-machinerol verwijderen die is gemaakt nadat u handmatig een cloudservice hebt gemaakt

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

Met de eerste opdracht wordt de rol van de virtuele machine met de naam ContosoVMRole02 opgehaald met behulp van de cmdlet Get-WAPackVMRole en wordt dat object vervolgens opgeslagen in de $VMRole variabele.

Met de tweede opdracht wordt de rol van de virtuele machine verwijderd die is opgeslagen in $VMRole. De opdracht vraagt u om bevestiging. Ervan uitgaande dat deze virtuele-machinerol niet is gemaakt met behulp van de portal, moet de gebruiker de naam van de cloudservice opgeven. In dit geval heet 'ContosoCloudService02'.

Voorbeeld 3: Een virtuele-machinerol verwijderen zonder bevestiging

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

Met de eerste opdracht wordt de cloudservice contosoVMRole03 opgehaald met behulp van de cmdlet Get-WAPackVMRole en wordt dat object vervolgens opgeslagen in de variabele $VMRole.

Met de tweede opdracht wordt de rol van de virtuele machine verwijderd die is opgeslagen in $VMRole. Deze opdracht bevat de parameter Force . De opdracht vraagt u niet om bevestiging.

Parameters

-CloudServiceName

Hiermee geeft u de naam van de cloudservice van de virtuele-machinerol.

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
standaardwaarde:False
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Retourneert een object dat het item aangeeft waarmee u werkt. Deze cmdlet genereert standaard geen uitvoer.

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-VMRole

Hiermee geeft u een virtuele-machinerol op. Gebruik de cmdlet Get-WAPackVMRole om een virtuele-machinerol op te halen.

Type:VMRole
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
standaardwaarde:False
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False