Get-AzureRmResource

Referencia

Módulo:: AzureRM.Resources

Obtiene recursos.

Importante

Como los módulos de Az PowerShell ya tienen todas las funcionalidades de los de AzureRM PowerShell, incluso más, el 29 de febrero de 2024 se van a retirar estos últimos.

Para evitar interrupciones del servicio, actualice los scripts que usan los módulos de AzureRM PowerShell para que utilicen los de Az PowerShell antes del 29 de febrero de 2024. Para actualizar automáticamente los scripts, siga la guía de inicio rápido.

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

El cmdlet Get-AzureRmResource obtiene recursos de Azure.

Ejemplos

Ejemplo 1: Obtener todos los recursos de la suscripción actual

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

Este comando obtiene todos los recursos de la suscripción actual.

Ejemplo 2: Obtener todos los recursos de un grupo de recursos

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

Este comando obtiene todos los recursos del grupo de recursos "testRG".

Ejemplo 3: Obtención de todos los recursos cuyo grupo de recursos coincide con el carácter comodín proporcionado

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

Este comando obtiene todos los recursos cuyo grupo de recursos pertenecen a seres con "otros".

Ejemplo 4: Obtener todos los recursos con un nombre determinado

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

Este comando obtiene todos los recursos cuyo nombre de recurso es "testVM".

Ejemplo 5: Obtener todos los recursos cuyo nombre coincide con el carácter comodín proporcionado

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

Este comando obtiene todos los recursos cuyo nombre de recurso comienza por "test".

Ejemplo 6: Obtención de todos los recursos de un tipo de recurso determinado

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

Este comando obtiene todos los recursos de las suscripciones actuales que son máquinas virtuales.

Ejemplo 7: Obtención de un recurso por identificador de recurso

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

Este comando obtiene el recurso con el identificador de recurso proporcionado, que es una máquina virtual denominada "testVM" en el grupo de recursos "testRG".

Parámetros

-ApiVersion

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ExpandProperties

Cuando se especifica, expande las propiedades del recurso.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Nombre de los recursos que se van a recuperar. Este parámetro admite caracteres comodín al principio o al final de la cadena.

Type:	String
Aliases:	ResourceName
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ODataQuery

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Pre

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

El grupo de recursos en el que pertenecen los recursos que se retiran. Este parámetro admite caracteres comodín al principio o al final de la cadena.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceId

Especifica el identificador de recurso completo, como en el ejemplo siguiente. /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Compute/virtualMachines

Type:	String
Aliases:	Id
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceType

Tipo de recurso de los recursos que se van a recuperar. Por ejemplo, Microsoft.Compute/virtualMachines

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Obtiene los recursos que tienen la etiqueta de Azure especificada. Escriba una tabla hash con una clave de nombre o claves nombre y valor. No se admiten caracteres comodín. Una "etiqueta" es un par nombre-valor que se puede aplicar a recursos y grupos de recursos. Use etiquetas para clasificar los recursos, como por departamento o centro de costos, o para realizar un seguimiento de notas o comentarios sobre los recursos. Para agregar una etiqueta a un recurso, use el parámetro Tag de los cmdlets New-AzureRmResource o Set-AzureRmResource. Para crear una etiqueta predefinida, use el cmdlet New-AzureRmTag. Para obtener ayuda con las tablas hash de Windows PowerShell, ejecute "Get-Help about_Hashtables".

Type:	Hashtable
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-TagName

Clave de la etiqueta de los recursos que se van a recuperar.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-TagValue

Valor de la etiqueta de los recursos que se van a recuperar.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

None

Salidas

Microsoft.Azure.Commands.ResourceManagement.Models.PSResource