Udostępnij za pośrednictwem

Remove-WAPackVMRole

  • Odwołanie
Moduł:
Azure

Usuwa obiekty roli maszyny wirtualnej.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

Remove-WAPackVMRole
      -VMRole <VMRole>
      [-PassThru]
      [-Force]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-WAPackVMRole
      -VMRole <VMRole>
      -CloudServiceName <String>
      [-PassThru]
      [-Force]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Te tematy są przestarzałe i zostaną usunięte w przyszłości. W tym temacie opisano polecenie cmdlet w wersji 0.8.1 modułu Microsoft Azure PowerShell. Aby dowiedzieć się, której wersji modułu używasz, w konsoli programu Azure PowerShell wpisz (Get-Module -Name Azure).Version.

Polecenie cmdlet Remove-WAPackVMRole usuwa obiekty roli maszyny wirtualnej.

Przykłady

Przykład 1: Usuwanie roli maszyny wirtualnej (która została utworzona przy użyciu portalu WAP)

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

Pierwsze polecenie pobiera rolę maszyny wirtualnej o nazwie ContosoVMRole01 przy użyciu polecenia cmdlet Get-WAPackVMRole , a następnie przechowuje ten obiekt w zmiennej $VMRole.

Drugie polecenie usuwa rolę maszyny wirtualnej przechowywanej w $VMRole. Polecenie wyświetla monit o potwierdzenie. Zakładając, że ta rola maszyny wirtualnej została utworzona przy użyciu portalu WAP, nie ma potrzeby określania nazwy usługi w chmurze.

Przykład 2. Usuwanie roli maszyny wirtualnej, która została utworzona po ręcznym utworzeniu usługi w chmurze

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

Pierwsze polecenie pobiera rolę maszyny wirtualnej o nazwie "ContosoVMRole02" przy użyciu polecenia cmdlet Get-WAPackVMRole , a następnie przechowuje ten obiekt w zmiennej $VMRole.

Drugie polecenie usuwa rolę maszyny wirtualnej przechowywanej w $VMRole. Polecenie wyświetla monit o potwierdzenie. Zakładając, że ta rola maszyny wirtualnej nie została utworzona przy użyciu portalu, użytkownik musi określić nazwę usługi w chmurze. W tym przypadku o nazwie "ContosoCloudService02".

Przykład 3. Usuwanie roli maszyny wirtualnej bez potwierdzenia

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

Pierwsze polecenie pobiera usługę w chmurze o nazwie ContosoVMRole03 przy użyciu polecenia cmdlet Get-WAPackVMRole , a następnie przechowuje ten obiekt w zmiennej $VMRole.

Drugie polecenie usuwa rolę maszyny wirtualnej przechowywanej w $VMRole. To polecenie zawiera parametr Force . Polecenie nie wyświetla monitu o potwierdzenie.

Parametry

-CloudServiceName

Określa nazwę usługi w chmurze roli maszyny wirtualnej.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PassThru

Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

Typ:AzureSMProfile
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VMRole

Określa rolę maszyny wirtualnej. Aby uzyskać rolę maszyny wirtualnej, użyj polecenia cmdlet Get-WAPackVMRole .

Typ:VMRole
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False