Share via

Remove-WAPackVMRole

  • Riferimento
Modulo:
Azure

Rimuove gli oggetti ruolo macchina virtuale.

Nota

I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di gestione dei servizi. Vedere il modulo Az PowerShell per i cmdlet per gestire le risorse di Azure Resource Manager.

Sintassi

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

Descrizione

Questi argomenti sono deprecati e verranno rimossi in futuro. Questo argomento descrive il cmdlet nella versione 0.8.1 del modulo Microsoft Azure PowerShell. Per scoprire la versione del modulo in uso, dalla console di Azure PowerShell digitare (Get-Module -Name Azure).Version.

Il cmdlet Remove-WAPackVMRole rimuove gli oggetti ruolo macchina virtuale.

Esempio

Esempio 1: Rimuovere un ruolo macchina virtuale (creato usando il portale WAP)

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

Il primo comando ottiene il ruolo macchina virtuale denominato ContosoVMRole01 usando il cmdlet Get-WAPackVMRole e quindi archivia tale oggetto nella variabile $VMRole.

Il secondo comando rimuove il ruolo macchina virtuale archiviato in $VMRole. Il comando richiede la conferma. Supponendo che questo ruolo macchina virtuale sia stato creato usando il portale WAP, non è necessario specificare il nome del servizio cloud.

Esempio 2: Rimuovere un ruolo macchina virtuale creato dopo la creazione manuale di un servizio cloud

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

Il primo comando ottiene il ruolo macchina virtuale denominato "ContosoVMRole02" usando il cmdlet Get-WAPackVMRole e quindi archivia tale oggetto nella variabile $VMRole.

Il secondo comando rimuove il ruolo macchina virtuale archiviato in $VMRole. Il comando richiede la conferma. Supponendo che questo ruolo macchina virtuale non sia stato creato usando il portale, l'utente deve specificare il nome del servizio cloud. In questo caso denominato "ContosoCloudService02".

Esempio 3: Rimuovere un ruolo macchina virtuale senza conferma

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

Il primo comando ottiene il servizio cloud denominato ContosoVMRole03 usando il cmdlet Get-WAPackVMRole e quindi archivia tale oggetto nella variabile $VMRole.

Il secondo comando rimuove il ruolo macchina virtuale archiviato in $VMRole. Questo comando include il parametro Force . Il comando non richiede la conferma.

Parametri

-CloudServiceName

Specifica il nome del servizio cloud del ruolo macchina virtuale.

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-Force

Forza l'esecuzione del comando senza chiedere conferma all'utente.

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

-PassThru

Restituisce un oggetto che rappresenta l'elemento in uso. Per impostazione predefinita, il cmdlet non genera alcun output.

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

-Profile

Specifica il profilo di Azure da cui viene letto questo cmdlet. Se non si specifica un profilo, questo cmdlet legge dal profilo predefinito locale.

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

-VMRole

Specifica un ruolo macchina virtuale. Per ottenere un ruolo macchina virtuale, usare il cmdlet Get-WAPackVMRole .

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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