Udostępnij przez


Get-AzTag

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

Składnia

GetPredefinedTagParameterSet

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

GetByResourceIdParameterSet

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.

Właściwości parametrów

Typ:IAzureContextContainer
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Detailed

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

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

GetPredefinedTagParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

GetPredefinedTagParameterSet
Pozycja:0
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-ResourceId

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

GetByResourceIdParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wejścia

String

SwitchParameter

Wyjść

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