Remove-AzureRmTag
刪除預先定義的 Azure 標籤或值。
警告
自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。
雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。
Syntax
Remove-AzureRmTag
[-Name] <String>
[[-Value] <String[]>]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Remove-AzureRmTag Cmdlet 會從您的訂用帳戶中刪除預先定義的 Azure 標籤和值。 若要從預先定義的標記中刪除特定值，請使用 Value 參數。 根據預設， Remove-AzureRmTag 會刪除指定的標記及其所有值。您無法刪除目前套用至資源或資源群組的標記或值。 使用 Remove-AzureRmTag 之前，請使用 Set-AzureRMResourceGroup Cmdlet 的 Tag 參數，從資源或資源群組中刪除標記或值。 Remove-AzureRmTag 所屬的 Azure 標記模組可協助您管理預先定義的 Azure 標籤。 Azure 標籤是一組名稱/值組，可用來分類 Azure 資源和資源群組，例如依部門或成本中心，或追蹤有關資源和群組的附註或批註。 您可以在單一步驟中定義和套用標籤，但預先定義的標籤可讓您為訂用帳戶中的標記建立標準、一致、可預測的名稱和值。
範例
範例 1：刪除預先定義的標記
PS C:\>Remove-AzureRmTag -Name "Department"此命令會刪除名為 Department 及其所有資源的預先定義標籤。 如果標記已套用至任何資源或資源群組，命令就會失敗。
範例 2：從預先定義的標記中刪除值
PS C:\>Remove-AzureRmTag -Name "Department" -Value "HumanResources" -PassThru
Name: Department
Count: 14
Values:
Name Count
========= =====
Finance 2
IT 12此命令會從預先定義的 Department 標籤中刪除 HumanResources 值。 它不會刪除標記。 如果值已套用至任何資源或資源群組，命令就會失敗。
參數
-Confirm
執行 Cmdlet 之前先提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
指定要刪除的標記名稱。 根據預設， Remove-AzureRmTag 會移除指定的標記及其所有值。 若要刪除選取的值，但不要刪除標記，請使用 Value 參數。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PassThru
傳回 物件，表示已刪除的標記或結果標記，並已刪除值。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Value
從預先定義的標記中刪除指定的值，但不會刪除標記。
| Type: | String[] |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
String[]