Rövid útmutató: Resource Graph-lekérdezés futtatása az Azure PowerShell használatával
Ez a rövid útmutató bemutatja, hogyan futtathat Azure Resource Graph-lekérdezést az Az.ResourceGraph
Azure PowerShell moduljával. A modul része az Azure PowerShell legújabb verziójának, és hozzáadja a Resource Graph parancsmagjait .
A cikk azt is bemutatja, hogyan rendezheti (rendezheti) és korlátozhatja a lekérdezés eredményeit. A bérlői, felügyeleti csoportokban vagy előfizetésekben lévő erőforrásokra vonatkozó lekérdezést futtathat.
Előfeltételek
- Ha még nem rendelkezik Azure-fiókkal, első lépésként hozzon létre egy ingyenes fiókot.
- A PowerShell és az Azure PowerShell legújabb verziói.
- Visual Studio Code.
A modul telepítése
Ha telepítette a PowerShell és az Azure PowerShell legújabb verzióit, már rendelkezik a Az.ResourceGraph
PowerShellGet modullal és szükséges verziójával.
Választható modultelepítés
Az alábbi lépésekkel telepítheti a Az.ResourceGraph
modult, hogy az Azure PowerShell használatával Azure Resource Graph-lekérdezéseket futtasson. Az Azure Resource Graph-modulhoz a PowerShellGet 2.0.1-es vagy újabb verziója szükséges.
Ellenőrizze a PowerShellGet-verziót:
Get-Module -Name PowerShellGet
Ha frissítenie kell, nyissa meg a PowerShellGetet.
Telepítse a modult:
Install-Module -Name Az.ResourceGraph -Repository PSGallery -Scope CurrentUser
A parancs telepíti a modult a
CurrentUser
hatókörben. Ha telepítenie kell aAllUsers
hatókörben, futtassa a telepítést egy rendszergazdai PowerShell-munkamenetből.Ellenőrizze, hogy a modul telepítve van-e:
Get-Command -Module Az.ResourceGraph -CommandType Cmdlet
A parancs megjeleníti a
Search-AzGraph
parancsmag verzióját, és betölti a modult a PowerShell-munkamenetbe.
Csatlakozás az Azure szolgáltatáshoz
Egy Visual Studio Code-terminál munkamenetből csatlakozzon az Azure-hoz. Ha több előfizetéssel rendelkezik, futtassa a parancsokat az előfizetés környezetének beállításához. Cserélje le a <subscriptionID>
értékét a saját Azure-előfizetése azonosítójára.
Connect-AzAccount
# Run these commands if you have multiple subscriptions
Get-AzSubScription
Set-AzContext -Subscription <subscriptionID>
Lekérdezés futtatása
Miután hozzáadta a modult a környezethez, futtathat egy bérlőalapú lekérdezést. A példában szereplő lekérdezés öt Azure-erőforrást ad vissza az name
egyes erőforrásokkal együtt type
. A felügyeleti csoport vagy előfizetés szerinti lekérdezéshez használja a paramétereket vagy -Subscription
a -ManagementGroup
paramétereket.
Azure Resource Graph-lekérdezés futtatása a
Search-AzGraph
parancsmaggal:Search-AzGraph -Query 'Resources | project name, type | limit 5'
Ez a lekérdezési példa nem használ olyan rendezési módosítót, mint a
order by
. Ha többször futtatja a lekérdezést, az az egyes kérésekhez eltérő erőforráskészletet eredményezhet.Frissítse a lekérdezést a
name
tulajdonságraorder by
:Search-AzGraph -Query 'Resources | project name, type | limit 5 | order by name asc'
Az előző lekérdezéshez hasonlóan, ha ezt a lekérdezést többször is futtatja, az egyes kérésekhez eltérő erőforráskészletet eredményezhet. Fontos a lekérdezési parancsok sorrendje. Ebben a példában az
order by
alimit
után következik. A lekérdezés öt erőforrásra korlátozza az eredményeket, majd név szerint rendeli el az eredményeket.Frissítse a lekérdezést a
name
tulajdonságraorder by
, majdlimit
a kimenetet öt találatra:Search-AzGraph -Query 'Resources | project name, type | order by name asc | limit 5'
Ha ezt a lekérdezést többször futtatja a környezet módosítása nélkül, az eredmények konzisztensek és a tulajdonság szerint
name
vannak rendezve, de továbbra is öt találatra korlátozódnak. A lekérdezés név alapján rendeli meg az eredményeket, majd öt erőforrásra korlátozza a kimenetet.
Ha egy lekérdezés nem ad vissza eredményeket olyan előfizetésből, amelyhez már rendelkezik hozzáféréssel, vegye figyelembe, hogy Search-AzGraph
a parancsmag alapértelmezés szerint az alapértelmezett környezetben lévő előfizetésekhez tartozik. Az alapértelmezett környezet részét képező előfizetés-azonosítók listájának megtekintéséhez futtassa ezt (Get-AzContext).Account.ExtendedProperties.Subscriptions
a parancsmagot, ha az összes olyan előfizetésben szeretne keresni, amelyhez hozzáférése van, állítsa be a parancsmagot Search-AzGraph
a PSDefaultParameterValues
futtatással$PSDefaultParameterValues=@{"Search-AzGraph:Subscription"= $(Get-AzSubscription).ID}
Az erőforrások eltávolítása
Kijelentkezés az Azure PowerShell-munkamenetből:
Disconnect-AzAccount
Választható tisztítási lépések
Ha az Azure PowerShell legújabb verzióját telepítette, a Az.ResourceGraph
modult is tartalmazza, és nem szabad eltávolítani. Az alábbi lépések nem kötelezőek, ha manuálisan telepítette a Az.ResourceGraph
modult, és el szeretné távolítani a modult.
A modul PowerShell-munkamenetből való eltávolításához Az.ResourceGraph
futtassa a következő parancsot:
Remove-Module -Name Az.ResourceGraph
A modul számítógépről való eltávolításához Az.ResourceGraph
futtassa a következő parancsot:
Uninstall-Module -Name Az.ResourceGraph
Előfordulhat, hogy megjelenik egy üzenet, amely szerint az Az.ResourceGraph modul jelenleg használatban van. Ha igen, le kell állítania a PowerShell-munkamenetet, és el kell indítania egy új munkamenetet. Ezután futtassa a parancsot a modul számítógépről való eltávolításához.
Következő lépések
Ebben a rövid útmutatóban hozzáadta a Resource Graph modult az Azure PowerShell-környezethez, és lefuttatott egy lekérdezést. További információért lépjen a lekérdezési nyelv részleteinek lapjára.