Delen via


Get-AzResourceGroup

Hiermee haalt u resourcegroepen op.

Syntaxis

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>]

Description

De cmdlet Get-AzResourceGroup haalt Azure-resourcegroepen op in het huidige abonnement. U kunt alle resourcegroepen ophalen of een resourcegroep opgeven op naam of op andere eigenschappen. Deze cmdlet haalt standaard alle resourcegroepen op in het huidige abonnement. Zie de cmdlet New-AzResourceGroup voor meer informatie over Azure-resources en Azure-resourcegroepen.

Voorbeelden

Voorbeeld 1: Een resourcegroep ophalen op naam

Get-AzResourceGroup -Name "EngineerBlog"

Met deze opdracht wordt de Azure-resourcegroep opgehaald in uw abonnement met de naam EngineerBlog.

Voorbeeld 2: Alle tags van een resourcegroep ophalen

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

Met deze opdracht wordt de resourcegroep ContosoRG ophaalt en worden de tags weergegeven die aan die groep zijn gekoppeld.

Voorbeeld 3: Resourcegroepen ophalen op basis van tag

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

Voorbeeld 4: De resourcegroepen weergeven op locatie

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

Voorbeeld 5: De namen van alle resourcegroepen op een bepaalde locatie weergeven

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

Voorbeeld 6: De resourcegroepen weergeven waarvan de namen beginnen met WebServer

Get-AzResourceGroup -Name WebServer*

Parameters

-ApiVersion

Hiermee geeft u de API-versie op die wordt ondersteund door de resourceprovider. U kunt een andere versie opgeven dan de standaardversie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Id

Hiermee geeft u de id van de resourcegroep op die u wilt ophalen. Jokertekens zijn niet toegestaan.

Type:String
Aliassen:ResourceGroupId, ResourceId
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Location

Hiermee geeft u de locatie van de resourcegroep die u wilt ophalen.

Type:String
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van de resourcegroep die u wilt ophalen. Deze parameter ondersteunt jokertekens aan het begin en/of het einde van de tekenreeks.

Type:String
Aliassen:ResourceGroupName
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

-Pre

Hiermee wordt aangegeven dat deze cmdlet api-versies van de voorlopige versie beschouwt wanneer deze automatisch bepaalt welke versie moet worden gebruikt.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Tag

De tag-hashtabel waarop resourcegroepen moeten worden gefilterd.

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

String

Hashtable

Uitvoerwaarden

PSResourceGroup