Remove-AzureRmTag
Odstraní předdefinované značky nebo hodnoty Azure.
Upozorňující
Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.
I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.
Syntax
Remove-AzureRmTag
[-Name] <String>
[[-Value] <String[]>]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Remove-AzureRmTag odstraní předdefinované značky a hodnoty Azure z vašeho předplatného. Pokud chcete odstranit konkrétní hodnoty z předdefinované značky, použijte parametr Value . Ve výchozím nastavení Remove-AzureRmTag odstraní zadanou značku a všechny její hodnoty. Nelze odstranit značku nebo hodnotu, která je aktuálně použita pro prostředek nebo skupinu prostředků. Před použitím Remove-AzureRmTag pomocí parametru Tag rutiny Set-AzureRMResourceGroup odstraňte značku nebo hodnoty z prostředku nebo skupiny prostředků. Modul Značky Azure, který remove-AzureRmTag je součástí, vám může pomoct se správou předdefinovaných značek Azure. Značka Azure je pár název-hodnota, který můžete použít ke kategorizaci prostředků a skupin prostředků Azure, jako jsou oddělení nebo nákladové středisko, nebo ke sledování poznámek nebo komentářů k prostředkům a skupinám. Značky můžete definovat a používat v jednom kroku, ale předdefinované značky umožňují vytvořit standardní, konzistentní, předvídatelné názvy a hodnoty pro značky ve vašem předplatném.
Příklady
Příklad 1: Odstranění předdefinované značky
PS C:\>Remove-AzureRmTag -Name "Department"
Tento příkaz odstraní předdefinovanou značku s názvem Oddělení a všechny její prostředky. Pokud byla značka použita pro všechny prostředky nebo skupiny prostředků, příkaz selže.
Příklad 2: Odstranění hodnoty z předdefinované značky
PS C:\>Remove-AzureRmTag -Name "Department" -Value "HumanResources" -PassThru
Name: Department
Count: 14
Values:
Name Count
========= =====
Finance 2
IT 12
Tento příkaz odstraní hodnotu HumanResources z předdefinované značky Oddělení. Neodstraní značku. Pokud byla hodnota použita pro všechny prostředky nebo skupiny prostředků, příkaz selže.
Parametry
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Určuje název značky, která se má odstranit. Ve výchozím nastavení Remove-AzureRmTag odebere zadanou značku a všechny její hodnoty. Pokud chcete odstranit vybrané hodnoty, ale neodstraňovat značku, použijte parametr Value .
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Vrátí objekt, který představuje odstraněnou značku nebo výslednou značku s odstraněnou hodnotou.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Value
Odstraní zadané hodnoty z předdefinované značky, ale neodstraní značku.
Type: | String[] |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Vstupy
String[]