Udostępnij za pośrednictwem

Get-AzResourceGroup

  • Odwołanie
Moduł:
Az.Resources

Pobiera grupy zasobów.

Składnia

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

Opis

Polecenie cmdlet Get-AzResourceGroup pobiera grupy zasobów platformy Azure 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 na temat zasobów platformy Azure i grup zasobów platformy 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 grupę zasobów platformy Azure 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*

Parametry

-ApiVersion

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Id

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

Typ:String
Aliasy:ResourceGroupId, ResourceId
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Location

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

Typ:String
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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.

Typ:String
Aliasy:ResourceGroupName
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-Pre

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Tag

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

Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Hashtable

Dane wyjściowe

PSResourceGroup