Delen via


Get-AzResourceGroup

Hiermee haalt u resourcegroepen op.

Syntaxis

GetByResourceGroupName (Standaard)

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

GetByResourceGroupId

Get-AzResourceGroup
    [[-Location] <String>]
    [-Id <String>]
    [-ExpandProperties]
    [-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*

Voorbeeld 7: Een resourcegroep ophalen met uitgebreide eigenschappen

Get-AzResourceGroup -Name "ContosoRG" -ExpandProperties

Parameters

-ApiVersion

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

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

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ExpandProperties

Wanneer deze is opgegeven, bevat de uitvoer CreatedTime en ChangedTime van een resource.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Id

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Resourcegroep-ID, ResourceId

Parametersets

GetByResourceGroupId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Location

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:1
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:True
DontShow:False
Aliassen:Naam van Resourcegroep

Parametersets

GetByResourceGroupName
Position:0
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Pre

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Tag

De tag-hashtabel waarop resourcegroepen moeten worden gefilterd.

Parametereigenschappen

Type:Hashtable
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

GetByResourceGroupName
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

Hashtable

Uitvoerwaarden

PSResourceGroup