Freigeben über

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 Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit 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>]

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.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

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

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Profile

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

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VMRole

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

Typ:VMRole
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False