Get-AzTag

  • Odwołanie
Moduł:
Az.Resources

Pobiera wstępnie zdefiniowane tagi platformy Azure | Pobiera cały zestaw tagów w zasobie lub subskrypcji.

Składnia

Get-AzTag
   [[-Name] <String>]
   [-Detailed]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzTag
   -ResourceId <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Opis

GetPredefinedTagSet: polecenie cmdlet Get-AzTag pobiera wstępnie zdefiniowane tagi platformy Azure w subskrypcji. To polecenie cmdlet zwraca podstawowe informacje o tagach lub szczegółowych informacjach o tagach i ich wartościach. Wszystkie obiekty wyjściowe zawierają właściwość Count, która reprezentuje liczbę zasobów i grup zasobów, do których zastosowano tagi i wartości. Moduł Azure Tags, który jest częścią polecenia Get-AzTag , 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 utworzyć wstępnie zdefiniowany tag, użyj polecenia cmdlet New-AzTag. Aby zastosować wstępnie zdefiniowany tag do grupy zasobów, użyj parametru Tag polecenia cmdlet New-AzTag. Aby wyszukać grupy zasobów pod kątem określonej nazwy tagu lub nazwy i wartości, użyj parametru Tag polecenia cmdlet Get-AzResourceGroup.

GetByResourceIdParameterSet: polecenie cmdlet Get-AzTag z identyfikatorem ResourceId pobiera cały zestaw tagów w zasobie lub subskrypcji.

Przykłady

Przykład 1. Pobieranie wszystkich wstępnie zdefiniowanych tagów

Get-AzTag

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

Department    5
FY2015        2
CostCenter   20

To polecenie pobiera wszystkie wstępnie zdefiniowane tagi w subskrypcji. Właściwość Count pokazuje, ile razy tag został zastosowany do zasobów i grup zasobów w subskrypcji.

Przykład 2. Pobieranie tagu według nazwy

Get-AzTag -Name "Department"

Name:   Department
Count:  5
Values: 

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

        Finance       2
        IT            3

To polecenie pobiera szczegółowe informacje o tagu Dział i jego wartościach. Właściwość Count pokazuje, ile razy tag i każda z jego wartości została zastosowana do zasobów i grup zasobów w subskrypcji.

Przykład 3. Pobieranie wartości wszystkich tagów

Get-AzTag -Detailed

Name:   Department
Count:  5
Values: 

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

        Finance       2
        IT            3


Name:   FY2015
Count:  2


Name:   CostCenter
Count:  20
Values: 

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

        0001          5
        0002         10
        0003          5

To polecenie używa parametru Szczegółowe, aby uzyskać szczegółowe informacje o wszystkich wstępnie zdefiniowanych tagach w subskrypcji. Użycie parametru Szczegółowe jest odpowiednikiem użycia parametru Name dla każdego tagu.

Przykład 4. Pobieranie całego zestawu tagów w subskrypcji

Get-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

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

To polecenie pobiera cały zestaw tagów w subskrypcji z {subId}.

Przykład 5. Pobieranie całego zestawu tagów w zasobie

Get-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1

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

To polecenie pobiera cały zestaw tagów w zasobie z {resourceId}.

Parametry

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Detailed

Wskazuje, że ta operacja dodaje informacje o wartościach tagów do danych wyjściowych.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Nazwa wstępnie zdefiniowanego tagu. Domyślnie polecenie Get-AzTag pobiera podstawowe informacje o wszystkich wstępnie zdefiniowanych tagach w subskrypcji. Po określeniu parametru Name parametr szczegółowy nie ma efektu.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

Identyfikator zasobu jednostki oznakowanej. Zasób, grupa zasobów lub subskrypcja może zostać otagowany.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Dane wejściowe

String

SwitchParameter

Dane wyjściowe

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