你当前正在访问 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 版本。 可以指定与默认版本不同的版本。
| 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
指定要获取的资源组的名称。 此参数支持字符串开头和/或末尾的 wild卡s。
| Type: | String |
| Aliases: | ResourceGroupName |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-Pre
指示此 cmdlet 在自动确定要使用的版本时会考虑预发布 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 |