Get-AzResource

Módulo:: Az.Resources Module

Obtém recursos.

Sintaxe

ByTagNameValueParameterSet (Default)

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

Description

O cmdlet Get-AzResource obtém recursos Azure.

Exemplos

Exemplo 1: Obter todos os recursos na assinatura atual

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

Esse comando obtém todos os recursos na assinatura atual.

Exemplo 2: Obter todos os recursos em um 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

Esse comando obtém todos os recursos no grupo de recursos "testRG".

Exemplo 3: Obter todos os recursos cujo grupo de recursos corresponde ao curinga fornecido

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

Esse comando obtém todos os recursos cujo grupo de recursos pertencem a seres com "outros".

Exemplo 4: Obter todos os recursos com um determinado nome

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

Esse comando obtém todos os recursos cujo nome de recurso é "testVM".

Exemplo 5: Obter todos os recursos cujo nome corresponde ao curinga fornecido

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

Esse comando obtém todos os recursos cujo nome de recurso começa com "test".

Exemplo 6: Obter todos os recursos de um determinado tipo de recurso

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

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

Esse comando obtém todos os recursos nas assinaturas atuais que são máquinas virtuais.

Exemplo 7: Obter um recurso por id 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

Esse comando obtém o recurso com a ID de recurso fornecida, que é uma máquina virtual chamada "testVM" no grupo de recursos "testRG".

Exemplo 8: Obter um recurso com propriedades expandidas

Get-AzResource -Name testVM -ResourceGroupName testRG -ExpandProperties

Esse comando obtém o recurso chamado "testVM" no grupo de recursos "testRG" e expande as propriedades para incluir detalhes adicionais, como CreatedTime, ChangedTime e outros metadados de recurso.

Parâmetros

-ApiVersion

O cmdlet Get-AzResource obtém recursos Azure.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usadas para comunicação com o Azure

Propriedades do parâmetro

Tipo:	IAzureContextContainer
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ExpandProperties

Quando especificado, expande as propriedades do recurso.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Name

O nome dos recursos a serem recuperados. Esse parâmetro dá suporte a curingas no início e/ou no final da cadeia de caracteres.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	True
DontShow:	False
Aliases:	NomeDoRecurso

Conjuntos de parâmetros

ByTagNameValueParameterSet

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

ByTagObjectParameterSet

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ODataQuery

O cmdlet Get-AzResource obtém recursos Azure.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Pre

O cmdlet Get-AzResource obtém recursos Azure.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ResourceGroupName

O grupo de recursos no qual os recursos são recuperados pertence. Esse parâmetro dá suporte a curingas no início e/ou no final da cadeia de caracteres.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	True
DontShow:	False

Conjuntos de parâmetros

ByTagNameValueParameterSet

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

ByTagObjectParameterSet

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-ResourceId

Especifica a ID de recurso totalmente qualificada, como no exemplo a seguir /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Compute/virtualMachines

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	ID

Conjuntos de parâmetros

ByResourceId

Cargo:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-ResourceType

O tipo de recurso dos recursos a serem recuperados. Por exemplo, Microsoft. Computação/virtualMachines

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ByTagNameValueParameterSet

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

ByTagObjectParameterSet

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Tag

Obtém recursos que têm a marca de Azure especificada. Insira uma tabela de hash com uma chave name ou chaves Nome e Valor. Não há suporte para caracteres curinga. Uma "marca" é um par nome-valor que você pode aplicar a recursos e grupos de recursos. Use marcas para categorizar seus recursos, como por departamento ou centro de custos, ou para acompanhar anotações ou comentários sobre os recursos. Para adicionar uma marca a um recurso, use o parâmetro Tag dos cmdlets New-AzResource ou Set-AzResource. Para criar uma marca predefinida, use o cmdlet New-AzTag. Para obter ajuda com tabelas de hash no Windows PowerShell, execute 'Get-Help about_Hashtables'.

Propriedades do parâmetro

Tipo:	Hashtable
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ByTagObjectParameterSet

Cargo:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-TagName

A chave na marca dos recursos a serem recuperados.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ByTagNameValueParameterSet

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-TagValue

O valor na marca dos recursos a serem recuperados.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ByTagNameValueParameterSet

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Get-AzResource

Sintaxe

ByTagNameValueParameterSet (Default)

ByResourceId

ByTagObjectParameterSet

Description

Exemplos

Exemplo 1: Obter todos os recursos na assinatura atual

Exemplo 2: Obter todos os recursos em um grupo de recursos

Exemplo 3: Obter todos os recursos cujo grupo de recursos corresponde ao curinga fornecido

Exemplo 4: Obter todos os recursos com um determinado nome

Exemplo 5: Obter todos os recursos cujo nome corresponde ao curinga fornecido

Exemplo 6: Obter todos os recursos de um determinado tipo de recurso

Exemplo 7: Obter um recurso por id de recurso

Exemplo 8: Obter um recurso com propriedades expandidas

Parâmetros

-ApiVersion

Propriedades do parâmetro

Conjuntos de parâmetros

-DefaultProfile

Propriedades do parâmetro

Conjuntos de parâmetros

-ExpandProperties

Propriedades do parâmetro

Conjuntos de parâmetros

-Name

Propriedades do parâmetro

Conjuntos de parâmetros

-ODataQuery

Propriedades do parâmetro

Conjuntos de parâmetros

-Pre

Propriedades do parâmetro

Conjuntos de parâmetros

-ResourceGroupName

Propriedades do parâmetro

Conjuntos de parâmetros

-ResourceId

Propriedades do parâmetro

Conjuntos de parâmetros

-ResourceType

Propriedades do parâmetro

Conjuntos de parâmetros

-Tag

Propriedades do parâmetro

Conjuntos de parâmetros

-TagName

Propriedades do parâmetro

Conjuntos de parâmetros

-TagValue

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters

Entradas

String

Saídas

PSResource

Links Relacionados