你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Get-AzResourceGroup

获取资源组。

语法

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 cmdlet 获取当前订阅中的 Azure 资源组。 可以获取所有资源组,也可以按名称或其他属性指定资源组。 默认情况下,此 cmdlet 获取当前订阅中的所有资源组。 有关 Azure 资源和 Azure 资源组的详细信息,请参阅 New-AzResourceGroup cmdlet。

示例

示例 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 版本。 可以指定与默认版本不同的版本。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

用于与 azure 通信的凭据、帐户、租户和订阅

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Id

指定要获取的资源组的 ID。 不允许使用通配符。

类型:String
别名:ResourceGroupId, ResourceId
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Location

指定要获取的资源组的位置。

类型:String
Position:1
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Name

指定要获取的资源组的名称。 此参数支持字符串开头和/或末尾的通配符。

类型:String
别名:ResourceGroupName
Position:0
默认值:None
必需:False
接受管道输入:True
接受通配符:True

-Pre

指示此 cmdlet 在自动确定要使用的版本时会考虑预发布 API 版本。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Tag

要按其筛选资源组的标记哈希表。

类型:Hashtable
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

输入

String

Hashtable

输出

PSResourceGroup