Udostępnij przez

Get-AzResource

Moduł:
Az.Resources Module

Pobiera zasoby.

Składnia

ByTagNameValueParameterSet (domyślnie) 

Get-AzResource
    [-Name <String>]
    [-ResourceType <String>]
    [-ODataQuery <String>]
    [-ResourceGroupName <String>]
    [-TagName <String>]
    [-TagValue <String>]
    [-ExpandProperties]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByResourceId 

Get-AzResource
    -ResourceId <String>
    [-ODataQuery <String>]
    [-ExpandProperties]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ByTagObjectParameterSet 

Get-AzResource
    -Tag <Hashtable>
    [-Name <String>]
    [-ResourceType <String>]
    [-ODataQuery <String>]
    [-ResourceGroupName <String>]
    [-ExpandProperties]
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Opis

Polecenie cmdlet Get-AzResource pobiera zasoby platformy Azure.

Przykłady

Przykład 1. Pobieranie wszystkich zasobów w bieżącej subskrypcji

Get-AzResource | Format-Table

Name    ResourceGroupName  ResourceType                            Location
----    -----------------  ------------                            --------
testVM  testRG             Microsoft.Compute/virtualMachines       westus
disk    testRG             Microsoft.Compute/disks                 westus
nic     testRG             Microsoft.Network/networkInterfaces     westus
nsg     testRG             Microsoft.Network/networkSecurityGroups westus
ip      testRG             Microsoft.Network/publicIPAddresses     westus
vnet    testRG             Microsoft.Network/virtualNetworks       westus
testKV  otherRG            Microsoft.KeyVault/vaults               eastus
storage otherResourceGroup Microsoft.Storage/storageAccounts       eastus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines       eastus

To polecenie pobiera wszystkie zasoby w bieżącej subskrypcji.

Przykład 2. Pobieranie wszystkich zasobów w grupie zasobów

Get-AzResource -ResourceGroupName testRG | Format-Table

Name   ResourceGroupName ResourceType                            Location
----   ----------------- ------------                            --------
testVM testRG            Microsoft.Compute/virtualMachines       westus
disk   testRG            Microsoft.Compute/disks                 westus
nic    testRG            Microsoft.Network/networkInterfaces     westus
nsg    testRG            Microsoft.Network/networkSecurityGroups westus
ip     testRG            Microsoft.Network/publicIPAddresses     westus
vnet   testRG            Microsoft.Network/virtualNetworks       westus

To polecenie pobiera wszystkie zasoby w grupie zasobów "testRG".

Przykład 3. Pobieranie wszystkich zasobów, których grupa zasobów jest zgodna z podanymi symbolami wieloznacznymi

Get-AzResource -ResourceGroupName other* | Format-Table

Name    ResourceGroupName  ResourceType                      Location
----    -----------------  ------------                      --------
testKV  otherRG            Microsoft.KeyVault/vaults         eastus
storage otherResourceGroup Microsoft.Storage/storageAccounts eastus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus

To polecenie pobiera wszystkie zasoby, których grupa zasobów należą do istot z "innym".

Przykład 4. Pobieranie wszystkich zasobów o podanej nazwie

Get-AzResource -Name testVM | Format-List

Name              : testVM
ResourceGroupName : testRG
ResourceType      : Microsoft.Compute/virtualMachines
Location          : westus
ResourceId        : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM
Tags              :
                    Name    Value
                    ======  ========
                    Dept    IT
                    Year    2002
                    Status  Approved

To polecenie pobiera wszystkie zasoby, których nazwa zasobu to "testVM".

Przykład 5. Pobieranie wszystkich zasobów, których nazwa jest zgodna z podanym symbolem wieloznacznymi

Get-AzResource -Name test* | Format-Table

Name    ResourceGroupName  ResourceType                      Location
----    -----------------  ------------                      --------
testVM  testRG             Microsoft.Compute/virtualMachines westus
testKV  otherRG            Microsoft.KeyVault/vaults         eastus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus

To polecenie pobiera wszystkie zasoby, których nazwa zasobu zaczyna się od "test".

Przykład 6. Pobieranie wszystkich zasobów danego typu zasobu

Get-AzResource -ResourceType Microsoft.Compute/virtualMachines | Format-Table

Name    ResourceGroupName  ResourceType                      Location
----    -----------------  ------------                      --------
testVM  testRG             Microsoft.Compute/virtualMachines westus
testVM2 otherResourceGroup Microsoft.Compute/virtualMachines eastus

To polecenie pobiera wszystkie zasoby w bieżących subskrypcjach, które są maszynami wirtualnymi.

Przykład 7. Pobieranie zasobu według identyfikatora zasobu

Get-AzResource -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM

Name              : testVM
ResourceGroupName : testRG
ResourceType      : Microsoft.Compute/virtualMachines
Location          : westus
ResourceId        : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM
Tags              :
                    Name    Value
                    ======  ========
                    Dept    IT
                    Year    2002
                    Status  Approved

To polecenie pobiera zasób o podanym identyfikatorze zasobu, który jest maszyną wirtualną o nazwie "testVM" w grupie zasobów "testRG".

Przykład 8. Pobieranie zasobu z rozwiniętymi właściwościami

Get-AzResource -Name testVM -ResourceGroupName testRG -ExpandProperties

To polecenie pobiera zasób o nazwie "testVM" w grupie zasobów "testRG" i rozszerza właściwości, aby uwzględnić dodatkowe szczegóły, takie jak CreatedTime, ChangedTime i inne metadane zasobów.

Parametry

-ApiVersion

Polecenie cmdlet Get-AzResource pobiera zasoby platformy Azure.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

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

-DefaultProfile

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

Właściwości parametru

Typ:IAzureContextContainer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zestawy parametrów

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

-ExpandProperties

Po określeniu rozszerza właściwości zasobu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

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

-Name

Nazwa zasobów do pobrania. Ten parametr obsługuje symbole wieloznaczne na początku i/lub na końcu ciągu.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False
Aliasy:NazwaZasobu

Zestawy parametrów

ByTagNameValueParameterSet
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False
ByTagObjectParameterSet
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ODataQuery

Polecenie cmdlet Get-AzResource pobiera zasoby platformy Azure.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

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

-Pre

Polecenie cmdlet Get-AzResource pobiera zasoby platformy Azure.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

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

-ResourceGroupName

Grupa zasobów, do których jest pobierany zasób, należy. Ten parametr obsługuje symbole wieloznaczne na początku i/lub na końcu ciągu.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

ByTagNameValueParameterSet
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False
ByTagObjectParameterSet
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ResourceId

Określa w pełni kwalifikowany identyfikator zasobu, jak w poniższym przykładzie /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Compute/virtualMachines

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Id

Zestawy parametrów

ByResourceId
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-ResourceType

Typ zasobu, który ma zostać pobrany. Na przykład Microsoft.Compute/virtualMachines

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ByTagNameValueParameterSet
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False
ByTagObjectParameterSet
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Tag

Pobiera zasoby z określonym tagiem platformy Azure. Wprowadź tabelę skrótów z kluczem nazwy lub kluczami Name i Value. Symbole wieloznaczne nie są obsługiwane. "tag" to para nazwa-wartość, którą można zastosować do zasobów i grup zasobów. Tagi umożliwiają kategoryzowanie zasobów, takich jak dział lub centrum kosztów, lub śledzenie notatek lub komentarzy dotyczących zasobów. Aby dodać tag do zasobu, użyj parametru Tag polecenia cmdlet New-AzResource lub Set-AzResource. Aby utworzyć wstępnie zdefiniowany tag, użyj polecenia cmdlet New-AzTag. Aby uzyskać pomoc dotyczącą tabel skrótów w programie Windows PowerShell, uruchom polecenie "Get-Help about_Hashtables".

Właściwości parametru

Typ:Hashtable
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ByTagObjectParameterSet
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-TagName

Klucz w tagu zasobów do pobrania.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ByTagNameValueParameterSet
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-TagValue

Wartość w tagu zasobów do pobrania.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ByTagNameValueParameterSet
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z 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.

Dane wejściowe

String

Dane wyjściowe

PSResource