Dela via

Get-AzResourceGroup

  • Referens
Modul:
Az.Resources

Hämtar resursgrupper.

Syntax

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

Cmdleten Get-AzResourceGroup hämtar Azure-resursgrupper i den aktuella prenumerationen. Du kan hämta alla resursgrupper eller ange en resursgrupp efter namn eller efter andra egenskaper. Som standard hämtar den här cmdleten alla resursgrupper i den aktuella prenumerationen. Mer information om Azure-resurser och Azure-resursgrupper finns i cmdleten New-AzResourceGroup.

Exempel

Exempel 1: Hämta en resursgrupp efter namn

Get-AzResourceGroup -Name "EngineerBlog"

Det här kommandot hämtar Azure-resursgruppen i din prenumeration med namnet EngineerBlog.

Exempel 2: Hämta alla taggar för en resursgrupp

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

Det här kommandot hämtar resursgruppen med namnet ContosoRG och visar taggarna som är associerade med den gruppen.

Exempel 3: Hämta resursgrupper baserat på tagg

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

Exempel 4: Visa resursgrupper efter plats

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

Exempel 5: Visa namnen på alla resursgrupper på en viss plats

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

Exempel 6: Visa de resursgrupper vars namn börjar med WebServer

Get-AzResourceGroup -Name WebServer*

Parametrar

-ApiVersion

Anger den API-version som stöds av resursprovidern. Du kan ange en annan version än standardversionen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Id

Anger ID för resursgruppen som ska hämtas. Jokertecken tillåts inte.

Typ:String
Alias:ResourceGroupId, ResourceId
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Location

Anger platsen för den resursgrupp som ska hämtas.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger namnet på resursgruppen som ska hämtas. Den här parametern stöder jokertecken i början och/eller slutet av strängen.

Typ:String
Alias:ResourceGroupName
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-Pre

Anger att den här cmdleten tar hänsyn till förhandsversioner av API:et när den automatiskt avgör vilken version som ska användas.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Tag

Taggen hashtable för att filtrera resursgrupper efter.

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

String

Hashtable

Utdata

PSResourceGroup