Get-AzTag
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.
Typ: | IAzureContextContainer |
Aliasy: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Detailed
Wskazuje, że ta operacja dodaje informacje o wartościach tagów do danych wyjściowych.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | 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.
Typ: | String |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-ResourceId
Identyfikator zasobu jednostki oznakowanej. Zasób, grupa zasobów lub subskrypcja może zostać otagowany.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
Dane wyjściowe
Microsoft.Azure.Commands.ResourceManager.Common.Tags.PSTag | Microsoft.Azure.Commands.Tags.Model.PSTagResource