Get-AzResource

Modulo:

Az.Resources Module

Ottiene le risorse.

Sintassi

ByTagNameValueParameterSet (Impostazione predefinita)

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

Descrizione

Il cmdlet Get-AzResource ottiene le risorse di Azure.

Esempio

Esempio 1: Ottenere tutte le risorse nella sottoscrizione corrente

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

Questo comando ottiene tutte le risorse nella sottoscrizione corrente.

Esempio 2: Ottenere tutte le risorse in un gruppo di risorse

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

Questo comando ottiene tutte le risorse nel gruppo di risorse "testRG".

Esempio 3: Ottenere tutte le risorse il cui gruppo di risorse corrisponde al carattere jolly fornito

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

Questo comando ottiene tutte le risorse il cui gruppo di risorse appartiene agli esseri con "altro".

Esempio 4: Ottenere tutte le risorse con un nome specificato

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

Questo comando ottiene tutte le risorse il cui nome della risorsa è "testVM".

Esempio 5: Ottenere tutte le risorse il cui nome corrisponde al carattere jolly specificato

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

Questo comando ottiene tutte le risorse il cui nome della risorsa inizia con "test".

Esempio 6: Ottenere tutte le risorse di un determinato tipo di risorsa

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

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

Questo comando ottiene tutte le risorse nelle sottoscrizioni correnti che sono macchine virtuali.

Esempio 7: Ottenere una risorsa in base all'ID risorsa

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

Questo comando ottiene la risorsa con l'ID risorsa specificato, ovvero una macchina virtuale denominata "testVM" nel gruppo di risorse "testRG".

Esempio 8: Ottenere una risorsa con proprietà espanse

Get-AzResource -Name testVM -ResourceGroupName testRG -ExpandProperties

Questo comando ottiene la risorsa denominata "testVM" nel gruppo di risorse "testRG" ed espande le proprietà per includere dettagli aggiuntivi, ad esempio CreatedTime, ChangedTime e altri metadati delle risorse.

Parametri

-ApiVersion

Il cmdlet Get-AzResource ottiene le risorse di Azure.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Proprietà dei parametri

Tipo:	IAzureContextContainer
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ExpandProperties

Se specificato, espande le proprietà della risorsa.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Name

Nome delle risorse da recuperare. Questo parametro supporta caratteri jolly all'inizio e/o alla fine della stringa.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	True
DontShow:	False
Alias:	ResourceName

Set di parametri

ByTagNameValueParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

ByTagObjectParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ODataQuery

Il cmdlet Get-AzResource ottiene le risorse di Azure.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Pre

Il cmdlet Get-AzResource ottiene le risorse di Azure.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ResourceGroupName

Il gruppo di risorse in cui appartiene le risorse recuperate. Questo parametro supporta caratteri jolly all'inizio e/o alla fine della stringa.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	True
DontShow:	False

Set di parametri

ByTagNameValueParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

ByTagObjectParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ResourceId

Specifica l'ID risorsa completo, come nell'esempio seguente /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Compute/virtualMachines

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	id

Set di parametri

ByResourceId

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-ResourceType

Tipo di risorsa delle risorse da recuperare. Ad esempio, Microsoft.Compute/virtualMachines

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

ByTagNameValueParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

ByTagObjectParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Tag

Ottiene le risorse con il tag di Azure specificato. Immettere una tabella hash con una chiave Nome o Chiavi Nome e Valore. I caratteri jolly non sono supportati. Un "tag" è una coppia nome-valore che è possibile applicare alle risorse e ai gruppi di risorse. Usare i tag per classificare le risorse, ad esempio per reparto o centro di costo, o per tenere traccia di note o commenti sulle risorse. Per aggiungere un tag a una risorsa, usare il parametro Tag dei cmdlet New-AzResource o Set-AzResource. Per creare un tag predefinito, usare il cmdlet New-AzTag. Per informazioni sulle tabelle hash in Windows PowerShell, eseguire 'Get-Help about_Hashtables'.

Proprietà dei parametri

Tipo:	Hashtable
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

ByTagObjectParameterSet

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-TagName

Chiave nel tag delle risorse da recuperare.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

ByTagNameValueParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-TagValue

Valore nel tag delle risorse da recuperare.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

ByTagNameValueParameterSet

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

Output

PSResource

Collegamenti correlati

• Move-AzResource
• New-AzResource
• Remove-AzResource
• Set-AzResource