Get-AzureRmResource

Modul:

AzureRM.Resources

Erőforrásokat szerez be.

Figyelmeztetés

Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.

Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.

Syntax

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

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

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

Description

A Get-AzureRmResource parancsmag lekéri az Azure-erőforrásokat.

Példák

1. példa: Az aktuális előfizetés összes erőforrásának lekérése

PS C:\> Get-AzureRmResource | ft

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

Ez a parancs az aktuális előfizetés összes erőforrását lekéri.

2. példa: Az összes erőforrás lekérése egy erőforráscsoportban

PS C:\> Get-AzureRmResource -ResourceGroupName testRG | ft

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

Ez a parancs lekéri a "testRG" erőforráscsoport összes erőforrását.

3. példa: Az összes erőforrás lekérése, amelynek erőforráscsoportja megfelel a megadott helyettesítő karakternek

PS C:\> Get-AzureRmResource -ResourceGroupName other* | ft

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

Ez a parancs lekéri az összes olyan erőforrást, amelynek erőforráscsoportja az "egyéb" lények közé tartozik.

4. példa: Az összes erőforrás lekérése adott névvel

PS C:\> Get-AzureRmResource -Name testVM | fl

Name              : testVM
ResourceGroupName : testRG
ResourceType      : Microsoft.Compute/virtualMachines
Location          : westus
ResourceId        : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM

Ez a parancs lekéri az összes olyan erőforrást, amelynek az erőforrás neve "testVM".

5. példa: Az összes olyan erőforrás lekérése, amelynek a neve megegyezik a megadott helyettesítő karakterlel

PS C:\> Get-AzureRmResource -Name test* | ft

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

Ez a parancs lekéri az összes olyan erőforrást, amelynek az erőforrásneve "teszttel" kezdődik.

6. példa: Egy adott erőforrástípus összes erőforrásának lekérése

PS C:\> Get-AzureRmResource -ResourceType Microsoft.Compute/virtualMachines | ft

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

Ez a parancs lekéri az összes erőforrást az aktuális előfizetésekben, amelyek virtuális gépek.

7. példa: Erőforrás lekérése erőforrás-azonosító alapján

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

Ez a parancs lekéri az erőforrást a megadott erőforrás-azonosítóval, amely egy "testVM" nevű virtuális gép a "testRG" erőforráscsoportban.

Paraméterek

-ApiVersion

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés

Típus:	IAzureContextContainer
Aliasok:	AzureRmContext, AzureCredential
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ExpandProperties

Ha meg van adva, kibontja az erőforrás tulajdonságait.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Name

A lekérendő erőforrás(ok) neve. Ez a paraméter támogatja a karakterlánc elején és/vagy végén található helyettesítő karaktereket.

Típus:	String
Aliasok:	ResourceName
Position:	0
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ODataQuery

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Pre

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ResourceGroupName

A kivont erőforráscsoport(ok)ba tartozik. Ez a paraméter támogatja a karakterlánc elején és/vagy végén található helyettesítő karaktereket.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ResourceId

A teljes erőforrás-azonosítót adja meg, ahogyan az alábbi példában is látható /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Compute/virtualMachines

Típus:	String
Aliasok:	Id
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-ResourceType

A lekérendő erőforrás(ok) erőforrástípusa. Például: Microsoft.Compute/virtualMachines

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Tag

Lekéri a megadott Azure-címkével rendelkező erőforrásokat. Adjon meg egy név- vagy név- és értékkulcsot tartalmazó kivonattáblát. A helyettesítő karakterek nem támogatottak. A "címke" egy név-érték pár, amelyet erőforrásokra és erőforráscsoportokra alkalmazhat. Címkék használatával kategorizálhatja az erőforrásokat, például részleg vagy költséghely szerint, vagy nyomon követheti az erőforrásokra vonatkozó megjegyzéseket vagy megjegyzéseket. Ha címkét szeretne hozzáadni egy erőforráshoz, használja a New-AzureRmResource vagy a Set-AzureRmResource parancsmagok Címke paraméterét. Előre definiált címke létrehozásához használja a New-AzureRmTag parancsmagot. A Windows PowerShell kivonattábláival kapcsolatos segítségért futtassa a "Get-Help about_Hashtables" parancsot.

Típus:	Hashtable
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-TagName

A lekérendő erőforrás(ok) címkéjének kulcsa.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-TagValue

A lekérendő erőforrás(ok) címkéjében szereplő érték.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

Bevitelek

None

Kimenetek

Microsoft.Azure.Commands.ResourceManagement.Models.PSResource

Kapcsolódó hivatkozások

• Move-AzureRmResource
• New-AzureRmResource
• Remove-AzureRmResource
• Set-AzureRmResource