Dela via


Get-AzureRmResourceGroup

Hämtar resursgrupper.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

Syntax

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

Description

Cmdleten Get-AzureRmResourceGroup 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-AzureRmResourceGroup.

Exempel

Exempel 1: Hämta en resursgrupp efter namn

PS C:\>Get-AzureRmResourceGroup -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

PS C:\>(Get-AzureRmResourceGroup -Name "ContosoRG").Tags

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

Exempel 3: Visa resursgrupper efter plats

PS C:\> Get-AzureRmResourceGroup |
  Sort Location,ResourceGroupName |
  Format-Table -GroupBy Location ResourceGroupName,ProvisioningState,Tags

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

PS C:\> Get-AzureRmResourceGroup -Location westus2 |
   Sort ResourceGroupName | 
   Format-Wide ResourceGroupName -Column 4

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

PS C:\> Get-AzureRmResourceGroup | Where ResourceGroupName -like 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: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:Named
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:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-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

None

Utdata

Microsoft.Azure.Commands.ResourceManagement.PSResourceGroup