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

String[]

SwitchParameter

Výstupy

PSTag