Remove-WAPackVMRole
拿掉虛擬機角色物件。
注意
本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager(ASM) API 的舊版 Azure 資源。 建立新的資源時,不建議使用此舊版 PowerShell 模組,因為 ASM 已排定淘汰。 如需詳細資訊,請參閱 Azure Service Manager 淘汰。
Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager (ARM) 資源的建議 PowerShell 模組。
語法
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
這些主題已被取代,未來將會移除。
本主題描述 Microsoft Azure PowerShell 模組 0.8.1 版中的 Cmdlet。
若要瞭解您所使用的模組版本,請從 Azure PowerShell 控制台輸入 (Get-Module -Name Azure).Version
。
Remove-WAPackVMRole Cmdlet 會移除虛擬機角色物件。
範例
範例 1:移除使用 WAP 入口網站建立的虛擬機角色
PS C:\> $VMRole = Get-WAPackVMRole -Name "ContosoVMRole01"
PS C:\> Remove-WAPackVMRole -VMRole $VMRole
第一個命令會使用 Get-WAPackVMRole Cmdlet 取得名為 ContosoVMRole01 的虛擬機角色,然後將該物件儲存在$VMRole變數中。
第二個命令會移除儲存在 $VMRole 中的虛擬機角色。 命令會提示您進行確認。假設此虛擬機角色是使用 WAP 入口網站建立的,就不需要指定雲端服務名稱。
範例 2:移除手動建立雲端服務之後所建立的虛擬機角色
PS C:\> $VMRole = Get-WAPackVMRole -Name "ContosoVMRole02"
PS C:\> Remove-WAPackVMRole -VMRole $VMRole -CloudServiceName "ContosoCloudService02"
第一個命令會使用 Get-WAPackVMRole Cmdlet 取得名為 “ContosoVMRole02 ” 的虛擬機角色,然後將該物件儲存在 $VMRole 變數中。
第二個命令會移除儲存在 $VMRole 中的虛擬機角色。 命令會提示您進行確認。 假設此虛擬機角色不是使用入口網站建立的,用戶必須指定雲端服務名稱。 在此案例中,名為 「ContosoCloudService02」。。
範例 3:移除虛擬機角色而不需確認
PS C:\> $VMRole = Get-WAPackVMRole -Name "ContosoVMRole03"
PS C:\> Remove-WAPackVMRole -VMRole $VMRole -Force
第一個命令會使用 Get-WAPackVMRole Cmdlet 取得名為 ContosoVMRole03 的雲端服務,然後將該物件儲存在 $VMRole 變數中。
第二個命令會移除儲存在 $VMRole 中的虛擬機角色。 此命令包含 Force 參數。 命令不會提示您進行確認。
參數
-CloudServiceName
指定虛擬機角色的雲端服務名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前先提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Force
強制命令執行,而不要求使用者確認。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-PassThru
會傳回 物件,代表您正在使用的專案。 根據預設,此 Cmdlet 不會產生任何輸出。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Profile
指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔,此 Cmdlet 會從本機預設配置檔讀取。
類型: | AzureSMProfile |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-VMRole
指定虛擬機角色。 若要取得虛擬機角色,請使用 Get-WAPackVMRole Cmdlet。
類型: | VMRole |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |