Compartilhar via

Get-AzureRmResourceGroupDeployment

  • Referência
Módulo:
AzureRM.Resources

Obtém as implantações em um grupo de recursos.

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

Get-AzureRmResourceGroupDeployment
   [-ResourceGroupName] <String>
   [[-Name] <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmResourceGroupDeployment
   -Id <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Get-AzureRmResourceGroupDeployment obtém as implantações em um grupo de recursos do Azure. Especifique o parâmetro Name ou Id para filtrar os resultados. Por padrão, Get-AzureRmResourceGroupDeployment obtém todas as implantações de um grupo de recursos especificado. Um recurso do Azure é uma entidade do Azure gerenciada pelo usuário, como um servidor de banco de dados, banco de dados ou site. Um grupo de recursos do Azure é uma coleção de recursos do Azure implantados como uma unidade. Uma implantação é a operação que disponibiliza os recursos do grupo de recursos para uso. Para obter mais informações sobre recursos do Azure e grupos de recursos do Azure, consulte o cmdlet New-AzureRmResourceGroup. Você pode usar esse cmdlet para rastreamento. Para depuração, use esse cmdlet com o cmdlet Get-AzureRmLog.

Exemplos

Exemplo 1: Obter todas as implantações de um grupo de recursos

PS C:\>Get-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoLabsRG"

Esse comando obtém todas as implantações para o grupo de recursos ContosoLabsRG. A saída mostra uma implantação para um blog do WordPress que usou um modelo de galeria.

Exemplo 2: Obter uma implantação por nome

PS C:\>Get-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoLabsRG" -Name "DeployWebsite01"

Esse comando obtém a implantação DeployWebsite01 do grupo de recursos ContosoLabsRG. Você pode atribuir um nome a uma implantação ao criá-la usando os cmdlets New-AzureRmResourceGroup ou New-AzureRmResourceGroupDeployment . Se você não atribuir um nome, os cmdlets fornecerão um nome padrão com base no modelo usado para criar a implantação.

Exemplo 3: Obter as implantações de todos os grupos de recursos

PS C:\>Get-AzureRmResourceGroup | Get-AzureRmResourceGroupDeployment | Format-Table ResourceGroupName, DeploymentName, ProvisioningState

Esse comando obtém todos os grupos de recursos em sua assinatura usando o cmdlet Get-AzureRmResourceGroup. O comando passa os grupos de recursos para o cmdlet atual usando o operador de pipeline. O cmdlet atual obtém todas as implantações de todos os grupos de recursos na assinatura e passa os resultados para o cmdlet Format-Table para exibir seus valores de propriedade ResourceGroupName, DeploymentName e ProvisioningState .

Parâmetros

-ApiVersion

Especifica a versão da API compatível com o provedor de recursos. Você pode especificar uma versão diferente da versão padrão.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifica a ID da implantação do grupo de recursos a ser obtida.

Tipo:String
Aliases:DeploymentId, ResourceId
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome da implantação a ser obtida. Caracteres curinga não são permitidos.

Tipo:String
Aliases:DeploymentName
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Pre

Indica que esse cmdlet considera versões de API de pré-lançamento quando determina automaticamente qual versão usar.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceGroupName

Especifica o nome de um grupo de recursos. O cmdlet obtém as implantações para o grupo de recursos especificado por esse parâmetro. Caracteres curinga não são permitidos. Esse parâmetro é necessário e você pode especificar apenas um grupo de recursos em cada comando.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

None

Saídas

Microsoft.Azure.Commands.ResourceManagement.Models. PSResourceGroupDeployment