Remove-WAPackVMRole

Referenz

Modul:: Azure

Entfernt Rollenobjekte für virtuelle Computer.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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>]

Beschreibung

Diese Themen sind veraltet und werden in Zukunft entfernt. In diesem Thema wird das Cmdlet in der Version 0.8.1 des Microsoft Azure PowerShell-Moduls beschrieben. Um die Version des verwendeten Moduls zu ermitteln, geben Sie in der Azure PowerShell-Konsole folgendes ein (Get-Module -Name Azure).Version.

Das Cmdlet Remove-WAPackVMRole entfernt Rollenobjekte für virtuelle Computer.

Beispiele

Beispiel 1: Entfernen einer Rolle eines virtuellen Computers (die mithilfe des WAP-Portals erstellt wurde)

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

Der erste Befehl ruft die Rolle des virtuellen Computers namens ContosoVMRole01 mithilfe des Cmdlets "Get-WAPackVMRole " ab und speichert dieses Objekt dann in der $VMRole Variablen.

Mit dem zweiten Befehl wird die rolle des virtuellen Computers entfernt, die in $VMRole gespeichert ist. Die Eingabeaufforderung fordert Sie zur Bestätigung auf. Vorausgesetzt, diese Rolle des virtuellen Computers wurde mit dem WAP-Portal erstellt, muss der Name des Clouddiensts nicht angegeben werden.

Beispiel 2: Entfernen einer Rolle eines virtuellen Computers, die nach dem manuellen Erstellen eines Clouddiensts erstellt wurde

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

Der erste Befehl ruft die Rolle des virtuellen Computers namens "ContosoVMRole02" mithilfe des Cmdlets "Get-WAPackVMRole " ab und speichert dieses Objekt dann in der $VMRole Variablen.

Mit dem zweiten Befehl wird die rolle des virtuellen Computers entfernt, die in $VMRole gespeichert ist. Die Eingabeaufforderung fordert Sie zur Bestätigung auf. Wenn diese Rolle des virtuellen Computers nicht mithilfe des Portals erstellt wurde, muss der Benutzer den Namen des Clouddiensts angeben. In diesem Fall heißt "ContosoCloudService02".

Beispiel 3: Entfernen einer Rolle eines virtuellen Computers ohne Bestätigung

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

Der erste Befehl ruft den Clouddienst "ContosoVMRole03" mithilfe des Cmdlets "Get-WAPackVMRole " ab und speichert dieses Objekt dann in der $VMRole Variablen.

Mit dem zweiten Befehl wird die rolle des virtuellen Computers entfernt, die in $VMRole gespeichert ist. Dieser Befehl enthält den Parameter Force . Der Befehl fordert Sie nicht zur Bestätigung auf.

Parameter

-CloudServiceName

Gibt den Clouddienstnamen der Rolle des virtuellen Computers an.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMRole

Gibt eine Rolle eines virtuellen Computers an. Verwenden Sie das Cmdlet Get-WAPackVMRole , um eine Rolle eines virtuellen Computers abzurufen.

Type:	VMRole
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False