Partilhar via

Get-AzureRmResourceGroupDeployment

  • Referência
Módulo:
AzureRM.Resources

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

Aviso

O módulo AzureRM do PowerShell 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 Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação 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 para 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 que são implantados como uma unidade. Uma implantação é a operação que torna os recursos no grupo de recursos disponíveis 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 este cmdlet com o cmdlet Get-AzureRmLog.

Exemplos

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

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

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

Exemplo 2: Obter uma implantação por nome

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

Este 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

Este 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 suportada pelo provedor de recursos. Você pode especificar uma versão diferente da versão padrão.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Id

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

Tipo:String
Aliases:DeploymentId, ResourceId
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

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

Tipo:String
Aliases:DeploymentName
Position:1
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Pre

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

None

Saídas

Microsoft.Azure.Commands.ResourceManagement.Models. PSResourceGroupDeployment