Get-AzResource
Obtiene recursos.
Syntax
Get-AzResource
[-Name <String>]
[-ResourceType <String>]
[-ODataQuery <String>]
[-ResourceGroupName <String>]
[-TagName <String>]
[-TagValue <String>]
[-ExpandProperties]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzResource
-ResourceId <String>
[-ODataQuery <String>]
[-ExpandProperties]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzResource
[-Name <String>]
[-ResourceType <String>]
[-ODataQuery <String>]
[-ResourceGroupName <String>]
-Tag <Hashtable>
[-ExpandProperties]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
El cmdlet Get-AzResource obtiene recursos de Azure.
Ejemplos
Ejemplo 1: Obtener todos los recursos de la suscripción actual
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
Este comando obtiene todos los recursos de la suscripción actual.
Ejemplo 2: Obtención de todos los recursos de un grupo de recursos
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
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
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
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
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
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
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
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
Get-AzResource -ResourceType Microsoft.Compute/virtualMachines | Format-Table
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
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
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 |
Required: | False |
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: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExpandProperties
Cuando se especifica, expande las propiedades del recurso.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
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: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-ODataQuery
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Pre
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
El grupo de recursos en el que pertenecen los recursos que se recuperan. Este parámetro admite caracteres comodín al principio o al final de la cadena.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-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 |
Required: | True |
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 |
Required: | False |
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 de 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-AzResource o Set-AzResource. Para crear una etiqueta predefinida, use el cmdlet New-AzTag. Para obtener ayuda con tablas hash en Windows PowerShell, ejecute "Get-Help about_Hashtables".
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | True |
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 |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Salidas
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de