Get-AzTag
取得預先定義的 Azure 標籤 |取得資源或訂用帳戶上的整個標記集。
語法
Get-AzTag
[[-Name] <String>]
[-Detailed]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzTag
-ResourceId <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
GetPredefinedTagSet： Get-AzTag Cmdlet 會取得訂用帳戶中預先定義的 Azure 卷標。 此 Cmdlet 會傳回標記的基本資訊，或標記及其值的詳細資訊。 所有輸出物件都包含 Count 屬性，代表已套用標記和資源群組的資源和資源群組數目。 Get-AzTag 所屬的 Azure 標記模組可協助您管理預先定義的 Azure 標籤。 Azure 標籤是一組名稱/值組，可用來分類 Azure 資源和資源群組，例如依部門或成本中心，或追蹤有關資源和群組的附註或批註。 您可以在單一步驟中定義和套用標籤，但預先定義的標籤可讓您為訂用帳戶中的標記建立標準、一致、可預測的名稱和值。 若要建立預先定義的標籤，請使用 New-AzTag Cmdlet。 若要將預先定義的標籤套用至資源群組，請使用 New-AzTag Cmdlet 的 Tag 參數。 若要搜尋特定標籤名稱或名稱和值的資源群組，請使用 Get-AzResourceGroup Cmdlet 的 Tag 參數。
GetByResourceIdParameterSet：具有 ResourceId 的 Get-AzTag Cmdlet 會取得資源或訂用帳戶上的整個標記集。
範例
範例 1：取得所有預先定義的標籤
Get-AzTag
Name Count
======== =====
Department 5
FY2015 2
CostCenter 20此命令會取得訂用帳戶中的所有預先定義標籤。 Count 屬性會顯示標籤已套用至訂用帳戶中的資源和資源群組的次數。
範例 2：依名稱取得標記
Get-AzTag -Name "Department"
Name: Department
Count: 5
Values:
Name Count
========== =====
Finance 2
IT 3此命令會取得 Department 標籤及其值的詳細資訊。 Count 屬性會顯示標記及其每個值已套用至訂用帳戶中的資源和資源群組的次數。
範例 3：取得所有標籤的值
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此命令會 使用 Detailed 參數來取得訂用帳戶中所有預先定義標籤的詳細資訊。 使用 Detailed 參數相當於針對每個標記使用 Name 參數。
範例 4：取得訂用帳戶上的整個標記集
Get-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Id : {Id}
Name : {Name}
Type : {Type}
Properties :
Name Value
======= =========
tagKey1 tagValue1
tagKey2 tagValue2此命令會使用 {subId} 取得訂用帳戶上的整個標記集。
範例 5：取得資源上的整個標記集
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此命令會使用 {resourceId} 取得資源上的整個標記集。
參數
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
| 類型: | IAzureContextContainer |
| 別名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Detailed
表示這項作業會將標籤的相關信息新增至輸出。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Name
預先定義的標籤名稱。 根據預設， Get-AzTag 會取得訂用帳戶中所有預先定義標籤的基本資訊。 當您指定 Name 參數時， Detailed 參數沒有任何作用。
| 類型: | String |
| Position: | 0 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ResourceId
標記實體的資源標識碼。 可能會標記資源、資源群組或訂用帳戶。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
輸入
輸出
Microsoft.Azure.Commands.ResourceManager.Common.Tags.PSTag | Microsoft.Azure.Commands.Tags.Model.PSTagResource
