New-AzureRmTag

Module:

AzureRM.Tags

Hiermee maakt u een vooraf gedefinieerde Azure-tag of voegt u waarden toe aan een bestaande tag.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntax

New-AzureRmTag
   [-Name] <String>
   [[-Value] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

De cmdlet New-AzureRmTag maakt een vooraf gedefinieerde Azure-tag met een optionele vooraf gedefinieerde waarde. U kunt deze ook gebruiken om extra waarden toe te voegen aan bestaande vooraf gedefinieerde tags. Als u een vooraf gedefinieerde tag wilt maken, voert u een unieke tagnaam in. Als u een waarde wilt toevoegen aan een bestaande vooraf gedefinieerde tag, geeft u de naam van de bestaande tag en de nieuwe waarde op. Met deze cmdlet wordt een object geretourneerd dat de nieuwe of gewijzigde tag vertegenwoordigt met de bijbehorende waarden en het aantal resources waarop het is toegepast. De Azure Tags-module waarvan New-AzureRmTag deel uitmaakt, kan u helpen bij het beheren van vooraf gedefinieerde Azure-tags. Een Azure-tag is een naam-waardepaar dat u kunt gebruiken om uw Azure-resources en resourcegroepen, zoals per afdeling of kostenplaats, te categoriseren of notities of opmerkingen over de resources en groepen bij te houden. U kunt tags in één stap definiëren en toepassen, maar met vooraf gedefinieerde tags kunt u standaard, consistente, voorspelbare namen en waarden instellen voor de tags in uw abonnement. Als u een vooraf gedefinieerde tag wilt toepassen op een resource of resourcegroep, gebruikt u de tagparameter van de cmdlet New-AzureRmTag. Als u wilt zoeken naar resourcegroepen met een opgegeven tagnaam of naam en waarde, gebruikt u de tagparameter van de cmdlet Get-AzureRMResourceGroup. Elke tag heeft een naam. De waarden zijn optioneel. Een vooraf gedefinieerde Azure-tag kan meerdere waarden hebben, maar wanneer u de tag toepast op een resource of resourcegroep, past u de tagnaam en slechts één van de waarden toe. U kunt bijvoorbeeld een vooraf gedefinieerde afdelingstag maken met een waarde voor elke afdeling, zoals Financiën, Human Resources en IT. Wanneer u de tag Afdeling toepast op een resource, past u slechts één vooraf gedefinieerde waarde toe, zoals Financiën.

Voorbeelden

Voorbeeld 1: Een vooraf gedefinieerde tag maken

PS C:\>New-AzureRmTag -Name "FY2015"
Name:   FY2015
Count:  0
Values: 

        Name        Count
        =========   =====

        Finance     0

Met deze opdracht maakt u een vooraf gedefinieerde tag met de naam FY2015. Deze tag heeft geen waarden. U kunt een tag zonder waarden toepassen op een resource of resourcegroep, of new-AzureRmTag gebruiken om waarden toe te voegen aan de tag. U kunt ook een waarde opgeven wanneer u de tag toepast op de resource of resourcegroep.

Voorbeeld 2: Een vooraf gedefinieerde tag met een waarde maken

PS C:\>New-AzureRmTag -Name "Department" -Value "Finance"
Name:   Department
Count:  0
Values: 

        Name        Count
        =========   =====
        Finance     0

Met deze opdracht maakt u een vooraf gedefinieerde tag met de naam Afdeling met de waarde Financiën.

Voorbeeld 3: Een waarde toevoegen aan een vooraf gedefinieerde tag

PS C:\>New-AzureRmTag -Name "Department" -Value "Finance"
Name:   Department
Count:  0
Values: 
        Name        Count
        =========   =====
        Finance     0 
PS C:\>New-AzureRmTag -Name "Department" -Value "IT"
Name:   Department
Count:  0
Values: 
        Name        Count
        =========   =====
        Finance     0
        IT          0

Met deze opdrachten maakt u een vooraf gedefinieerde tag met de naam Afdeling met twee waarden. Als de tagnaam bestaat, voegt New-AzureRmTag de waarde toe aan de bestaande tag in plaats van een nieuwe tag te maken.

Voorbeeld 4: Een vooraf gedefinieerde tag gebruiken

PS C:\>New-AzureRmTag -Name "CostCenter" -Value "0001"
Name:   CostCenter
Count:  0
Values: 
        Name        Count
        =========   =====
        0001        0 
PS C:\>Set-AzureRmResourceGroup -Name "EngineerBlog" -Tag @{Name="CostCenter";Value="0001"}
Name:      EngineerBlog
Location:  East US
Resources: 
            
  Name             Type                     Location
    ===============  =======================  ========
    EngineerBlog     Microsoft.Web/sites      West US
    EngSvr01         Microsoft.Sql/servers    West US
    EngDB02          Microsoft.Sql/databases  West US
Tags: 
    Name         Value
    ==========   =====
    CostCenter   0001 
PS C:\>Get-AzureRmTag -Name "CostCenter"
Name:   CostCenter
Count:  1
Values: 
        Name        Count
        =========   =====
        0001        1 
PS C:\>Get-AzureRmResourceGroup -Tag @{Name="CostCenter"}
Name:      EngineerBlog
Location:  East US
Resources: 
     Name             Type                     Location
    ===============  =======================  ========
    EngineerBlog     Microsoft.Web/sites      West US

    EngSvr01         Microsoft.Sql/servers    West US
    EngDB02          Microsoft.Sql/databases  West US
Tags: 
    Name         Value
    ==========   =====
    CostCenter   0001

De opdrachten in dit voorbeeld maken en gebruiken een vooraf gedefinieerde tag.

Parameters

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Hiermee geeft u de tagnaam. Als u een nieuwe vooraf gedefinieerde tag wilt maken, voert u een unieke naam in. Als u een waarde wilt toevoegen aan een bestaande tag, voert u de naam van de bestaande tag in. Als een bestaande vooraf gedefinieerde tag de opgegeven naam heeft, voegt New-AzureRmTag de opgegeven waarde toe aan de tag met die naam in plaats van een nieuwe tag te maken.

Type:	String
Position:	0
standaardwaarde:	None
Vereist:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Value

Hiermee geeft u een tagwaarde. Vooraf gedefinieerde tags kunnen meerdere waarden hebben, maar u kunt slechts één waarde invoeren in elke opdracht. Deze parameter is optioneel, omdat tags namen zonder waarden kunnen hebben.

Type:	String
Position:	1
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	True
Accept wildcard characters:	False

Invoerwaarden

String

Uitvoerwaarden

PSTag

Verwante koppelingen

• Get-AzureRmTag
• Remove-AzureRmTag