Get-AzResourceGroup

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

リソース グループを取得します。

構文

Get-AzResourceGroup
   [[-Name] <String>]
   [[-Location] <String>]
   [-Tag <Hashtable>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzResourceGroup
   [[-Location] <String>]
   [-Id <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

Get-AzResourceGroup コマンドレットは、現在のサブスクリプション内の Azure リソース グループを取得します。 すべてのリソース グループを取得することも、名前やその他のプロパティでリソース グループを指定することもできます。 既定では、このコマンドレットは現在のサブスクリプション内のすべてのリソース グループを取得します。 Azure リソースと Azure リソース グループの詳細については、New-AzResourceGroup コマンドレットを参照してください。

例

例 1: 名前でリソース グループを取得する

Get-AzResourceGroup -Name "EngineerBlog"

このコマンドは、EngineerBlog という名前のサブスクリプション内の Azure リソース グループを取得します。

例 2: リソース グループのすべてのタグを取得する

(Get-AzResourceGroup -Name "ContosoRG").Tags

このコマンドは、ContosoRG という名前のリソース グループを取得し、そのグループに関連付けられているタグを表示します。

例 3: タグに基づいてリソース グループを取得する

Get-AzResourceGroup -Tag @{'environment'='prod'}

例 4: 場所別にリソース グループを表示する

Get-AzResourceGroup |
  Sort-Object Location,ResourceGroupName |
    Format-Table -GroupBy Location ResourceGroupName,ProvisioningState,Tags

例 5: 特定の場所にあるすべてのリソース グループの名前を表示する

Get-AzResourceGroup -Location westus2 |
  Sort-Object ResourceGroupName |
    Format-Wide ResourceGroupName -Column 4

例 6: 名前が WebServer で始まるリソース グループを表示する

Get-AzResourceGroup -Name WebServer*

パラメーター

-ApiVersion

リソース プロバイダーでサポートされている API バージョンを指定します。 既定のバージョンとは異なるバージョンを指定できます。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

取得するリソース グループの ID を指定します。 ワイルドカード文字は使用できません。

Type:String
Aliases:ResourceGroupId, ResourceId
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

取得するリソース グループの場所を指定します。

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

取得するリソース グループの名前を指定します。 このパラメーターは、文字列の先頭または末尾でワイルドカードをサポートします。

Type:String
Aliases:ResourceGroupName
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Pre

このコマンドレットは、使用するバージョンを自動的に決定するときに、プレリリース API バージョンを考慮することを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

リソース グループをフィルター処理するタグ ハッシュテーブル。

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

入力

String

Hashtable

出力

PSResourceGroup