Delen via


New-AzTag

Hiermee maakt u een vooraf gedefinieerde Azure-tag of voegt u waarden toe aan een bestaande tag | Hiermee maakt of werkt u de hele set tags voor een resource of abonnement bij.

Syntaxis

New-AzTag
   [-Name] <String>
   [[-Value] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzTag
   [-ResourceId] <String>
   [-Tag] <Hashtable>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

CreatePredefinedTagSet: De cmdlet New-AzTag 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-AzTag 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-AzTag. Als u wilt zoeken naar resourcegroepen met een opgegeven tagnaam of naam en waarde, gebruikt u de parameter Tag van de cmdlet Get-AzResourceGroup. 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.

CreateByResourceIdParameterSet: De cmdlet New-AzTag met een ResourceId maakt of werkt de hele set tags voor een resource of abonnement bij. Met deze bewerking kunt u de hele set tags toevoegen of vervangen voor de opgegeven resource of het opgegeven abonnement. De opgegeven entiteit kan maximaal 50 tags bevatten.

Voorbeelden

Voorbeeld 1: Een vooraf gedefinieerde tag maken

New-AzTag -Name "FY2015"

Name   ValuesTable Count Values 
----   ----------- ----- ------
FY2015             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-AzTag 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

New-AzTag -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

New-AzTag -Name "Department" -Value "Finance"

Name:   Department
Count:  0
Values: 
        Name        Count
        =========   =====
        Finance     0 
New-AzTag -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-AzTag de waarde toe aan de bestaande tag in plaats van een nieuwe tag te maken.

Voorbeeld 4: Een vooraf gedefinieerde tag gebruiken

New-AzTag -Name "CostCenter" -Value "0001"

Name:   CostCenter
Count:  0
Values: 
        Name        Count
        =========   =====
        0001        0 

Set-AzResourceGroup -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 

Get-AzTag -Name "CostCenter"

Name:   CostCenter
Count:  1
Values: 
        Name        Count
        =========   =====
        0001        1 

Get-AzResourceGroup -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.

Voorbeeld 5: Hiermee maakt of bijwerkt u de volledige set tags voor een abonnement

$Tags = @{"tagKey1"="tagValue1"; "tagKey2"="tagValue2"}
New-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $Tags

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             tagKey1  tagValue1
             tagKey2  tagValue2

Met deze opdracht maakt of werkt u de hele set tags in het abonnement bij met {subId}.

Voorbeeld 6: Hiermee maakt of werkt u de hele set tags op een resource aan of werkt u deze bij

$Tags = @{"Dept"="Finance"; "Status"="Normal"}
New-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1 -Tag $Tags

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             Dept     Finance
             Status   Normal

Met deze opdracht wordt de hele set tags voor de resource gemaakt of bijgewerkt met {resourceId}.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de vooraf gedefinieerde 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-AzTag de opgegeven waarde toe aan de tag met die naam in plaats van een nieuwe tag te maken.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceId

De resource-id voor de entiteit die wordt getagd. Een resource, een resourcegroep of een abonnement kan worden getagd.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Tag

De tags die op de resource moeten worden geplaatst.

Type:Hashtable
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Value

Hiermee geeft u een vooraf gedefinieerde tagwaarde op. 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
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

Hashtable

Uitvoerwaarden

Microsoft.Azure.Commands.ResourceManager.Common.Tags.PSTag | Microsoft.Azure.Commands.Tags.Model.PSTagResource