Udostępnij za pośrednictwem

New-AzTag

  • Odwołanie
Moduł:
Az.Resources

Tworzy wstępnie zdefiniowany tag platformy Azure lub dodaje wartości do istniejącego tagu | Tworzy lub aktualizuje cały zestaw tagów w zasobie lub subskrypcji.

Składnia

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

Opis

CreatePredefinedTagSet: polecenie cmdlet New-AzTag tworzy wstępnie zdefiniowany tag platformy Azure z opcjonalną wstępnie zdefiniowaną wartością. Można go również użyć do dodawania dodatkowych wartości do istniejących wstępnie zdefiniowanych tagów. Aby utworzyć wstępnie zdefiniowany tag, wprowadź unikatową nazwę tagu. Aby dodać wartość do istniejącego wstępnie zdefiniowanego tagu, określ nazwę istniejącego tagu i nową wartość. To polecenie cmdlet zwraca obiekt reprezentujący nowy lub zmodyfikowany tag z jego wartościami i liczbą zasobów, do których został zastosowany. Moduł Azure Tags, który new-AzTag jest częścią, może pomóc w zarządzaniu wstępnie zdefiniowanymi tagami platformy Azure. Tag platformy Azure to para nazwa-wartość, której można użyć do kategoryzowania zasobów i grup zasobów platformy Azure, takich jak dział lub centrum kosztów, albo do śledzenia notatek lub komentarzy dotyczących zasobów i grup. Tagi można definiować i stosować w jednym kroku, ale wstępnie zdefiniowane tagi umożliwiają ustanowienie standardowych, spójnych, przewidywalnych nazw i wartości tagów w ramach subskrypcji. Aby zastosować wstępnie zdefiniowany tag do zasobu lub grupy zasobów, użyj parametru tagu polecenia cmdlet New-AzTag. Aby wyszukać grupy zasobów o określonej nazwie tagu lub nazwie i wartości, użyj parametru tagu polecenia cmdlet Get-AzResourceGroup. Każdy tag ma nazwę. Wartości są opcjonalne. Wstępnie zdefiniowany tag platformy Azure może zawierać wiele wartości, ale po zastosowaniu tagu do zasobu lub grupy zasobów należy zastosować nazwę tagu i tylko jedną z jego wartości. Można na przykład utworzyć wstępnie zdefiniowany tag Dział z wartością dla każdego działu, takiego jak Finanse, Zasoby ludzkie i DZIAŁ IT. Po zastosowaniu tagu Dział do zasobu stosuje się tylko jedną wstępnie zdefiniowaną wartość, taką jak Finanse.

createByResourceIdParameterSet: polecenie cmdlet New-AzTag za pomocą ResourceId tworzy lub aktualizuje cały zestaw tagów w zasobie lub subskrypcji. Ta operacja umożliwia dodawanie lub zastępowanie całego zestawu tagów w określonym zasobie lub subskrypcji. Określona jednostka może mieć maksymalnie 50 tagów.

Przykłady

Przykład 1. Tworzenie wstępnie zdefiniowanego tagu

New-AzTag -Name "FY2015"

Name   ValuesTable Count Values 
----   ----------- ----- ------
FY2015             0     {}

To polecenie tworzy wstępnie zdefiniowany tag o nazwie FY2015. Ten tag nie ma wartości. Możesz zastosować tag bez wartości do zasobu lub grupy zasobów albo użyć New-AzTag, aby dodać wartości do tagu. Można również określić wartość podczas stosowania tagu do zasobu lub grupy zasobów.

Przykład 2. Tworzenie wstępnie zdefiniowanego tagu z wartością

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

Name:   Department
Count:  0
Values: 

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

To polecenie tworzy wstępnie zdefiniowany tag o nazwie Dział z wartością Finanse.

Przykład 3. Dodawanie wartości do wstępnie zdefiniowanego tagu

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

Te polecenia tworzą wstępnie zdefiniowany tag o nazwie Dział z dwiema wartościami. Jeśli nazwa tagu istnieje, New-AzTag dodaje wartość do istniejącego tagu zamiast tworzenia nowego.

Przykład 4. Używanie wstępnie zdefiniowanego tagu

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

Polecenia w tym przykładzie tworzą i używają wstępnie zdefiniowanego tagu.

Przykład 5. Tworzy lub aktualizuje cały zestaw tagów w subskrypcji

$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

To polecenie tworzy lub aktualizuje cały zestaw tagów w subskrypcji za pomocą {subId}.

Przykład 6. Tworzy lub aktualizuje cały zestaw tagów w zasobie

$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

To polecenie tworzy lub aktualizuje cały zestaw tagów w zasobie za pomocą elementu {resourceId}.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa wstępnie zdefiniowaną nazwę tagu. Aby utworzyć nowy wstępnie zdefiniowany tag, wprowadź unikatową nazwę. Aby dodać wartość do istniejącego tagu, wprowadź nazwę istniejącego tagu. Jeśli istniejący wstępnie zdefiniowany tag ma określoną nazwę, New-AzTag dodaje określoną wartość do tagu o tej nazwie zamiast tworzenia nowego tagu.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResourceId

Identyfikator zasobu jednostki, która jest oznaczana. Zasób, grupa zasobów lub subskrypcja może zostać otagowany.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Tag

Tagi do umieszczenia w zasobie.

Typ:Hashtable
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Value

Określa wstępnie zdefiniowaną wartość tagu. Wstępnie zdefiniowane tagi mogą mieć wiele wartości, ale w każdym poleceniu można wprowadzić tylko jedną wartość. Ten parametr jest opcjonalny, ponieważ tagi mogą mieć nazwy bez wartości.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Hashtable

Dane wyjściowe

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