Udostępnij przez

Get-AzResourceGroup

Moduł:
Az.Resources Module

Pobiera grupy zasobów.

Składnia

GetByResourceGroupName (Domyślne) 

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

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 parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

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

-DefaultProfile

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

Właściwości parametrów

Typ:IAzureContextContainer
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zbiory parametrów

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

-ExpandProperties

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

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

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

-Id

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:Identyfikator grupy zasobów, Identyfikator zasobu

Zbiory parametrów

GetByResourceGroupId
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-Location

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:1
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość 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 parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:True
DontShow:False
Aliasy:NazwaGrupyZasobów (ResourceGroupName)

Zbiory parametrów

GetByResourceGroupName
Pozycja:0
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość 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 parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

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

-Tag

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

Właściwości parametrów

Typ:Hashtable
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

GetByResourceGroupName
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość 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.

Wejścia

String

Hashtable

Wyjść

PSResourceGroup