Get-AzResourceGroupDeployment

  • Referência
Módulo:
Az.Resources

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

Syntax

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 Name ou Id para filtrar os resultados. Por padrão, Get-AzResourceGroupDeployment 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 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 rastreamento. Para depuração, use esse cmdlet com o cmdlet Get-AzLog.

Exemplos

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

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

Get-AzResourceGroupDeployment -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-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, DeploymentName e ProvisioningState .

Parâmetros

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

Type:String
Aliases:DeploymentId, ResourceId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Aliases:DeploymentName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Pre

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String

Saídas

PSResourceGroupDeployment