Get-AzureRmTag
取得預先定義的 Azure 標籤。
警告
自 2024 年 2 月 29 日起,AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組,以確保持續支援和更新。
雖然 AzureRM 模組可能仍可運作,但不再維護或支援它,但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引,請參閱我們的 移轉資源 。
Syntax
Get-AzureRmTag
[[-Name] <String>]
[-Detailed]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Get-AzureRmTag Cmdlet 會取得訂用帳戶中預先定義的 Azure 標籤。 此 Cmdlet 會傳回標記的基本資訊,或標記及其值的詳細資訊。 所有輸出物件都包含 Count 屬性,代表已套用標記和資源群組的資源和資源群組數目。 Get-AzureRMTag 所屬的 Azure 標記模組可協助您管理預先定義的 Azure 標籤。 Azure 標籤是一組名稱/值組,可用來分類 Azure 資源和資源群組,例如依部門或成本中心,或追蹤有關資源和群組的附註或批註。 您可以在單一步驟中定義和套用標籤,但預先定義的標籤可讓您為訂用帳戶中的標記建立標準、一致、可預測的名稱和值。 若要建立預先定義的標籤,請使用 New-AzureRmTag Cmdlet。 若要將預先定義的標籤套用至資源群組,請使用 New-AzureRmTag Cmdlet 的 Tag 參數。 若要搜尋特定標籤名稱或名稱和值的資源群組,請使用 Get-AzureRMResourceGroup Cmdlet 的 Tag 參數。
範例
範例 1:取得所有預先定義的標籤
PS C:\>Get-AzureRmTag
Name Count
======== =====
Department 5
FY2015 2
CostCenter 20
此命令會取得訂用帳戶中的所有預先定義標籤。 Count 屬性會顯示標籤已套用至訂用帳戶中的資源和資源群組的次數。
範例 2:依名稱取得標記
PS C:\>Get-AzureRmTag -Name "Department"
Name: Department
Count: 5
Values:
Name Count
========== =====
Finance 2
IT 3
此命令會取得 Department 標籤及其值的詳細資訊。 Count 屬性會顯示標記及其每個值已套用至訂用帳戶中的資源和資源群組的次數。
範例 3:取得所有標籤的值
PS C:\>Get-AzureRmTag -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 參數。
參數
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Detailed
表示這項作業會將標籤的相關信息新增至輸出。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
指定要取得的標記名稱。 根據預設, Get-AzureRmTag 會取得訂用帳戶中所有預先定義標籤的基本資訊。 當您指定 Name 參數時, Detailed 參數沒有任何作用。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |