Compartilhar via

Get-AzResourceGroupDeployment

  • Referência
Módulo:
Az.Resources

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

Sintaxe

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

Description

O cmdlet Get-AzResourceGroupDeployment obtém as implantações em um grupo de recursos do Azure. Especifique o parâmetro de Nome do ou para filtrar os resultados. Por padrão, Get-AzResourceGroupDeployment 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, um banco de dados ou um site da Web. 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 no grupo de recursos para uso. Para obter mais informações sobre recursos do Azure e grupos de recursos do Azure, consulte o cmdlet New-AzResourceGroup. Você pode usar esse cmdlet para acompanhamento. Para depuração, use este cmdlet com o cmdlet Get-AzLog.

Exemplos

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

Get-AzResourceGroupDeployment -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

Get-AzResourceGroupDeployment -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-AzResourceGroup ou New-AzResourceGroupDeployment. 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

Get-AzResourceGroup | Get-AzResourceGroupDeployment | Format-Table ResourceGroupName, DeploymentName, ProvisioningState

Esse comando obtém todos os grupos de recursos em sua assinatura usando o cmdlet Get-AzResourceGroup. 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, DeploymentNamee ProvisioningState.

Parâmetros

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, 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 obtido.

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 obtido. 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 do 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

String

Saídas

PSResourceGroupDeployment