Dela via

Get-AzResourceGroup

Modul:
Az.Resources Module

Hämtar resursgrupper.

Syntax

GetByResourceGroupName (Standard) 

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

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*

Exempel 7: Hämta en resursgrupp med expanderade egenskaper

Get-AzResourceGroup -Name "ContosoRG" -ExpandProperties

Parametrar

-ApiVersion

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

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

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ExpandProperties

När det anges inkluderar utdata CreatedTime och ChangedTime för en resurs.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Id

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:ResourceGroupId (på engelska), ResourceId

Parameteruppsättningar

GetByResourceGroupId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Location

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:1
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:True
DontShow:False
Alias:ResourceGroupName

Parameteruppsättningar

GetByResourceGroupName
Position:0
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Tag

Taggen hashtable för att filtrera resursgrupper efter.

Parameteregenskaper

Typ:Hashtable
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

GetByResourceGroupName
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

Hashtable

Utdata

PSResourceGroup