Udostępnij za pośrednictwem

Get-AzResourceGroup

Moduł:
Az.Resources Module

Pobiera grupy zasobów.

Składnia

GetByResourceGroupName (domyślnie) 

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

Opis

Polecenie cmdlet Get-AzResourceGroup pobiera Azure grupy zasobów w bieżącej subskrypcji. Możesz pobrać wszystkie grupy zasobów lub określić grupę zasobów według nazwy lub innych właściwości. Domyślnie to polecenie cmdlet pobiera wszystkie grupy zasobów w bieżącej subskrypcji. Aby uzyskać więcej informacji o zasobach Azure i grupach zasobów Azure, zobacz polecenie cmdlet New-AzResourceGroup.

Przykłady

Przykład 1. Pobieranie grupy zasobów według nazwy

Get-AzResourceGroup -Name "EngineerBlog"

To polecenie pobiera Azure grupę zasobów w subskrypcji o nazwie EngineerBlog.

Przykład 2. Pobieranie wszystkich tagów grupy zasobów

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

To polecenie pobiera grupę zasobów o nazwie ContosoRG i wyświetla tagi skojarzone z tą grupą.

Przykład 3. Pobieranie grup zasobów na podstawie tagu

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

Przykład 4. Wyświetlanie grup zasobów według lokalizacji

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

Przykład 5: Wyświetlanie nazw wszystkich grup zasobów w określonej lokalizacji

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

Przykład 6. Pokazywanie grup zasobów, których nazwy zaczynają się od WebServer

Get-AzResourceGroup -Name WebServer*

Przykład 7. Pobieranie grupy zasobów z rozwiniętymi właściwościami

Get-AzResourceGroup -Name "ContosoRG" -ExpandProperties

Parametry

-ApiVersion

Określa wersję interfejsu API obsługiwaną przez dostawcę zasobów. Możesz określić inną wersję niż domyślna.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Właściwości parametru

Typ:IAzureContextContainer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ExpandProperties

Po określeniu dane wyjściowe obejmują wartość CreatedTime i ChangedTime zasobu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Id

Określa identyfikator grupy zasobów do pobrania. Symbole wieloznaczne nie są dozwolone.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator grupy zasobów, Identyfikator zasobu

Zestawy parametrów

GetByResourceGroupId
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Location

Określa lokalizację grupy zasobów do pobrania.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:1
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Name

Określa nazwę grupy zasobów do pobrania. Ten parametr obsługuje symbole wieloznaczne na początku i/lub na końcu ciągu.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False
Aliasy:NazwaGrupyZasobów (ResourceGroupName)

Zestawy parametrów

GetByResourceGroupName
Position:0
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Pre

Wskazuje, że to polecenie cmdlet uwzględnia wersje interfejsu API wersji wstępnej, gdy automatycznie określa wersję do użycia.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Tag

Tabela skrótów tagów do filtrowania grup zasobów według.

Właściwości parametru

Typ:Hashtable
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

GetByResourceGroupName
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

String

Hashtable

Dane wyjściowe

PSResourceGroup