次の方法で共有

Get-AzTag

  • リファレンス
モジュール:
Az.Resources

定義済みの Azure タグを取得する |リソースまたはサブスクリプションのタグのセット全体を取得します。

構文

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

説明

GetPredefinedTagSet: Get-AzTag コマンドレットは、サブスクリプションに定義済みの Azure タグを取得します。 このコマンドレットは、タグに関する基本情報、またはタグとその値に関する詳細情報を返します。 すべての出力オブジェクトには、タグと値が適用されたリソースとリソース グループの数を表す Count プロパティが含まれます。 Get-AzTag を Azure Tags モジュールは、定義済みの Azure タグを管理するのに役立ちます。 Azure タグは、部門やコスト センターなど、Azure リソースとリソース グループを分類したり、リソースやグループに関するメモやコメントを追跡したりするために使用できる名前と値のペアです。 タグは 1 つの手順で定義して適用できますが、定義済みのタグを使用すると、サブスクリプション内のタグの標準的で一貫性のある予測可能な名前と値を確立できます。 定義済みのタグを作成するには、New-AzTag コマンドレットを使用します。 定義済みのタグをリソース グループに適用するには、New-AzTag コマンドレットの Tag パラメーターを使用します。 リソース グループで特定のタグ名または名前と値を検索するには、Get-AzResourceGroup コマンドレットの Tag パラメーターを使用します。

GetByResourceIdParameterSet: ResourceId を持つ Get-AzTag コマンドレット、リソースまたはサブスクリプションのタグのセット全体を取得します。

例

例 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
Aliases:AzContext, AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Detailed

この操作によって、タグ値に関する情報が出力に追加されることを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

定義済みのタグの名前。 既定では、Get-AzTag は、サブスクリプション内のすべての定義済みタグに関する基本情報を取得します。 Name パラメーターを指定すると、Detailed パラメーターは無効になります。

型:String
配置:0
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ResourceId

タグ付けされたエンティティのリソース識別子。 リソース、リソース グループ、またはサブスクリプションにタグを付ける場合があります。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

入力

String

SwitchParameter

出力

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