Sdílet prostřednictvím

Get-AzResourceGroup

Modul:
Az.Resources Module

Získá skupiny prostředků.

Syntax

GetByResourceGroupName (Výchozí) 

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

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*

Příklad 7: Získání skupiny prostředků s rozbalenými vlastnostmi

Get-AzResourceGroup -Name "ContosoRG" -ExpandProperties

Parametry

-ApiVersion

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DefaultProfile

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

Vlastnosti parametru

Typ:IAzureContextContainer
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ExpandProperties

Pokud zadáte, výstup zahrnuje CreatedTime a ChangedTime prostředku.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Id

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:ID skupiny prostředků, ResourceId

Sady parametrů

GetByResourceGroupId
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Location

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:True
DontShow:False
Aliasy:ResourceGroupName

Sady parametrů

GetByResourceGroupName
Position:0
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Pre

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Tag

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

Vlastnosti parametru

Typ:Hashtable
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

GetByResourceGroupName
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

Hashtable

Výstupy

PSResourceGroup