Sdílet prostřednictvím

Get-AzResourceGroup

  • Reference
Modul:
Az.Resources

Získá skupiny prostředků.

Syntaxe

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

Description

Rutina Get-AzResourceGroup získá skupiny prostředků Azure v aktuálním předplatném. Můžete získat všechny skupiny prostředků nebo zadat skupinu prostředků podle názvu nebo podle jiných vlastností. Ve výchozím nastavení získá tato rutina všechny skupiny prostředků v aktuálním předplatném. Další informace o prostředcích Azure a skupinách prostředků Azure najdete v rutině New-AzResourceGroup.

Příklady

Příklad 1: Získání skupiny prostředků podle názvu

Get-AzResourceGroup -Name "EngineerBlog"

Tento příkaz získá skupinu prostředků Azure ve vašem předplatném s názvem EngineerBlog.

Příklad 2: Získání všech značek skupiny prostředků

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

Tento příkaz získá skupinu prostředků s názvem ContosoRG a zobrazí značky přidružené k této skupině.

Příklad 3: Získání skupin prostředků na základě značky

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

Příklad 4: Zobrazení skupin prostředků podle umístění

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

Příklad 5: Zobrazení názvů všech skupin prostředků v určitém umístění

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

Příklad 6: Zobrazení skupin prostředků, jejichž názvy začínají webovým serverem

Get-AzResourceGroup -Name WebServer*

Parametry

-ApiVersion

Určuje verzi rozhraní API podporovanou poskytovatelem prostředků. Můžete zadat jinou verzi, než je výchozí verze.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Id

Určuje ID skupiny prostředků, která se má získat. Zástupné znaky nejsou povoleny.

Typ:String
Aliasy:ResourceGroupId, ResourceId
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Location

Určuje umístění skupiny prostředků, která se má získat.

Typ:String
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje název skupiny prostředků, která se má získat. Tento parametr podporuje zástupné znaky na začátku nebo na konci řetězce.

Typ:String
Aliasy:ResourceGroupName
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-Pre

Označuje, že tato rutina bere v úvahu předběžné verze rozhraní API, když automaticky určí, kterou verzi použít.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Tag

Hashtable značky pro filtrování skupin prostředků podle.

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

String

Hashtable

Výstupy

PSResourceGroup