Udostępnij za pośrednictwem

Get-AzureRmResourceGroup

  • Odwołanie
Moduł:
AzureRM.Resources

Pobiera grupy zasobów.

Ostrzeżenie

Moduł AzureRM PowerShell został oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

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

Opis

Polecenie cmdlet Get-AzureRmResourceGroup 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-AzureRmResourceGroup.

Przykłady

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

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

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

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

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

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

Przykład 4. Wyświetlanie nazw wszystkich grup zasobów w określonej lokalizacji

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

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

PS C:\> Get-AzureRmResourceGroup | Where ResourceGroupName -like 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: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:Named
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:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-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

None

Dane wyjściowe

Microsoft.Azure.Commands.ResourceManagement.PSResourceGroup